Creating property files for the guardian command

You must create specific property files to monitor an MBean. A property file must specify the attribute to retrieve, the polling interval, and define the settings to detect anomalies.

About this task

Use the template files that are located under <InstallDir>/runtime/ia/etc/guardian to create your property files. Each property file must specify the name of the MBean to query, and the JMX attribute name on which the threshold is to be tested. The alarmCondition property determines what the guardian utility detects; a threshold can be based on different indicators, for example the length of a delay, the size of the entity store, the size of the event queue, the size of the event store, the amount of free space available on the grid, and the size of the outbound queue.

Procedure

Create as many guardian property files as you want. Each file name must end with .properties, and must contain properties that query a specific JMX MBean, retrieve an attribute, and set the frequency at which to run the query.

The following example shows the configuration for a property file that is named eventstore.properties, which specifies a threshold of 300 MB of used bytes on the MapUsedBytes attribute of the MapMBean over a time window of 14 days.

# ***** ANOMALY DETECTOR SETTINGS ***** 
# 300 MB
enabled=true
alarmCondition=Total.EventStore@.MapUsedBytes > 300000000
sampleCount=64
samplesRequired=10
#14 days
timewindowMinutes=20160
severity=WARNING 

# ***** JMX POLLING SETTINGS ***** 
frequencySeconds=10
jmxDomain = com.ibm.websphere.objectgrid
jmxType=ObjectMapjmxQuery=,*
jmxClassName=com.ibm.websphere.objectgrid.management.MapMBean
jmxNameKey=namejmxNameFilter=EventStore@
jmxAttributeName=MapUsedBytes

Save your changes in a new file outside of the <InstallDir>/runtime/ia/etc/guardian directory.