Skip to main content

Open Telemetry

Oodle supports metrics ingestion via Open Telemetry.

Otel Collector Configuration

In the Oodle UI, navigate to the Settings page and click on Connect in the Open Telemetry tile and copy the provided configuration snippet.

Open Telemetry Configuration

Oodle can ingest Open Telemetry metrics using the otlphttp exporter.

Add the otlphttp exporter from above in your Open Telemetry collector configuration by adding an entry in the exporters section, and then adding the exporter to the service.pipelines.metrics.exporters list.

otel-collector-config.yaml
receivers:
otlp:
protocols:
http:

processors:
batch:

exporters:
otlphttp/oodle:
metrics_endpoint: "https://<OODLE_ENDPOINT>/v1/otlp/metrics/<INSTANCE_ID>"
headers:
X-API-KEY: "<API_KEY>"

service:
pipelines:
metrics:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/oodle]

Otel To Prometheus Translation

Ingested Open Telemetry metrics are converted to Prometheus format.

Metric Name Normalization

Metric names are normalized by removing the characters that Prometheus does not support with underscore (_) and dropping the redundant, leading and trailing underscores. For example, system.cpu.time becomes system_cpu_time.

We also ensure that metric name does not start with a digit by prefixing it with an underscore if necessary.

Attributes

Resource and metric attributes are converted to Prometheus labels with special handling for following resource attributes:

  • service.name is mapped to job label.
  • service.instance.id is mapped to instance label.

Temporality

We currently do not support delta temporality for Sum, Histogram and Exponential Histogram metric types.

Visualize Metrics

You can visualize metrics in Oodle using the Explore Metrics tab. It supports Grafana Builder and Code Editor to build PromQL queries. Please refer to PromQL Query docs to learn more about PromQL.

Explore Metrics

Support

If you have any questions or need any assistance, please contact us via our help chat app located at the bottom-right of the page or by reaching out to support@oodle.ai.