Distributed Trace IngestionCopy Anchor Link

Send OpenTelemetry spans to POST /v1/traces using any Owlpane SDK or standard OpenTelemetry instrumentation.

EndpointCopy Anchor Link

Authenticate with Authorization: Bearer owl_ing_…. See the OTLP ingest reference.

Recommended AttributesCopy Anchor Link

• service.name — Logical service identifier (e.g. checkout-api).
• deployment.environment — Environment tag (production, staging, dev).
• span.kind — server, client, producer, or consumer so Owlpane can derive RED metrics and dependency edges.
• error / exception — Marks failed spans for error-rate breakdowns.

curl example (OTLP/HTTP JSON)Copy Anchor Link

curl -sS -X POST "https://ingest.owlpane.com/v1/traces" \
  -H "Authorization: Bearer $OWLPANE_INGEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resourceSpans":[{"resource":{"attributes":[{"key":"service.name","value":{"stringValue":"checkout-api"}}]},"scopeSpans":[{"scope":{"name":"manual"},"spans":[{"traceId":"5B8EFFF798038103D269B633813FC60C","spanId":"EEE19B7EC3C1B174","name":"GET /checkout","kind":2,"startTimeUnixNano":"1544712660000000000","endTimeUnixNano":"1544712661000000000"}]}]}]}'

OpenTelemetry Collector exporterCopy Anchor Link

exporters:
  otlphttp/owlpane:
    endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT}
    headers:
      Authorization: "Bearer ${env:OWLPANE_INGEST_KEY}"

Service Map & RED MetricsCopy Anchor Link

Owlpane automatically derives request rate, error rate, and duration (RED) metrics and service dependency edges from incoming spans. Install the Traces starter pack from Dashboards → Library (/observability/dashboards/library) for pre-built latency and error breakdown views.

Verify it arrivedCopy Anchor Link

Open Observability → Traces (/observability/traces) and search by service.name or trace id. Recent spans appear within a few seconds.

TroubleshootingCopy Anchor Link