Broker 10.5 | webMethods Broker Documentation | Administering webMethods Broker | Managing Broker Servers | The Broker Server Log | Configuring the Logging Behavior of Broker Monitor
 
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.5
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.5
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.