---
title: "Telemetry"
description: "Configure OpenTelemetry export for the Enterprise API using telemetry.conf."
stack: "Enterprise Stack (commercial) — version 1.1.1"
stack_version: "1.1.1"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/setup/configurations/config-files/telemetry
generated: 2026-10-01
---
# Telemetry

`telemetry.conf` configures OpenTelemetry for the Enterprise API. Enable the `telemetry` feature in [`_features.conf`](https://docs.walt.id/enterprise-stack/setup/configurations/config-files/features.md). 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

```hocon[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.