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
