Log Output Options
To configure log outputs, set the following log level options listed below to the 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 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