Skip to main content

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.

This guide provides instructions for integrating HoneyHive with the TrueFoundry AI Gateway to export OpenTelemetry traces.

​
What is HoneyHive?

HoneyHive is an AI observability and evaluation platform for LLM applications and agents. It is OpenTelemetry-native and ingests OTLP traces so you can monitor completions, debug agent workflows, and run experiments on production traffic.

​
Key capabilities

​
Prerequisites

Before integrating HoneyHive with TrueFoundry, ensure you have:
  1. TrueFoundry account: Create a TrueFoundry account and follow our Gateway Quick Start Guide
  2. HoneyHive account: Sign up at HoneyHive and access your project dashboard
  3. HoneyHive API key: Create a project API key (covered below) — it is scoped to your HoneyHive project and region

​
Provider host and OTLP traces URL

HoneyHive routes OTLP ingestion through your deployment’s API host. Replace <provider-host> with the hostname shown in your HoneyHive dashboard or API settings (for example a US production host): 
https://<provider-host>/opentelemetry/v1/traces
Example for a US production deployment: 
https://api.dp1.us.prod.honeyhive.ai/opentelemetry/v1/traces
Use the exact host for your org and environment. If ingest fails, confirm the hostname matches the region where your project lives.

​
Integration steps

TrueFoundry AI Gateway supports exporting OpenTelemetry traces to HoneyHive over OTLP/HTTP so you can monitor LLM gateway traffic in HoneyHive.
1

Create a HoneyHive API key

  1. Log in to your HoneyHive dashboard.
  2. Open Settings → Project → API Keys.
  3. Click Create API Key, copy the key from the modal, and store it securely — it is only shown once.
The API key is tied to your HoneyHive project. Traces exported from TrueFoundry land in that project when you use this key in the Authorization header.
2

Configure OTEL export in TrueFoundry

  1. Go to AI Gateway → Controls → Settings in the TrueFoundry dashboard.
  2. Scroll to OTEL Config and click the edit (pencil) control.
  3. Enable Otel Traces Exporter Configuration.
  4. Select HTTP Configuration.
  5. Set Endpoint to your HoneyHive OTLP URL (see Provider host and OTLP traces URL).
  6. Set Encoding to Json.
TrueFoundry OTEL Traces Exporter Configuration for HoneyHive with HTTP endpoint, Json encoding, and Authorization header
3

Configure headers and save

Enable Headers and add:
HeaderValue
AuthorizationBearer <HoneyHive_API_Key>
Replace <HoneyHive_API_Key> with the key from Step 1. Click Save to apply the configuration.
4

Verify the integration

  1. Send a few requests through the TrueFoundry AI Gateway.
  2. In TrueFoundry, open Monitor to confirm gateway traffic is flowing.
  3. In HoneyHive, go to Observe → Traces and open your project’s Events view.
  4. Confirm new events appear with SOURCE set to otlp, including LLM completions and gateway-related spans.
HoneyHive Traces Events table showing otlp-sourced events from TrueFoundry AI Gateway

​
Configuration reference

ConfigurationValue
Traces endpointhttps://<provider-host>/opentelemetry/v1/traces
ProtocolHTTP (OTLP)
EncodingJson
Auth headerAuthorization: Bearer <HoneyHive_API_Key>