Skip to content

Latest commit

 

History

History
41 lines (27 loc) · 1.61 KB

opentelemetry.md

File metadata and controls

41 lines (27 loc) · 1.61 KB
title description
OpenTelemetry
How to use OpenTelemetry with Renovate

OpenTelemetry and Renovate

!!! warning "This feature is flagged as experimental" Experimental features might be changed or even removed at any time.

Renovate partially supports OpenTelemetry, the emerging monitoring standard.

OpenTelemetry has three types of observability data:

  • traces
  • metrics
  • logs

Limitations

While OTLP support traces, metrics, and logs, Renovate only supports traces. This means Renovate does not support other observability data like: stats on caching, error events, number of found updates, and so on.

Renovate uses @opentelemetry/exporter-trace-otlp-http under the hood. This means that Renovate sends traces via OTLP/HTTP in JSON-encoded protobuf format only.

Usage

To activate the instrumentation, you must set the OTEL_EXPORTER_OTLP_ENDPOINT environment variable. This variable controls the endpoint for the telemetry data. Once this endpoint is set, you can use all environment variables listed in the OpenTelemetry specification.

Debugging

To help you debug, you can print the telemetry to the console. Use the environment variable RENOVATE_TRACING_CONSOLE_EXPORTER.

Examples

An example with a local OpenTelemetry setup can be found on the OpenTelemetry examples page.