Page History

HTML

<div style=" border: 1px solid black ; margin: 4px; padding: 30px; text-align: center;">
This page was moved to <a href="https://docs.perspectium.com/display/gold/Log+Timezone+for+DataSync+Agent">Log Timezone for DataSync Agent</a>
<br>
Click in the link above if you are not automatically redirected in 5 seconds.
</div>
<meta http-equiv="refresh" content="5; URL='https://docs.perspectium.com/display/gold/Log+Timezone+for+DataSync+Agent'" />

By default, the DataSync Agent will produce logs in the timezone of server that is running the agent. You can change the timezone manually by modifying the log4j2.xml file in the conf directory.

Prerequisites

First, you will need to set up one of the Perspectium DataSync Agents.

Then, you should stop running your DataSync Agent before making any Agent configuration changes.

Procedure

To change the timezone in the agent logs, follow these steps:

...

UI Step

Open your log4j2.xml

Navigate to the your DataSync Agent and go to the conf directory

UI Step

Add a timezone to the RollingRandomAccessFile configuration

The <RollingRandomAccessFile> directive controls the log files the Agent creates. Within this directive find the <PatternLayout> directive and add your preferred timezone to the <Pattern> directive.

You can see a list of timezones here under the TZ database name column.

For example:

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <Console name="CONSOLE" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p - %t - %c{1} - %m%n"/>
        </Console>
        <RollingRandomAccessFile name="FILE" fileName="logs/perspectium.log"
                filePattern="logs/perspectium-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout> 
            	<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS}{America/New_York} %-5p - %t - %c{1} - %m%n</Pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy />
                <SizeBasedTriggeringPolicy size="20 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="14"/>
        </RollingRandomAccessFile>
        <Async name="ASYNC">
            <AppenderRef ref="FILE"/>
            <AppenderRef ref="CONSOLE"/>
        </Async>
    </Appenders>
    <Loggers>
        <logger name="org.apache.http" level="error" additivity="false">
            <AppenderRef ref="ASYNC"/>
        </logger>
        <logger name="com.perspectium.db" level="info">
            <AppenderRef ref="ASYNC"/>
        </logger>
        <logger name="org.springframework" level="info">
            <AppenderRef ref="ASYNC"/>
        </logger>
        <Root level="info">
            <AppenderRef ref="ASYNC"/>
        </Root>
    </Loggers>
</Configuration>

Notice the <Pattern> directive has the {America/New_York} tag added so logs will be using the Eastern timezone ({America/New_York} will account for both daylight and standard times). In this example we're only updating the timezone of the log files but if you would like to update the console (in the case of running in foreground mode), change <PatternLayout> in the <Console> directive as well.