Metric Ingestion
Owlpane ingests counters, gauges, and histograms over OTLP (/v1/metrics) and Prometheus remote-write compatible pipelines through the OpenTelemetry Collector.
Endpoints
| Transport | Target | Content-Type |
|---|---|---|
| OTLP/HTTP | POST https://ingest.owlpane.com/v1/metrics | application/x-protobuf or application/json |
| OTLP/gRPC | opentelemetry.proto.collector.metrics.v1.MetricsService/Export on ingest.owlpane.com:443 | — |
| Prometheus remote write | POST https://ingest.owlpane.com/api/v1/write | application/x-protobuf |
Authenticate with Authorization: Bearer owl_ing_…. See the OTLP ingest reference.
Recommended Attributes
service.name— Logical service identifier (e.g.checkout-api).deployment.environment— Environment tag (production,staging,dev).host.name/k8s.cluster.name— Host and cluster scoping for infrastructure series.
curl example (OTLP/HTTP JSON)
curl -sS -X POST "https://ingest.owlpane.com/v1/metrics" \
-H "Authorization: Bearer $OWLPANE_INGEST_KEY" \
-H "Content-Type: application/json" \
-d '{"resourceMetrics":[{"resource":{"attributes":[{"key":"service.name","value":{"stringValue":"checkout-api"}}]},"scopeMetrics":[{"scope":{"name":"manual"},"metrics":[{"name":"checkout.orders","unit":"1","gauge":{"dataPoints":[{"asInt":"1","timeUnixNano":"1544712660000000000"}]}}]}]}]}'OpenTelemetry Collector exporter
exporters:
otlphttp/owlpane:
endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT}
headers:
Authorization: "Bearer ${env:OWLPANE_INGEST_KEY}"Verify it arrived
Open Observability → Explorer (/observability/explorer) and query the metric by name. New series are queryable within a few seconds.
Querying Metrics in Dashboards
Imported and built-in dashboards query metrics using either PromQL-compatible expressions or SQL aggregations over metric streams. Use template variables such as $service or $namespace to filter panels dynamically.
Troubleshooting
| Symptom | Check |
|---|---|
401 / 403 | Authorization: Bearer owl_ing_… header is present and the key is valid |
415 | Content-Type is application/json or application/x-protobuf |
404 on remote write | Use POST /api/v1/write, not the OTLP paths |
| Metric missing in Explorer | service.name is set and the metric name matches; check Usage for ingest totals |
Last updated
Log Ingestion
Owlpane ingests structured and unstructured logs via OTLP/HTTP (`/v1/logs`), the Owlpane language SDKs, and host/Kubernetes log collectors.
Distributed Trace Ingestion
Send OpenTelemetry spans to `POST /v1/traces` using any [Owlpane SDK](../sdk/node.md) or standard OpenTelemetry instrumentation.