Skip to main content

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.

File purpose

The logback-spring-file.xml file defines the logback configuration for the MR application in production.

File location

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

File values

The logback-spring-file.xml file uses Logback configuration. See the official Logback documentation for details about Logback concepts: <https://logback.qos.ch/documentation.html>
The file has the following attributes:
ElementAttributeValueDescription
<configuration>debugtrueFlag used to enable/disable Logback debug mode
<shutdownHook>classch.qos.logback.core.hook.DelayingShutdownHookInstall a JVM shutdown hook to shut down logback and release associated resources.
<jmxConfigurator/>Allows the configuration of logback via JMX
<conversionRule>conversionWordthreadConfiguration of a custom converter to retrieve the current thread generating the log
converterClasscom.activeviam.apm.logging.impl.APMThreadConverterConfiguration of a custom converter to retrieve the current thread generating the log
<conversionRule>conversionWorduserConfiguration of a custom converter to retrieve the current user generating the log
converterClasscom.activeviam.apm.logging.impl.APMUserConverter
<conversionRule>conversionWordinstanceConfiguration of custom converter to retrieve the instance name of the application
converterClasscom.activeviam.apm.logging.impl.APMInstanceConverter
<timestamp>keystartupDateTimeIndicates that a timestamp will be generated at configuration parsing time
datePatternyyyyMMdd-HHmmssPattern of the generated timestamp
<property>namelogDirRootPathName of the property used to define the folder in which the logs will be printed out
value${LOG_PATH:-.}/logs}Value of that property
<property>namelogFileNamePrefixName of property used to define the prefix of the log files
valuemr-application_${startupDateTime}_%i-startup_Value of that property
<property>namelogFileNameRollingTagName of the property used to define the tag used in the rolled logs
value%d{yyyyMMdd}-periodValue of that property
<property>namelogFileNameExtName of the property used to define the exension of the generated log files
value.log.zipValue of that property
<property>namelogFileRollingMaxHistoryName of the property used to define the maximum number of rolled-over files to keep
value30Value of that property
<property>namelogFileRollingMaxFileSizeName of the property used to define the maximum size of a log file
value200GBValue of that property
<property>namelogPatternName of the property used to define the layout of the logs
value%n%date{yyyy-MM-dd HH:mm:ss.SSS z} %relative [%thread] %logger%n%level: %message%n%throwableValue of that property
<appender>nameJSONAppender used to output JSON logs
classch.qos.logback.core.rolling.RollingFileAppenderRolling file appender
<file>${custom.json.log.dir}/activepivot.logThe name of the file to write to
<rollingPolicy>classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicyRolls over files primarily by date, but also limits the size of each log file
<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
<maxFileSize>${logFileRollingMaxFileSize}Controls the maximum size of rolled-over files
<cleanHistoryOnStart>trueIf set to true, roll over removal will be executed on appender start-up
<encoder>classnet.logstash.logback.encoder.LogstashEncoderThe encoder class used to transform an event into an output stream
<timestampPattern>[UNIX_TIMESTAMP_AS_NUMBER]Writes the timestamp value as a numeric unix timestamp
<excludeMdcKeyName>user_nameExcludes that field from the Mapped Diagnostic Context (MDC)
<excludeMdcKeyName>thread_nameExcludes that field from the Mapped Diagnostic Context (MDC)
<fieldNames>
<timestamp>log_timestampDefines the name of the timestamp field
<thread>[ignore]Prevents the thread field from being output by setting the field name to [ignore]
<provider>classnet.logstash.logback.composite.loggingevent.LoggingEventPatternJsonProviderClass that provides support for JSON outputs
<pattern>{
“user_name”: “%user”,
“thread_name”: “%thread”,
“instance_name”: “%instance”
}
Adds that JSON pattern to the logs
<appender>nameMAINAppender used to output main logs
<class>classch.qos.logback.core.rolling.RollingFileAppenderRolling file appender
<rollingPolicy>classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicyRolls over files primarily by date, but also limits the size of each log file
<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
<maxFileSize>${logFileRollingMaxFileSize}Controls the maximum size of rolled-over files
<encoder>
<pattern>${logPattern}Pattern used for the log output
<appender>nameQUERIESAppender used to output logs specific to queries
<class>classch.qos.logback.core.rolling.RollingFileAppenderRolling file appender
<rollingPolicy>classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicyRolls over files primarily by date, but also limits the size of each log file
<fileNamePattern>${logDirRootPath}/${logFileNamePrefix}queries_${logFileNameRollingTag}${logFileNameExt}Name of the rolled-over log files
<maxHistory>${logFileRollingMaxHistory}Controls the maximum number of rolled-over files to keep
<maxFileSize>${logFileRollingMaxFileSize}Controls the maximum size of rolled-over files
<encoder>
<pattern>${logPattern}Pattern used for the log output
<logger>namecom.quartetfs.biz.pivot.monitoring.impl.XmlaMonitorListenerThe logger for the class used to output the current time and size of the XMLA response
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.webservicesThe logger for the core Atoti Server webservices package
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.streamingThe logger for the core Atoti Server streaming package
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.tech.streamingLogging for Atoti Server streams (stateful components publishing events to a publisher)
levelINFOThe level of printed out logs for that logger
<logger>namecom.qfs.pivot.rest.discoveryThe logger for the Atoti Server discovery service
levelINFOThe level of printed out logs for that logger
<logger>namecom.qfs.pivot.rest.queryThe logger for the Atoti Server queries service
levelINFOThe level of printed out logs for that logger
<logger>namecom.qfs.pivot.websocketThe logger for Atoti Server websockets
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.pivot.mdxThe logger for the MDX engine
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.impl.TimerActivePivotQueryExecutorA simple query executor that times each query that goes through it, and logs the timings at the Level.INFO
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.impl.ActivePivotVersionThe logger for the Atoti Server version instance
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.query.aggregatesThe logger for the retrieval of aggregated values
levelINFOThe level of printed out logs for that logger
<logger>namecom.quartetfs.biz.pivot.postprocessingThe logger for Atoti Server post-processors
levelINFOThe level of printed out logs for that logger
<logger>nameorg.springframework.httpThe logger for the Spring package that contains a basic abstraction over client/server-side HTTP.
levelINFOThe level of printed out logs for that logger
<logger>nameorg.springframework.remotingThe logger for the exception hierarchy for Spring’s remoting infrastructure, independent of any specific remote method invocation system.
<root>levelINFORoot logger level
<appender-ref>refSTDOUTThe name of the Logback appender used by the root logger
<contextListener>classch.qos.logback.classic.jul.LevelChangePropagatorImplementation of Logback context listener
<resetJUL>trueFlag used to reset all previous level configurations of all j.u.l. loggers