OwlpaneDOCS
Ingestion

Metric Ingestion

Owlpane ingests counters, gauges, and histograms over OTLP (/v1/metrics) and Prometheus remote-write compatible pipelines through the OpenTelemetry Collector.

Endpoints

TransportTargetContent-Type
OTLP/HTTPPOST https://ingest.owlpane.com/v1/metricsapplication/x-protobuf or application/json
OTLP/gRPCopentelemetry.proto.collector.metrics.v1.MetricsService/Export on ingest.owlpane.com:443—
Prometheus remote writePOST https://ingest.owlpane.com/api/v1/writeapplication/x-protobuf

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

  • 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

SymptomCheck
401 / 403Authorization: Bearer owl_ing_… header is present and the key is valid
415Content-Type is application/json or application/x-protobuf
404 on remote writeUse POST /api/v1/write, not the OTLP paths
Metric missing in Explorerservice.name is set and the metric name matches; check Usage for ingest totals

Last updated

On this page