> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# tracing.properties

## File purpose

The **tracing.properties** file includes additional tracing configuration for Atoti Server.

<Note>
  As of version 6.0.0, Atoti CVA Risk Capital has migrated from Spring Cloud Sleuth to **OpenTelemetry** for distributed tracing. The properties below reflect the new OpenTelemetry-based configuration.
</Note>

## File values (6.0.x - OpenTelemetry)

| Key                                      | Value                                          | Description                                                                  |
| :--------------------------------------- | :--------------------------------------------- | :--------------------------------------------------------------------------- |
| tracing.enabled                          | true                                           | Enables OpenTelemetry distributed tracing                                    |
| otel.instrumentation.annotations.enabled | false                                          | Disables OpenTelemetry annotation instrumentation (workaround for conflicts) |
| otel.exporter.otlp.endpoint              | [http://localhost:4317](http://localhost:4317) | OTLP exporter endpoint for traces                                            |
| otel.service.name                        | cvarc-application                              | Service name for trace identification                                        |
| otel.traces.exporter                     | otlp                                           | Exporter type (otlp, zipkin, jaeger, logging, none)                          |
| activeviam.apm.zipkin.span.level         | specific                                       | Configures tracing granularity within Atoti Server.                          |

For OpenTelemetry configuration options, please refer to the [OpenTelemetry Java Documentation](https://opentelemetry.io/docs/languages/java/configuration/).

### Zipkin compatibility

If you are using Zipkin as your tracing backend, you can configure OpenTelemetry to export traces to Zipkin:

| Key                           | Value                                                                    | Description               |
| :---------------------------- | :----------------------------------------------------------------------- | :------------------------ |
| otel.traces.exporter          | zipkin                                                                   | Use Zipkin exporter       |
| otel.exporter.zipkin.endpoint | [http://localhost:9411/api/v2/spans](http://localhost:9411/api/v2/spans) | Zipkin collector endpoint |

<details>
  <summary>Legacy Configuration (5.1.x and earlier - Spring Cloud Sleuth)</summary>

  The following properties were used in versions prior to 6.0.0:

  | Key                        | Value                                          | Description                                    |
  | :------------------------- | :--------------------------------------------- | :--------------------------------------------- |
  | spring.zipkin.baseUrl      | [http://127.0.0.1:9411](http://127.0.0.1:9411) |                                                |
  | spring.zipkin.api-path     | api/v2/spans                                   |                                                |
  | spring.zipkin.service.name | pivot                                          |                                                |
  | spring.zipkin.sender.type  | web                                            |                                                |
  | spring.zipkin.enabled      | false                                          | Enables sending spans to Zipkin if set to true |
  | spring.sleuth.traceId128   | true                                           |                                                |

  For spring based properties please refer to the [Spring Cloud Sleuth Documentation](https://docs.spring.io/spring-cloud-sleuth/docs/current/reference/html/)
</details>