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

Configure agentgateway to send traces to Grafana Cloud.

Grafana Cloud is a managed observability platform. You can send traces to your Grafana Cloud OTLP endpoint from the agentgateway proxy via an OpenTelemetry Collector.

Before you begin

1. Set up an agentgateway proxy.
2. Install the httpbin sample app.

Configure tracing

Step 1: Set up the OTel Collector

1. Follow the OTel Collector setup guide to install a collector in your cluster. Then update the collector’s exporter config to forward traces to Grafana Cloud.

2. In Grafana Cloud, go to My Account → Stack → OpenTelemetry to find your OTLP endpoint, instance ID, and API token. Then, base64-encode your credentials.

   echo -n "<instanceID>:<apiToken>" | base64

3. Add the following exporter to your collector config:

   exporters:
     otlp/grafana:
       endpoint: https://<your-grafana-otlp-endpoint>:443
       headers:
         Authorization: "Basic <base64-encoded-instanceID:apiToken>"

Step 2: Point the tracing policy at the collector

Create an AgentgatewayPolicy that points the agentgateway proxy at the OTel Collector — not at Grafana Cloud directly.

kubectl apply -f- <<EOF
apiVersion: agentgateway.dev/v1alpha1
kind: AgentgatewayPolicy
metadata:
  name: tracing
  namespace: agentgateway-system
spec:
  targetRefs:
    - kind: Gateway
      name: agentgateway-proxy
      group: gateway.networking.k8s.io
  frontend:
    tracing:
      backendRef:
        name: opentelemetry-collector
        namespace: tracing
        port: 4317
      protocol: GRPC
      randomSampling: "true"
EOF

Cleanup

Delete the AgentgatewayPolicy resource.

kubectl delete AgentgatewayPolicy tracing -n agentgateway-system