<!-- 0Gkit docs — OBSERVABILITY_EXPORTER_FAILED
     Source: https://docs.0gkit.com/errors/OBSERVABILITY_EXPORTER_FAILED
     LLM-friendly Markdown twin of the page. -->

# OBSERVABILITY_EXPORTER_FAILED

**OTel exporter rejected the export**

## What happened

The configured OpenTelemetry exporter (OTLP, Honeycomb, Jaeger) rejected a span/metric batch — usually network or auth misconfiguration.

## How to fix

Confirm the exporter endpoint + headers (e.g. `OTEL_EXPORTER_OTLP_HEADERS`) are correct. Drop logs to inspect the raw export attempt.

## Example

```ts
import { instrument0g } from "@foundryprotocol/0gkit-observability";

await instrument0g({
  serviceName: "my-app",
  exporter: { kind: "otlp", endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT! },
});
// If the OTLP endpoint is unreachable on first flush, the SDK throws OBSERVABILITY_EXPORTER_FAILED.
```

## Reference

- Namespace: `OBSERVABILITY`
- Help URL: `https://0gkit.com/errors/OBSERVABILITY_EXPORTER_FAILED`
- See also: [all error codes](/errors)