Adding time zone information to Integration Agent log messages

Troubleshooting interactions between an xMatters On-Demand instance and an Integration Agent (for example, heartbeat or registration issues) can present an additional challenge if the Integration Agent's time zone is not known.

Log messages for an On-Demand instance include GMT timestamps, regardless of the physical location of the xMatters server, but Integration Agent log messages are timestamped using the time zone information from the local operating system. This condition can complicate troubleshooting efforts, especially if the Integration Agent owner cannot be reached when the information is needed.

To include time zone information in Integration Agent log messages:

  1. Back up the <IAHome>\conf\log4j.xml file.
  2. Open the original log4j.xml
  3. Locate both instances of the following code:

<param name="ConversionPattern" value="%d [%t] %p - %m%n"/>

  1. Replace each instance with the following line:

<param name="ConversionPattern" value="%d{yyyy/MM/dd HH:mm:ss.SSS Z z} [%t] %p - %m%n"/>

  1. Save and close the file

The change will take effect immediately; there is no need to restart the Integration Agent.

After this change, timestamps in the Integration Agent logs will include the time zone name (eg, "PST") as well as the offset from GMT (eg, "-0800",) simplifying the task of reconciling Integration Agent log messages with ones from the On-Demand instance.


xMatters internal reference: DTN-4997

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk