How to configure CA SystemEDGE to monitor disk space and send traps when thresholds are exceeded.

Document ID : KB000023264
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction:

How to configure CA SystemEDGE to monitor filesystem and send traps when thresholds are exceeded.

Background:  

Many times its needed to monitor many or all disks on a system. This can be accomplished by creating filesystem watchers or autowatchers for all or almost all file systems. 

Environment:  

ANY

Instructions: 

1) Modify the sysedge.cf to configure the file system watchers.

Sysedge.cf is in the CA SystemEDGE data_directory,

The default path in unix,

/opt/CA/SystemEDGE/config/port1691/sysedge.cf

The default path in windows,

C:\Users\Public\CA\SystemEDGE\port1691\sysedge.cf

Add the required watcher, below are some samples in the additional information section.

2) Add your watchers to the sysedge.cf (used from examples below)

monitor devTableEntry '/' devCapacity 51 0x0020030 60 absolute >= 90 'Root File System Usage (percentage)'     '' 'FileSystem' '/'    'PercentUsed' warning

autowatch -index=56 -name=All File systems -watchtype=generic -table=devTableEntry -attribute=devCapacity -criteria='.*' -op=ge -value=90 -severity=critical -interval=60 -desc=File System Watcher -monflags=0x0 -matchtype=positive -stype=absolute -scale=1 -objclass=devTableEntry -watchflags=0x0 -limit=100 -loss=fatal

3) Restart the CA SystemEDGE Agent,

On windows you can restart the agent in the services.msc

On Unix you can go to run the following command:

/opt/CA/SystemEDGE/bin/sysedgectl restart

 

Additional Information:

Example 1: Monitor the root (/) partition every 60 seconds. The "used space" threshold is 90%, if this threshold is exceeded after 2 minutes (2 monitor cycles), then sent traps continually until this state of condition goes from True to False:

CA SystemEDGE version 4.3.x
monitor filesystem '/' devCapacity 51 0x00200300 60 absolute >= 90 'Root File System Usage (percentage)' "

CA SystemEDGE 5.x

monitor devTableEntry '/' devCapacity 51 0x0020030 60 absolute >= 90 'Root File System Usage (percentage)'     '' 'FileSystem' '/'    'PercentUsed' warning

Notes on above watcher,

Monitor Table Flags above

 

1. Send traps after 2 minutes of the condition being met: 0x00200000
2. Send traps continuously if condition still exists: 0x00000200
3. Optional SendMonitorClear trap: 0x00000100

--------------------------------------------------------------------------------

Example 2: Monitor using an auto watcher all partitions every 60 seconds. The "used space" threshold is 90%, if this threshold is exceeded after 2 minutes (2 monitor cycles), then sent traps continually until this state of condition goes from True to False:

CA SystemEDGE Release 5.8 an greater entry:
autowatch -index=56 -name=All File systems -watchtype=generic -table=devTableEntry -attribute=devCapacity -criteria='.*' -op=ge -value=90 -severity=critical -interval=60 -desc=File System Watcher -monflags=0x0 -matchtype=positive -stype=absolute -scale=1 -objclass=devTableEntry -watchflags=0x0 -limit=100 -loss=fatal

Notes on above watcher,

1) The -criteria flag this can be regular expression and modified

2) The -matchtype can be positive or negative like -critera '/opt/CA/.*' which would say monitor all file systems which were not like /opt/CA/*

3) The -monflags are the inherited monitor flags and could be 0x0020030

4) The -loss is fatal which means if a monitored object is removed send a fatal trap but this can be modified to remove the watcher instead. Since some people get confused on the fatal trap thiking its for the percent used when its because the item is removed.

 


The flag settings for the above goal is the sum of each flag: 0x00200300

For more information see the SystemEDGE Agent User Guide, Section 9 "Using the Self-Monitoring Capability"

Related Issues/Questions:
How to configure SystemEDGE to monitor disk space and send traps when thresholds are exceeded