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 Honeycomb.

Honeycomb is an observability platform. You can send traces to the Honeycomb OTLP API 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 Honeycomb with your API key.

2. In Honeycomb, go to Account → Team Settings to find or create an API key. Add the following exporter to your collector config.

   exporters:
     otlp/honeycomb:
       endpoint: https://api.honeycomb.io:443
       headers:
         x-honeycomb-team: "<your-honeycomb-api-key>"

Step 2: Point the tracing policy at the collector

Create an AgentgatewayPolicy that points the agentgateway proxy at the OTel Collector.

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

kubectl delete AgentgatewayPolicy tracing -n agentgateway-system