How do I change Symphony logging properties both statically and dynamically?

Symphony consists of two components: SOAM and EGO.

SOAM

A user can change the log level of multiple loggers (given by logger list) for a specific application (given by application name).

  • LOG_FATAL: Logs only those messages in which the system is unusable.

  • LOG_ERROR: Logs only those messages that indicate error conditions.

  • LOG_WARN: Logs only those messages that are warnings or more serious messages. This is the default level of debug information.

  • LOG_INFO: Logs all informational messages and more serious messages. (Default log level)

  • LOG_DEBUG: Logs all debug-level messages.

  • LOG_ALL: Logs all available messages.

A logger (see What are the Symphony loggers?) could be named by component class name such as sim.backend or category name such as workload.

Statically:

  1. Shutdown the system.

  2. Modify the logging properties in the configuration files present in ${SOAM_HOME}/conf.

  3. Restart the system.

Dynamically:

Run the soamlog command. This runtime change just has one-time effect. The log level will persist during the lifetime of a daemon. The ideal use case for this command is to log debug information for "live" processes.

EGO

Statically:

  1. Shut down EGO.

  2. Open ego.conf from $EGO_CONFDIR or %EGO_CONFDIR%.

  3. Change the EGO_LOG_MASK value to one of the following log levels:

    • LOG_EMERG: Only logs messages indicating that the system is unusable.

    • LOG_ALERT: Only logs messages indicating that an action must be taken immediately.

    • LOG_CRIT: Only logs messages that are critical.

    • LOG_ERR: Only logs messages indicating error conditions.

    • LOG_WARNING: Only logs warning or more serious messages. (Default log level)

    • LOG_NOTICE: Logs messages indicating normal but significant conditions or warnings and more serious messages.

    • LOG_INFO: Logs all informational messages and more serious messages.

    • LOG_DEBUG: Logs all debug-level messages.

    • LOG_TRACE: Logs all available messages.

  4. Restart EGO.

Dynamically:

Run the following command for the appropriate daemon:

  • VEMKD: egosh debug vemkdon

  • LIM: egosh debug limon [all | host_list]

    Instead of specifying all, you can also specify which hosts the logging for this daemon should be turned on for.

  • PEM: egosh debug pemon [all | host_list]

    Instead of specifying all, you can also specify which hosts the logging for this daemon should be turned on for.

For more information, see the egosh reference.