SURVIVOR: nadisk Check Module
About nadisk
basics
Module Type Scheduler Remote
check Yes No
syntax 
     module nadisk {
       [community <string>]
       examine <flags>
       [warn <number>]
       [prob <number>]
       [diskcf <file>]
       [filesystem <directory>]
       [filesystem ...]
       [snmpversion (1 | 2 | 2c | 3)]
       [snmptimeout <number>]
     }

Dependencies

Arguments

Name Type Value
community optional string, default 'public' Community name required by the SNMP daemon.
examine required flags, any of 'q', 'v', 's' q to examine quota trees, v to examine regular volumes, and s to examine .snapshot volumes. One of q and v must be specified. v must be specified in order to use s.
warn optional number between 0 and 101, default is 101 Minimum in-use percentage that will generate a warning.
prob optional number between 0 and 101, default is 101 Minimum in-use percentage that will generate a problem.
diskcf optional file Control file containing filesystems and thresholds to use (instead of warn and prob). The file has the same format (and indeed may be the same file) as the control file used by the disk check module.
filesystem optional directory list Filesystem(s) (not a regex) to be checked. If no filesystem is specified, then all filesystems will be checked.
snmpversion optional string, one of '1', '2','2c', or '3', default is '1' SNMP protocol version to use.
snmptimeout optional number between 1 and infinity, default is '5' SNMP query timeout, in seconds. Note that multiple queries may be issued within one check, so this should not be the same as the module timeout.

Description

The nadisk module determines how close to capacity volumes and quota trees are on the Network Appliance server to be checked. The module uses the Perl SNMP module to determine the percentage of capacity in use for each volume and/or quota tree.

Important: All quota trees must be listed together (sequentially) in the NetApp quotas file, preferably at the beginning of the file. For performance reasons, this module will stop reading SNMP results after a quota tree entry is followed by a non-quota tree entry (to prevent the slow parsing of thousands of user quotas).

It may be useful to set result text significant for nadisk checks. This will clear an existing acknowledgement when the summary text changes, for example when a filesystem's usage changes, or a different filesystem begins to fill up.

Examples

  1. To examine quota trees and regular volumes, generating warnings at 80% and problems at 90%: 
         module nadisk {
       community mycommunity
       examine qv
       warn 80
       prob 90
     }
  2. To use a control file and examine quota trees and snapshot volumes: 
         module nadisk {
       community mycommunity
       examine vs
       diskcf /etc/survivor/disk.cf
     }
  3. To generate a warning when the quota tree /users reachs 90% and a problem at 95%: 
         module nadisk {
       community mycommunity
       examine q
       warn 90
       prob 95
       filesystem /users
     }
$Date: 2007/02/11 02:09:00 $
$Revision: 0.11 $
 keywords
community
diskcf
examine
filesystem
prob
snmptimeout
snmpversion
warn