Documentation
StorageUtilization-Check
Reports the filers storage utilization.
Usage
$ check_netapp.pl StorageUtilization -H <hostname|IP> -u <user%pass> [--explore] | [-n <instance name>] [-X <instance name>] [...]
Description
This plugin retrieves several metrics about each aggregate and summarises them to provide an overview for the whole filer. Each metrics sum of all aggregates is returned as perf-data. The task of this plugin is to collect data, which can be used later to analyse and plan your storage. Metrics collected by this plugin are e.g. 'Space used by A-SIS metafiles', 'Total space used by aggregates metadata', 'Space used by aggregate snapshots', 'Total space allocated to volumes in the aggregate', ... This is not a check-plugin - so it will always return UNKNOWN or whatever you set using the command-line-switch '--return_code'. To see the data per aggregate, use --explore. Consider using -v for debugging, if you are not satisfied with the result.
Simple Examples
Note: The '-u' switch is missing in all the following examples, so the filer-credentials are taken from the default-file: '/usr/local/nagios/etc/netapp_credentials'
$ check_netapp StorageUtilization -H filer
Checks the filer. Returns the sum of all aggregates per metric.
$ check_netapp StorageUtilization -H filer -I ^a
Includes only aggregates if their name starts with 'a'.
$ check_netapp StorageUtilization -H filer -X bak$
Excludes any aggregate, which name ends with 'bak'.
$ check_netapp StorageUtilization -H filer --return_code=0
Returns 'OK' instead of 'UNKNOWN'. Again, this plugin does not check anything - it is just for trending.
Advanced Examples
Note: Host- and credential-arguments are omitted. So you have to fill in -H$ check_netapp StorageUtilization -H filer --explore
Shows a human-readable list of all metrics per aggregate.This may be used for further analysing the details if you find somthing strange or interesting in your performance-graphs.
$ check_netapp StorageUtilization -H filer -I ^abc -X bak$
Monitor all aggregates, whose name starts with 'abc' but does not end in 'bak'. Examples: 'abc' => included, 'xabc' => excluded, 'xxx' => excluded, 'abcdef' => included, 'abc.bak' => excluded, 'abcd.bak' => excluded Webtipp: http://netapp-monitoring.info/en/help/regex.html
$ check_netapp StorageUtilization -H filer -I ^aggr\d\d -X aggr4\[012]
Monitor aggr00, aggr01, ... aggr39 and aggr43, aggr44, ...aggr99 In other words: exclude 'aggr40', 'aggr41' and 'aggr42'
$ check_netapp StorageUtilization -H filer -I ^finance.* -I ^sales.* -X bak$
Monitor all aggregates from finance and sales, but exclude the backups.This example assumes a naming-convention, where the aggregates name starts with the departments name and backups have the string 'bak' at the end.
$ check_netapp StorageUtilization -H filer -o aggr -I project_a
Monitor all aggregates of project_a - any aggregate, whose name contains the string 'project_a'.
$ check_netapp StorageUtilization -H filer -I ^project_a$
Monitor the project_a-aggregate (singular!) - this is the same and should better be done by using the -n switch (-n project_a) in order to save ressources.
$ check_netapp StorageUtilization -H filer -X project_a
Monitor all aggregates, but not if their name contains 'project_a'
