MicroStrategy ONE

Logging in Modeling Service

The Modeling service uses log4j 2 to support the logging requirements.

MicroStrategy 2021 Update 4 and later includes fixes for CVE-2021-44228 and CVE-2021-45046 by upgrading Apache Log4j 2 version to 2.16.0.

By default, the logs for the Modeling service are enabled at the "INFO" level. For more information about the standard log levels built into Log4J, see Custom Log Levels on the Apache website.

The log files can be found in:

Windows: <INSTALL_PATH>\MicroStrategy\ModelingService\logs\

Linux: <INSTALL_PATH>/MicroStrategy/ModelingService/logs/

Use the following procedures to customize logging:

Customize the Logging in the Modeling Service

Follow the procedures below to customize the logging in the Modeling service.

Enable the Configuration File for Logging

  1. Locate the logging configuration template file, log4j2.xml.template in:

    Windows: <INSTALL_PATH>\MicroStrategy\ModelingService\admin

    Linux: <INSTALL_PATH>/MicroStrategy/ModelingService/admin

  2. Under the admin folder, make a copy of log4j2.xml.template and rename it to log4j2.xml.
  3. Restart the Modeling service.

Change the Log Level for the Modeling Service

If a more detailed log is needed for troubleshooting:

  1. Enable the configuration file for logging.
  2. Under the admin folder, modify log4j2.xml.

  3. Change the level to "DEBUG" or "TRACE".

    Copy 
    <Root level="INFO" includeLocation="false">

  4. Restart the Modeling service.

Maintain the Log History

By default, the Modeling service keeps the log for the last 30 days or the most recent 45 files, whichever comes first. To configure a different log history:

  1. Enable the configuration file for logging.
  2. Under the admin folder, modify log4j2.xml.

  3. Change the values for the following properties:

    Copy 
    <IfLastModified age="30d" />
    <IfAccumulatedFileCount exceeds="45" />

  4. Restart the Modeling service.

Customize the Logging in the Modeling Service for Communication with Intelligence Server

Starting in MicroStrategy 2021 Update 4, the Modeling service also uses logger.properties to set up the logging infrastructure when communicating with Intelligent servers. This procedure should only be used in MicroStrategy 2021 Update 4 and up.

Creating and Customizing a logger.properties File

  1. Locate the logger properties template file, logger.properties.template in:

    Windows: <INSTALL_PATH>\MicroStrategy\ModelingService\conf

    Linux: <INSTALL_PATH>/MicroStrategy/ModelingService/conf

  2. Under the conf folder, make a copy of logger.properties.template and rename it to logger.properties.

  3. Refer to Logger.properties to customize the logger.properties file.

  4. Restart the Modeling service.