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

# HoneyHive

> Learn how to export LLM Gateway traces to HoneyHive using OpenTelemetry integration.

This guide provides instructions for integrating [HoneyHive](https://www.honeyhive.ai/) 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

* **[AI observability & agent tracing](https://www.honeyhive.ai/observability)**: End-to-end traces for LLM calls, tools, and agent steps with inputs, outputs, and latency
* **[OpenTelemetry ingestion](https://docs.honeyhive.ai/)**: Accepts OTLP/HTTP traces with Bearer token authentication
* **[Evaluation & datasets](https://www.honeyhive.ai/)**: Run experiments and evaluations on logged sessions alongside live traces

## Prerequisites

Before integrating HoneyHive with TrueFoundry, ensure you have:

1. **TrueFoundry account**: Create a [TrueFoundry account](https://www.truefoundry.com/register) and follow our [Gateway Quick Start Guide](https://docs.truefoundry.com/gateway/quick-start)
2. **HoneyHive account**: Sign up at [HoneyHive](https://www.honeyhive.ai/) 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.

<Steps>
  <Step title="Create a HoneyHive API key">
    1. Log in to your [HoneyHive dashboard](https://app.honeyhive.ai/).
    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.

    <Tip>
      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.
    </Tip>
  </Step>

  <Step title="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](#provider-host-and-otlp-traces-url)).
    6. Set **Encoding** to **Json**.

    <Frame>
      <img src="https://mintcdn.com/truefoundry/Mvt9Ivot6GPiEBtY/images/HoneyHiveOtelConfig.png?fit=max&auto=format&n=Mvt9Ivot6GPiEBtY&q=85&s=5050cae1f3386d4d95ed950ade8e3524" alt="TrueFoundry OTEL Traces Exporter Configuration for HoneyHive with HTTP endpoint, Json encoding, and Authorization header" width="963" height="831" data-path="images/HoneyHiveOtelConfig.png" />
    </Frame>
  </Step>

  <Step title="Configure headers and save">
    Enable **Headers** and add:

    | Header          | Value                        |
    | --------------- | ---------------------------- |
    | `Authorization` | `Bearer <HoneyHive_API_Key>` |

    Replace `<HoneyHive_API_Key>` with the key from Step 1. Click **Save** to apply the configuration.
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/truefoundry/Mvt9Ivot6GPiEBtY/images/HoneyHiveTesting.png?fit=max&auto=format&n=Mvt9Ivot6GPiEBtY&q=85&s=dfe7c7044b0f0295cfe2007771ec16f3" alt="HoneyHive Traces Events table showing otlp-sourced events from TrueFoundry AI Gateway" width="1918" height="1040" data-path="images/HoneyHiveTesting.png" />
    </Frame>
  </Step>
</Steps>

## Configuration reference

| Configuration       | Value                                             |
| ------------------- | ------------------------------------------------- |
| **Traces endpoint** | `https://<provider-host>/opentelemetry/v1/traces` |
| **Protocol**        | HTTP (OTLP)                                       |
| **Encoding**        | Json                                              |
| **Auth header**     | `Authorization: Bearer <HoneyHive_API_Key>`       |