NetApp Monitoring

Documentation

ReportSpace-Check

Reports used space on all volumes for a given tenant.

Usage

$ check_netapp_pro.pl ReportSpace -H <host> [--svm=<svm> | --vol=<regex>] [-w <n> -c <n>] [--help] [...]

Description

This plugin summarizes the used space on all volumes which are assigned to a given tenant.

How to assign a volume to a tenant?

  • Method 1: Assign a whole storage virtual machine (SVM) with --svm=<svm-name>. All volumes owned by that SVM will be considered by the report.

  • Method 2: Name volumes so that they can be selected by one or more regular expressions. Typically the volume-name should contain the tenants short-name. Given such a naming-convention the tenants volumes can be selected with the argument --vol=<regex>. This argument can be repeated. This allows also to explicitly select the volumes name by name (e.g. --vol=^vol1$ --vol=^vol25$ ).

Independent from these assignments volumes can be excluded using --exclude=<regex> (--include is not supported by this check since it would be redundant with --vol).

EXAMPLES

# Select all volumes owned by the comp-a SVM
--svm=comp-a

# Select all volumes owned by the comp-a SVM, but exclude vol0
--svm=comp-a --exclude=^vol0$

# Select all volumes whose name **ends** with '_comp-b'
--vol=_comp-b$

# Select all volumes whose name **starts** with 'comp-b'
--vol=^comp-b

Offline or restricted volumes can not, by definition, be checked and will be skipped.

Example output if offline- or restricted volumes exist:

NETAPP OK - 30 volumes checked. [...]
3 volumes skipped
[...]

Performance-data will be printed for each of the checked volumes plus the sum of all volumes.

Consider using -v for inspection, if you are not satisfied with the result.

Dependencies

This check reads its data from a local store. The collector-scripts (also known as "getters") building these stores must have been run already for the volume object - otherwise this check will not find any data. See the documentation and cfg-example-files which came with this script.

Simple Examples

[S1] ./check_netapp_pro.pl ReportSpace -H filer --svm=comp-a -w 10000 -c 30000

Checks all volumes on the comp-a SVM. Sends a warning if the sum of of all volumes used size is above 10000 GiB or a critical alarm if over 30000 GiB.


NETAPP WARNING - 3 volumes checked, total sum 11036.8 GiB
vol_02: 2345.6 GiB
vol_03: 3345.6 GiB
vol_10: 5345.6 GiB
summary: 11036.8 GiB
# vol_0, vol_03 and vol_10 are owned by the SVM comp-a, all other volumes
# on filer are skipped.
[S2] ./check_netapp_pro.pl ReportSpace -H filer --svm=comp-a -w 10000 -c 30000 --factor=Gi

Same as above but explicitly naming the SI-factor Gi (binary Giga is the default).

[S3] ./check_netapp_pro.pl ReportSpace -H filer --vol=^comp-a_vol -w 10000 -c 30000

Checks all volumes whose name starts with 'comp-a_vol' regardless of the owning SVM.


NETAPP WARNING - 3 volumes checked, total sum 11036.8 GiB
comp-a_vol_02: 2345.6 GiB
comp-a_vol_03: 3345.6 GiB
comp-a_vol_10: 5345.6 GiB
summary: 11036.8 GiB
[S4] ./check_netapp_pro.pl ReportSpace -H filer --list=comp-a.txt -w 10000 -c 30000

Checks all volumes listed in comp-a.txt regardless of the owning SVM or volume-name. (planned feature, not yet implemented!)


NETAPP WARNING - 3 volumes checked, total sum 11036.8 GiB
some_vol: 2345.6 GiB
other_vol_03: 3345.6 GiB
third_vol: 5345.6 GiB
summary: 11036.8 GiB

Advanced Examples

Hint: The input for advanced examples is shortend. Replace the '...' below with ‑H <your filers ip or host-name>

[A1] ./check_netapp_pro.pl ReportSpace ... --svm=comp-a --metric=inodes -w 5 -c 9 --factor=k

Check the inodes on all comp-a volumes. Warn if more than 5000 inodes are in use for comp-a and send a critical-alarm if more than 9000 are occupied by comp-a.

[A2] ./check_netapp_pro.pl ReportSpace ... --svm=comp-a -X ^(_root|vol0)$

Excludes the _root-volume and 'vol0'.

[A3] ./check_netapp_pro.pl ReportSpace ... --svm=comp-a -X ^_root$ -X ^vol0$

Same as above but an other syntax. (Excludes the _root-volume and 'vol0'.)

© Copyright 2009-2023 Ingo Lantschner • Phone: +43-664-143 84 18 • contact@netapp-monitoring.info • en/help/ReportSpace.html • last update: 2023-03-07