Ingestion
OTLP Ingest Reference
Owlpane natively accepts OpenTelemetry Protocol (OTLP) over HTTP and gRPC.
OTLP/HTTP endpoints
Base URL: https://ingest.owlpane.com.
| Signal | Path | Content-Type |
|---|---|---|
| Traces | POST /v1/traces | application/x-protobuf or application/json |
| Metrics | POST /v1/metrics | application/x-protobuf or application/json |
| Logs | POST /v1/logs | application/x-protobuf or application/json |
OTLP/gRPC services
Point a gRPC exporter at ingest.owlpane.com:443 and call the standard collector services:
| Signal | Service |
|---|---|
| Traces | opentelemetry.proto.collector.trace.v1.TraceService/Export |
| Metrics | opentelemetry.proto.collector.metrics.v1.MetricsService/Export |
| Logs | opentelemetry.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_hereKeys 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
| Source | Endpoint |
|---|---|
| Prometheus remote write | POST /api/v1/write |
| AWS Firehose metrics | POST /aws/firehose/metrics |
| AWS Firehose logs | POST /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
| Symptom | Check |
|---|---|
401 / 403 | Authorization: Bearer owl_ing_… is present, the key is not revoked, and it belongs to the target project |
404 | Path is /v1/traces, /v1/metrics, or /v1/logs on ingest.owlpane.com |
415 | Content-Type is application/json or application/x-protobuf |
| Nothing in console | service.name resource attribute is set, the correct project is selected, and egress to ingest.owlpane.com is allowed |
Last updated