OwlpaneDOCS
Collectors & Agents

Runtime telemetry (agent)

Cluster workloads instrumented through the Helm chart can feed Observability → Runtimes without embedding Owlpane SDKs in every image.

Data path

Pod (OTel auto-instrumentation) → node agent :4318 (OTLP) → Owlpane ingest → console Runtimes

Enable auto-instrumentation

Requires the OpenTelemetry Operator in the cluster.

In Helm values:

autoInstrumentation:
  enabled: true
  samplerRatio: "1"
nodeAgent:
  enabled: true
  otlpHostPort: true

The chart creates an Instrumentation named owlpane that sets:

  • OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
  • OTEL_METRICS_EXPORTER=otlp (required for runtime vitals/charts)
  • OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf

Install/upgrade with the Helm agent OCI chart.

Opt-in on a Deployment

metadata:
  annotations:
    instrumentation.opentelemetry.io/inject-java: "owlpane/owlpane"

Replace inject-java with inject-nodejs, inject-python, inject-dotnet, or inject-go. The namespace prefix must match the Helm release namespace (default owlpane).

Resource attributes

Ensure pods set or inherit:

  • deployment.environment.name
  • telemetry.sdk.language (set by language instrumentation)
  • service.name (OTEL_SERVICE_NAME or Kubernetes metadata)

What the console shows

Per language: RED cards, slowest operations, top errors, dependencies, workload split series, and runtime metric charts when OTLP metrics are present.

See also SDK runtime telemetry for application-side checklists.

Host / VM workloads

For processes outside Kubernetes, export OTLP to Owlpane ingest or a standalone collector — Host collector.

Last updated

On this page