Telemetry

telemetry.conf configures OpenTelemetry for the Enterprise API. Enable the telemetry feature in _features.conf. When enabled, the API exports traces to the configured OTLP HTTP collector.

When making API calls, you can include the traceparent header to pass a trace id in W3C Trace Context format. Only HTTP OTLP exporters are supported.

Example File

telemetry.conf
# Telemetry configuration for OpenTelemetry

# Service name for telemetry
serviceName = "waltid-enterprise-api"

# Service version
serviceVersion = "1.0.0"

# Deployment environment
environment = "development"

# OpenTelemetry configuration
openTelemetry {
    # OTLP exporter endpoint
    otlpEndpoint = "http://localhost:4318/v1/traces"

    # Tracer name
    tracerName = "waltid-enterprise-api"
}

Fields

serviceName

String — Service name reported on spans. Default in the example is "waltid-enterprise-api".

serviceVersion

String — Service version reported on spans.

environment

String — Deployment environment label, for example "development" or "production".

openTelemetry.otlpEndpoint

String — OTLP HTTP traces endpoint.

openTelemetry.tracerName

String — Tracer name used when creating spans.

Last updated on September 28, 2026