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

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