log4j2.xml
The file "log4j2.xml" located in your /<indexima_install_folder>/galactica/conf folder is used to configure the Indexima logs.
It is recommended to use the template present in the indexima installer package.
log4j2.xml
<?xml version="1.0" encoding="UTF-8"?>
<Configuration monitorInterval="30">
<Properties>
<Property name="LOG_PATTERN">%d{yyyy-MM-dd_HH:mm:ss} %5p [%t] %c - %m%n</Property>
</Properties>
<Appenders>
<!-- Default appender in console. Only STDOUT -->
<Console name="ConsoleAppender" target="SYSTEM_OUT">
<PatternLayout pattern="${LOG_PATTERN}"/>
</Console>
<!-- File appender with 100MB / day. The property log4j2.logFolder is set into galactica -->
<RollingFile name="FileAppender" fileName="${sys:log4j2.logFolder}/indexima_current.log"
filePattern="${sys:log4j2.logFolder}/indexima_%d{yyyy-MM-dd}.log" append="true" createOnDemand="true">
<PatternLayout pattern="${LOG_PATTERN}" />
<Policies>
<TimeBasedTriggeringPolicy interval="1" />
<SizeBasedTriggeringPolicy size="100 MB"/>
</Policies>
<DefaultRolloverStrategy max="2" compressionLevel="0">
<!-- old files deleted hen age > 7 days -->
<Delete basePath="${sys:log4j2.logFolder}" >
<IfLastModified age="7d" />
<IfFileName glob="indexima_*.log" />
</Delete>
</DefaultRolloverStrategy>
</RollingFile>
<!-- Create an async appender for logs file -->
<Async name="AsyncFileAppender">
<AppenderRef ref="FileAppender"/>
</Async>
<!-- Create an async appender for console logs -->
<Async name="AsyncConsoleAppender">
<AppenderRef ref="ConsoleAppender"/>
</Async>
</Appenders>
<Loggers>
<!-- Default configuration -->
<Root level="INFO">
<AppenderRef ref="AsyncFileAppender"/>
</Root>
<!-- Default configuration -->
<Logger name="org.apache.commons.jcs" level="WARN" additivity="false">
<AppenderRef ref="AsyncFileAppender"/>
</Logger>
<!-- Yarn launcher goes to console. -->
<Logger name="io.galactica.yarn" level="INFO" additivity="false">
<AppenderRef ref="AsyncConsoleAppender"/>
</Logger>
<!-- Console Logger. Do not change. -->
<Logger name="INDEXIMA_CONSOLE" level="INFO" additivity="false">
<AppenderRef ref="AsyncConsoleAppender"/>
</Logger>
<!-- Monitoring Logger. Do not change. -->
<Logger name="INDEXIMA_MONITOR" level="INFO" additivity="false">
<AppenderRef ref="AsyncConsoleAppender"/>
</Logger>
</Loggers>
</Configuration>Base configuration
This will write logs in a file located in the folder specified by the property log.dir in the galactica.conf configuration file.
The current log file is named indexima_current.log.
Every day, it rotates the file to a new one, and save the previous file with the corresponding date.
Log History
The property <IfLastModified age= allows you to change the default maximum log history. Default is 7 days.
Loggers
5 loggers are configured.
Root logger
This is the base logger, logging 90% of the events in Galactica. It is recommended to keep it on level=INFO. If you need a more detailed log for a specific reason, you can change it to DEBUG. If you do this, don't forget to put it back to INFO once you found what you are looking for.
Apache JCS
An additional logger for common modules by Apache.
Yarn
Yarn logs if you use YARN deployment.
Indexima Console
Logs related to Indexima Console. By default, it is written on the terminal.
Indexima Monitoring
Logs related to Indexima SQL queries. All queries sent to Indexima are logged. By default, it is written on the terminal.
To go further
If you want to customize your logging experience, please refer to the official Apache documentation: https://logging.apache.org/log4j/2.x/.