Jump to: navigation, search

Log Output Options

To configure log outputs, set the following log level options listed below to the following desired types of log output: stdout, stderr, network, memory, and/or [filename], for log file output.

You can use:

  • One log level option to specify different log outputs.
  • One log output type for different log levels.
  • Several log output types simultaneously, to log events of the same or different log levels.

You must separate the log output types by a comma, when you are configuring more than one output for the same log level. See the topic, Examples.

Notes:

  • If you direct log output to a file on the network drive, an application does not create a snapshot log file (with the extension *.snapshot.log) in case it terminates abnormally.
  • Directing log output to the console (by using the stdout or stderr settings) can affect application performance. Avoid using these log output settings in a production environment.

Warning: The log output options are activated according to the setting of the verbose configuration option.

all

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

network

Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database.Setting the all log level option to the network output enables an application to send log events of the Standard, Interaction, and Trace levels to Message Server. Debug-level log events are neither sent to Message Server nor stored in the Log Database.

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately

Specifies the outputs to which an application sends all log events. The log output types must be separated by a comma when more than one output is configured.

For example:

  • all = stdout, logfile

Warning: To ease the troubleshooting process, consider using unique names for log files that different applications generate.

alarm

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

network

og events are sent to Message Server, which resides anywhere on the network, and Message Server stores the log events in the Log Database.

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately
Specifies the outputs to which an application sends the Alarm-level log events. The log output types must be separated by a comma when more than one output is configured.

For example:

  • standard = stderr, network

debug

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately

Specifies the outputs to which an application sends the log events of the Debug level and higher (that is, log events of the Standard, Interaction, Trace, and Debug levels). The log output types must be separated by a comma when more than one output is configured.

For example:

  • debug = stderr, /usr/local/genesys/logfile

Warning: Debug-level log events are never sent to Message Server or stored in the Log Database.

interaction

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

network

Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database.

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately

Specifies the outputs to which an application sends the log events of the Interaction level and higher (that is, log events of the Standard and Interaction levels). The log outputs must be separated by a comma when more than one output is configured.

For example:

  • interaction = stderr, network

standard

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

network

Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database.

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately

Specifies the outputs to which an application sends the log events of the Standard level. The log output types must be separated by a comma when more than one output is configured.

For example:

  • standard = stderr, network

trace

Default Value: No default value
Valid Values (log output types):

stdout

Log events are sent to the Standard output (stdout).

stderr

Log events are sent to the Standard error output (stderr).

network

Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores the log events in the Log Database.

memory

Log events are sent to the memory output on the local disk. This is the safest output in terms of the application performance.

[filename]

Log events are stored in a file with the specified name. If a path is not specified, the file is created in the application's working directory.

Changes Take Effect: Immediately

Specifies the outputs to which an application sends the log events of the Trace level and higher (that is, log events of the Standard, Interaction, and Trace levels). The log outputs must be separated by a comma when more than one output is configured.

For example:

  • trace = stderr, network

This page was last edited on June 14, 2013, at 14:08.
Comments or questions about this documentation? Contact us for support!