Honeycomb

Documentation Index

Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt

Use this file to discover all available pages before exploring further.

​

What is Honeycomb?

​

Key Features of Honeycomb

• Trace Query Builder: Slice and filter spans by any attribute, including TrueFoundry-emitted fields like tfy.span_type and gen_ai.request.model.
• Metrics Explorer: Visualise OTLP metrics over time with aggregations and groupings across models, users, and environments.
• Environments and Datasets: Organise telemetry into named datasets per service or team, with the x-honeycomb-dataset header controlling routing.

​

Prerequisites

1. TrueFoundry Account: Create a TrueFoundry account and follow the instructions in our Gateway Quick Start Guide.
2. Honeycomb Account: Sign up at honeycomb.io and create an ingest API key with Send Events permission.

​

Understanding the Honeycomb Endpoint

​

Integration Steps

1

Create a Honeycomb Ingest API Key

1. Log into your Honeycomb account and navigate to Team Settings → API Keys.
2. Click Create API Key and select the Send Events permission scope.
3. Copy the generated API key — you will need it in the next step.

Honeycomb routes traces into a dataset matching your service.name attribute. TrueFoundry sets this to tfy-llm-gateway automatically, so your traces will appear under a dataset of that name unless you override it via the x-honeycomb-dataset header.

2

Configure OTEL Export in TrueFoundry

1. Go to AI Gateway → Controls → Settings in the TrueFoundry dashboard.
2. Scroll down to the OTEL Config section and click the edit (✏️) button.

3. Enable the Otel Traces Exporter Configuration toggle and fill in:

Field	Value
Toggle	Enabled
Protocol	HTTP Configuration
Endpoint	https://api.honeycomb.io/v1/traces (US) or https://api.eu1.honeycomb.io/v1/traces (EU)
Encoding	Proto
Header Key	x-honeycomb-team
Header Value	<your-honeycomb-api-key>

4. Enable the Otel Metrics Exporter Configuration toggle and fill in:

Field	Value
Toggle	Enabled
Protocol	HTTP Configuration
Endpoint	https://api.honeycomb.io/v1/metrics (US) or https://api.eu1.honeycomb.io/v1/metrics (EU)
Encoding	Proto
Header Key	x-honeycomb-team
Header Value	<your-honeycomb-api-key>

5. Click Save to apply the configuration.

To route metrics into a specific Honeycomb dataset rather than the default unknown_metrics, add a second header: key x-honeycomb-dataset, value set to your chosen dataset name. Click + Add Headers in TrueFoundry to add multiple header pairs.

3

Verify the Integration

1. Make a request through the TrueFoundry AI Gateway.
2. Log into your Honeycomb account and open the Traces tab on the tfy-llm-gateway dataset.
3. You will see a list of traces with Root Service set to tfy-llm-gateway. Span names follow the pattern MCPGateway: resources/list, ChatCompletion, and so on depending on the operation type.

4. Click any Trace ID to expand it and inspect individual spans. You will see the full span waterfall including nested child spans with latency breakdowns.

5. From the dataset Overview tab you can also monitor aggregate Trace Volume, Span Volume, and Error Volume over time to confirm data is flowing continuously.

​

Configuration Reference