Configuring the Logging Behavior of Broker Monitor
By default, Broker Monitor records all three message types to the Broker Server log and to the host computer's native logging facility.
To modify this behavior or to enable logging to SNMP, you must edit the Broker Monitor configuration file (awbrokermon.cfg). The following table shows where the file resides for each platform:
On this platform... | The configuration file is located here... |
Windows | webMethods Broker_directory \bin\awbrokermon.cfg |
UNIX | webMethods Broker_directory /bin/awbrokermon.cfg |
The parameters to configure the logging behavior of Broker Monitor are as follows:
Logging Parameter | Where... |
monitor-log-alert=logSetting | logSetting is 0 (to disable) or 1 (to enable) the logging of alert messages. The default is 1. |
monitor-log-warning=logSetting | logSetting is 0 (to disable) or 1 (to enable) the logging of warning messages. The default is 1. |
monitor-log-info=logSetting | logSetting is 0 (to disable) or 1 (to enable) the logging of informational messages. The default is 1. |
monitor-log-eventlog=logSetting | logSetting is 0 (to disable) or 1 (to enable) the logging of messages to the Windows Event Log Service. Default is 1 on Windows host machines. |
monitor-log-syslog=logSetting | logSetting is 0 (to disable) or 1 (to enable) the logging of messages to the UNIX syslog. The default is 1 on UNIX host machines. |
monitor-log-syslog-facility=logFacility | logFacility specifies the UNIX syslog facility to which messages are to be sent. The default is local5. |
monitor-log-snmp=logSetting | logSetting is 0 (to disable) or 1 (to enable) the generation of SNMP traps. The default is 0. |
Important:
Add the logging parameters to the end of the awbrokermon.cfg file. Do not modify any of the non-logging parameters in the file.
The following is an example of a configuration file:
# This file is the configuration file for the webMethods Broker Monitor.
# It is maintained by the Broker Server configuration program.
# Do not edit this file manually!
server-6849.datadir=C:\SoftwareAG\Broker\data\awbrokersversion\default
server-6849.exec=C:\SoftwareAG\Broker\bin\awbroker.exe
server-6849.version=10.15
server-6849.port=6849
server-6845.datadir=C:\SoftwareAG\Broker\data\awbrokersversion\BrokerServerE01
server-6845.exec=C:\SoftwareAG\Broker\bin\awbroker.exe
server-6845.version=10.15
server-6845.port=6845
monitor-log-info=0
monitor-log-syslog=1
monitor-log-syslog-facility=local7
monitor-log-snmp=1
Tip:
If you want to accept the default behavior for a parameter, simply omit the parameter from the configuration file. For example, if you want Broker Server to log alerts and warnings (the default behavior), but not informational messages, include the "monitor-log-info=0" parameter in the configuration file and omit the parameters for the other two message types.