Telemetry

Using the telemetry.conf file, you can configure the telemetry for the Enterprise API. This is an optional feature which can be enabled by adding it to the enabledFeatures list in the _features.conf file. When enabled, the Enterprise API will collect telemetry data and send it to the configured OpenTelemetry collector.

When making API calls, you can include the traceparent header to pass a trace id in W3C Trace Context format. This will allow you to trace the request through the system. We only support HTTP based exporters for now.

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"
}

Last updated on November 10, 2025