> ## 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.

# Distribution Monitoring

## Tracing

The distribution layer leverages tracing to provides insights into the queries executed in the cluster.

Check [tracing](../monitoring/tracing) to configure it.

## Logging

Without tracing activated, the distribution layer provides some logging.

### Logger naming

To retrieve all the distribution logs, two loggers should be activated:

* `atoti.server.distribution` (new namespace)
* `com.activeviam.activepivot.dist` (legacy namespace)

The issue with the legacy logger is that its name hierarchy (e.g. `com.activeviam.activepivot.dist.impl.private_`) contains internal packages and classes,
thus making it hard to filter using a more granular logger, as the full logger name hierarchy is not public, and can be changed between two bugfix versions.

The new logger (`atoti.server.distribution`) will provide some more granular loggers, to focus on one particular aspect of
the distribution such as "atoti.server.distribution.messaging", ...

The exhaustive list will be made available in the future, but will be fully contained under `atoti.server.distribution`.

As loggers will be moved gradually from `com.activeviam.activepivot.dist` to `atoti.server.distribution`,
it is recommended to activate both loggers in your project, to avoid missing any logs when upgrading to a newer bugfix version.