For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Sample tracing configs
Sample configurations for exporting agentgateway traces to common OTLP-compatible backends, including OpenTelemetry Collector, Jaeger, and SaaS platforms.
Agentgateway exports traces to any OTLP-compatible backend. The host value in frontendPolicies.tracing depends on how you installed agentgateway and where your OTLP receiver is running.
| Install method | host value | Notes |
|---|---|---|
| Binary | localhost:4317 | Run the OTLP receiver as a separate process or Docker container on the same host. |
| Docker | host.docker.internal:4317 | If you run agentgateway in a Docker container, localhost is the agentgateway container, not your host. Set the collector host to host.docker.internal:4317 instead. Docker Desktop resolves this name for you. On Linux, also add --add-host=host.docker.internal:host-gateway to the docker run command that starts agentgateway. Another option is to run both containers on the same Docker network and use the collector’s container name as the host. |
| Docker Compose | <service-name>:4317 | Add the receiver as a service that runs alongside agentgateway. Use the Docker service name as the host. |
| Kubernetes (Helm) | <service>.<namespace>.svc.cluster.local:4317 | Deploy the OTLP receiver as a separate Helm release. For example, you can install the Jaeger Helm chart that includes an OTLP receiver and the Jaeger UI to view your traces. Use the Kubernetes service DNS name as your host. |
Choose one of the following guides to configure your tracing backend.
OpenTelemetry Collector (OTel)
Route agentgateway traces through an OpenTelemetry Collector to fan out to multiple backends or …
Jaeger
Export agentgateway traces to Jaeger for local collection and visualization by using its built-in …
Honeycomb
Export agentgateway traces to Honeycomb by using its OTLP ingestion endpoint.
Grafana Cloud
Export agentgateway traces to Grafana Cloud by using its OTLP ingestion endpoint.