For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Export agentgateway traces to Jaeger for local collection and visualization by using its built-in OTLP receiver and web UI.

Jaeger is an open-source distributed tracing platform that collects, stores, and visualizes traces. It is a quick way to get started with tracing for agentgateway because it ships with a built-in OTLP receiver, so you do not need a separate collector, and a web UI to browse and query spans.

Jaeger works best for local development and testing. For production deployments, consider routing traces through an OpenTelemetry Collector so that you can fan out to multiple backends or apply processing pipelines to your traces before exporting them.

The way you set up Jaeger depends on how you installed agentgateway.

Other configurations

Review other common configuration examples.

Docker Compose

Run agentgateway and Jaeger together as a single Docker Compose stack. Jaeger is available to agentgateway at jaeger:4317, the Docker service name.

1. Create a docker-compose.yaml file with the following content.

   services:
     agentgateway:
       image: cr.agentgateway.dev/agentgateway:latest
       ports:
         - "3000:3000"
       volumes:
         - ./config.yaml:/config.yaml:ro
       command: ["-f", "/config.yaml"]
       depends_on:
         - jaeger
   
     jaeger:
       image: jaegertracing/all-in-one:latest
       ports:
         - "16686:16686"
         - "4317:4317"
       environment:
         - COLLECTOR_OTLP_ENABLED=true

2. In your agentgateway config file, set the Jaeger service name as the tracing host.

   # yaml-language-server: $schema=https://agentgateway.dev/schema/config
   frontendPolicies:
     tracing:
       host: jaeger:4317
       randomSampling: true

3. Start the stack.

   docker compose up -d

4. Open the Jaeger UI at http://localhost:16686 to view traces.

5. When you are done, stop and remove the stack.

   docker compose down