OwlpaneDOCS
Ingestion

OTLP Ingest Reference

Owlpane natively accepts OpenTelemetry Protocol (OTLP) over HTTP and gRPC.

OTLP/HTTP endpoints

Base URL: https://ingest.owlpane.com.

SignalPathContent-Type
TracesPOST /v1/tracesapplication/x-protobuf or application/json
MetricsPOST /v1/metricsapplication/x-protobuf or application/json
LogsPOST /v1/logsapplication/x-protobuf or application/json

OTLP/gRPC services

Point a gRPC exporter at ingest.owlpane.com:443 and call the standard collector services:

SignalService
Tracesopentelemetry.proto.collector.trace.v1.TraceService/Export
Metricsopentelemetry.proto.collector.metrics.v1.MetricsService/Export
Logsopentelemetry.proto.collector.logs.v1.LogsService/Export

Authentication

Every request carries a project ingest key (owl_ing_ followed by 48 hex characters):

Authorization: Bearer owl_ing_your_key_here

Keys are write-only for a single project, shown once at creation, and stored only as a hash. Query strings, cookies, and the authorization header are stripped at the gateway.

curl example (OTLP/HTTP JSON)

export OTEL_EXPORTER_OTLP_ENDPOINT="https://ingest.owlpane.com"
export OWLPANE_INGEST_KEY="owl_ing_your_key_here"
curl -sS -X POST "$OTEL_EXPORTER_OTLP_ENDPOINT/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 exporter

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

Other ingest endpoints

SourceEndpoint
Prometheus remote writePOST /api/v1/write
AWS Firehose metricsPOST /aws/firehose/metrics
AWS Firehose logsPOST /aws/firehose/logs

Verify it arrived

  • Traces: Observability → Traces (/observability/traces).
  • Metrics: Observability → Explorer (/observability/explorer).
  • Logs: Observability → Logs (/observability/logs).

Filter by service.name and confirm recent ingest totals under Usage.

Troubleshooting

SymptomCheck
401 / 403Authorization: Bearer owl_ing_… is present, the key is not revoked, and it belongs to the target project
404Path is /v1/traces, /v1/metrics, or /v1/logs on ingest.owlpane.com
415Content-Type is application/json or application/x-protobuf
Nothing in consoleservice.name resource attribute is set, the correct project is selected, and egress to ingest.owlpane.com is allowed

Last updated

On this page