survivor: Nadisk Check Module

SURVIVOR: `nadisk` Check Module
About `nadisk` Dependencies Arguments Description Examples
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 Perl Modules `SNMP` ### 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.
1. ### 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 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