How to Enable UTC / ISO 8601 Format Logging in IBM Manta Data Lineage

Manta Data Lineage can be configured so that all date and time stamps, both time stamps in Manta Data Lineage-generated log files as well as time stamps on revision numbers reflect the UTC time zone or ISO 8601 format.

UTC Time Zone Configuration

The adjustments required to update the logging time stamps to reflect the UTC time zone are as follows.

  1. Update all (4) log4j2.xml files to reflect the following format for all occurrences of the %d{yyyy-MM-dd HH:mm:ss.SSS} syntax from within the file.

    1. %d{yyyy-MM-dd HH:mm:ss.SSS} → %d{yyyy-MM-dd HH:mm:ss.SSS}{GMT+0}

    2. Locate any other date references in the file %d{yyyy_MM_dd} and append {GMT+0} to them.

    3. You will find the Log4J configuration at:

      1. Admin UI > Configuration > Server > Common > Log4J Server

      2. Admin UI > Configuration > CLI > Common > Log4J CLI

      3. Admin UI > Configuration > CLI > Common > Log4J Platform

      4. Admin UI > Configuration > Admin UI > Common > Log4J Admin UI

  2. Add the line below to both setenv.sh files.

    1. CATALINA_OPTS=-Duser.timezone=UTC

    2. You will find the setenv.sh files here:

      1. /opt/mantaflow/server/bin/setenv.sh

      2. /opt/mantaflow/serviceutility/bin/setenv.sh

  3. Add the lines below to the logging.properties files.

    java.util.logging.ConsoleHandler.formatter = org.apache.juli.OneLineFormatter
org.apache.juli.OneLineFormatter.timeFormat = yyyy-MM-dd HH:mm:ss.SSS

    1. You will find the logging.properties files here:

      1. /opt/mantaflow/server/conf/logging.properties

      2. /opt/mantaflow/serviceutility/conf/logging.properties

ISO 8601 Configuration

The adjustments required to update the logging time stamps to the ISO 8601 format are as follows.

  1. Update all (4) log4j2.xml files to reflect the following.

    1. %d{yyyy-MM-dd HH:mm:ss.SSS} → %d{ISO8601}{GMT+0}Z

    2. Locate any other date references in the file %d{yyyy_MM_dd} and append {GMT+0} to them.

    3. You will find the Log4J configuration at:

      1. Admin UI > Configuration > Server > Common > Log4J Server

      2. Admin UI > Configuration > CLI > Common > Log4J CLI

      3. Admin UI > Configuration > CLI > Common > Log4J Platform

      4. Admin UI > Configuration > Admin UI > Common > Log4J Admin UI

  2. Add the line below to both setenv.sh files.

    1. CATALINA_OPTS=-Duser.timezone=UTC

    2. You will find the setenv.sh files here:

      1. /opt/mantaflow/server/bin/setenv.sh

      2. /opt/mantaflow/serviceutility/bin/setenv.sh

  3. Add the lines below to the logging.properties files.

    java.util.logging.ConsoleHandler.formatter = org.apache.juli.OneLineFormatter
org.apache.juli.OneLineFormatter.timeFormat = yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

    1. You will find the logging.properties files here:

      1. /opt/mantaflow/server/conf/logging.properties

      2. /opt/mantaflow/serviceutility/conf/logging.properties