This Knowledge Script uses a configuration file on the managed client computer to monitor the percentage of used space on mounted file systems as reported by the system df command and optionally, check for incremental increases in used space beyond the specified threshold. Using the configuration file, you can specify a different threshold for each file system and therefore receive event information for each (for example, when /usr is at 95% and /bin is at 80%).
When checking for incremental increases, a single event is created if the specified threshold is met; event collapsing is not applicable. If you want to monitor incremental increases in used space, do NOT enable the event option on the Advanced Knowledge Script Properties tab to Generate a new event when original event condition no longer exists. If you enable this option, the Knowledge Script incorrectly creates an event.
NOTE:You can set thresholds for file systems not in the configuration file but found as the result of a df command. You can enable events and data collection for these file systems. You can also use this Knowledge Script to dynamically monitor file systems without re-running discovery.
Any logical disk folder
The default interval for this script is Every hour.
Set the following parameters as needed:
|
Description |
How to Set It |
|---|---|
|
Default Event Thresholds for Mounted File Systems |
|
|
Event Notification |
|
|
Raise event if threshold exceeded for a mounted file system? |
Select Yes to raise an event if the percentage of file system space used exceeds the default used threshold you specify for mounted file systems. The default is unselected. |
|
Threshold -- Maximum used space |
Set a threshold for the maximum percentage of file system space available (total capacity) that should be in use by mounted file systems. The default is 80. |
|
Incremental Event Notification |
|
|
Raise new event for incremental increases? |
Select Yes to continue to raise events if the percentage of file system space used exceeds the capacity threshold you specify and continues to increase since the previous event. The default is unselected. |
|
Threshold -- Incremental increases |
Type the percentage that must be exceeded before another event is raised while the initial threshold remains exceeded. The default is 5. |
|
Event severity when used space exceeds threshold |
Specify the event severity level, from 0 through 40, to indicate the importance of the event. The default is 5. |
|
Event severity for internal failure |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which this job experienced an internal error. The default is 5. |
|
Monitoring |
|
|
File system types to exclude |
Specify the types of systems you do not want to monitor, separated by commas with no space. The default is subfs,usbfs,proc,iso9660,fd. |
|
Monitor mounted NFS shares? |
Select Yes to monitor mounted Network File Systems. The default is unselected. |
|
Override file system configuration values (optional) |
Type the file system configuration values to override. This allows you to enter the values in the user interface. The default is blank. Use the following format (semi-colon, separated) for the configuration values: "doevent?,dodata?,threshold,mountpoint,machinename" y,n,80,/usr;n,y,80,/var,<machinename> Entering the machine name is optional. |
|
Override configuration file (full path) (optional) |
Type the full path to the logical configuration file you created. The default is blank. Use the following format for the configuration file; enter one line per entry: "doevent?,dodata?,threshold,mountpoint" y,n,80,/usr n,y,75,/var y,y,90,/tmp |
|
Default Data Collection Options for Mounted File Systems |
|
|
Collect data for space usage on all mounted file systems? |
Select Yes to collect data for charts, graphs, and reports for mounted file systems. When selected, this script returns the percentage of used file system space, the percentage of available file system space, the used space (MB), and free space (MB). The default is unselected. |
|
Enable debugging? (y/n) |
Select Yes to enable debugging. The default is unselected. |