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

# logback.xml

## File purpose

The **logback.xml** file defines the logback configuration for Atoti CVA Risk Capital in production.

<Note>
  As of version 6.0.0, Atoti CVA Risk Capital uses Logback 1.5.x which includes some configuration changes from previous versions. Ensure your custom logback configurations are compatible with Logback 1.5.x.
</Note>

## File location

The file is located in the folder **cvarc-application\src\main\resources**.

## File values

<Note>
  The **logback.xml** file uses Logback configuration. See the official Logback documentation for details about Logback concepts: [https://logback.qos.ch/documentation.html](https://logback.qos.ch/documentation.html)
</Note>

| Element                                    | Attribute   | Value                                                                                  | Description                                                                                                                               |
| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `<configuration>`                          | debug       | `true`                                                                                 | Flag used to enable/disable Logback debug mode.                                                                                           |
| `<timestamp>`                              | key         | `startupDateTime`                                                                      | Indicates that a timestamp will be generated at configuration parsing time.                                                               |
|                                            | datePattern | `yyyyMMdd-HHmmss`                                                                      | Pattern of the generated timestamp.                                                                                                       |
| `<property>`                               | name        | `logDirRootPath`                                                                       | Name of the property used to define the folder in which the logs will be printed out.                                                     |
|                                            | value       | `${custom.log.dir:-${catalina.base:-.}/logs}`                                          | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logFileNamePrefix`                                                                    | Name of property used to define the prefix of the log files.                                                                              |
|                                            | value       | `cvarc_${startupDateTime}-startup_`                                                    | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logFileNameRollingTag`                                                                | Name of the property used to define the tag used in the rolled logs.                                                                      |
|                                            | value       | `%d{yyyyMMdd}-period-%i`                                                               | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logFileNameExt`                                                                       | Name of the property used to define the exension of the generated log files.                                                              |
|                                            | value       | `.log.zip`                                                                             | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logFileRollingMaxHistory`                                                             | Name of the property used to define the maximum number of rolled-over files to keep.                                                      |
|                                            | value       | `30`                                                                                   | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logFileRollingMaxFileSize`                                                            | Name of the property used to define the maximum size of a log file.                                                                       |
|                                            | value       | `200GB`                                                                                | Value of that property.                                                                                                                   |
| `<property>`                               | name        | `logPattern`                                                                           | Name of the property used to define the layout of the logs.                                                                               |
|                                            | value       | `%date{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %logger%n%level: %message%n%n%throwable`     | Value of that property.                                                                                                                   |
| `<appender>`                               | name        | `MAIN`                                                                                 | Appender used to output main logs.                                                                                                        |
|                                            | class       | `ch.qos.logback.core.rolling.RollingFileAppender`                                      | Rolling file appender.                                                                                                                    |
| `<rollingPolicy>`                          | class       | `ch.qos.logback.core.rolling.TimeBasedRollingPolicy`                                   | Rolls over files by date.                                                                                                                 |
| `<fileNamePattern>`                        |             | `${logDirRootPath}/${logFileNamePrefix}main_${logFileNameRollingTag}${logFileNameExt}` | Name of the rolled-over log files.                                                                                                        |
| `<maxHistory>`                             |             | `${logFileRollingMaxHistory}`                                                          | Controls the maximum number of rolled-over files to keep.                                                                                 |
| `<timeBasedFileNamingAndTriggeringPolicy>` | class       | `ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP`                                    | Specifies the rollover times. The rollover can be set up to occur once per day, per week, or per month.                                   |
| `<maxFileSize>`                            |             | `${logFileRollingMaxFileSize}`                                                         | Controls the maximum size of rolled-over files.                                                                                           |
| `<encoder>`                                |             |                                                                                        |                                                                                                                                           |
| `<pattern>`                                |             | `${logPattern}`                                                                        | Pattern used for the log output.                                                                                                          |
| `<logger>`                                 | name        | `quartetfs.activepivot.xmla`                                                           | The logger for the XMLA response (?)                                                                                                      |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.monitoring.impl.XmlaMonitorListener`                          | The logger for the class used to output the current time and size of the XMLA response.                                                   |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.webservices`                                                  | The logger for the core Atoti Server webservices package.                                                                                 |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.streaming`                                                    | The logger for the core Atoti Server streaming package.                                                                                   |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.tech.streaming`                                                         | Logging for Atoti Server streams (stateful components publishing events to a publisher ).                                                 |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.qfs.pivot.rest.discovery`                                                         | The logger for the Atoti Server discovery service.                                                                                        |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.qfs.pivot.rest.query`                                                             | The logger for the Atoti Server queries service.                                                                                          |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.pivot.mdx`                                                              | The logger for the MDX engine.                                                                                                            |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.impl.TimerActivePivotQueryExecutor`                           | A simple query executor that times each query that goes through it, and logs the timings at the Level.INFO                                |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.impl.ActivePivotVersion`                                      | The logger for the Atoti Server version instance.                                                                                         |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.query.aggregates`                                             | The logger for the retrieval of aggregated values.                                                                                        |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.quartetfs.biz.pivot.postprocessing`                                               | The logger for Atoti Server post-processors                                                                                               |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `org.springframework.http`                                                             | The logger for the Spring package that contains a basic abstraction over client/server-side HTTP.                                         |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `org.springframework.remoting`                                                         | The logger for the exception hierarchy for Spring’s remoting infrastructure, independent of any specific remote method invocation system. |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<logger>`                                 | name        | `com.qfs.pivot.websocket`                                                              | The logger for Atoti Server websockets.                                                                                                   |
|                                            | level       | `INFO`                                                                                 | The level of printed out logs for that logger.                                                                                            |
| `<appender-ref>`                           | ref         | `QUERIES`                                                                              | The name of the Logback appender used by the logger.                                                                                      |
| `<root>`                                   | level       | `INFO`                                                                                 | Root logger level.                                                                                                                        |
| `<appender-ref>`                           | ref         | `MAIN`                                                                                 | The name of the Logback appender used by the root logger.                                                                                 |
| `<contextListener>`                        | class       | `ch.qos.logback.classic.jul.LevelChangePropagator`                                     | Implementation of Logback context listener.                                                                                               |
| `<resetJUL>`                               |             | `true`                                                                                 | Flag used to reset all previous level configurations of all j.u.l. loggers.                                                               |
