check_freenas

                                

        
        

            
            

                

    

    
check_freenas


Coindrop.to me Support goes 100% to local animal hospice


FreeNAS Naemon/Icinga/Nagios plugin.


[[TOC]]


Requirements


    

  • 

    Ruby >2.3
    

    • 

  • 

    Some checks are executed via SSH (see below). For this the net-ssh gem is necessary.
    

    gem install net-ssh
    

    • 



Options


    

  • -s, -H: FreeNAS host, freenas.example.com, mandatory
    • 

  • -u: username, mandatory
    • 

  • -k: if you've a self signed cert
    • 

  • -z: zpool name
    • 

  • -d: dataset name
    • 

  • -i: include (regex)
    • 

  • -x: exclude (regex)
    • 

  • --unit: to specify desired unit output - kb, mb, gb, tb. if not specifed uses 'mb'
    • 



Modes


API


Following checks are performed via the FreeNAS API (v2.0). Only https and user root is possible.


Alerts


Check outstanding alerts.


./check_freenas.rb -s freenas.example.com -u root -p  [-k] -m alerts
Warning - smartd is not running


Updates


Notifies of available updates.


./check_freenas.rb -s freenas.example.com -u root -p  [-k] -m updates
Warning - There are pending updates. Go to System > Update to apply pending updates


Datasets usage


Check used space of all datasets (including subdatasets) with perfdata. Optional parameter --unit can be specified.
Use include/exclude option to limit output.


./check_freenas.rb -s freenas.example.com -u root -p  [-k] -m datasets_usage -z tank -i '^(data|home)' -w 1176000 -c 1185555
Warning - Dataset data used 1176133MB | home=910786MB;1176000;1185555 data=1176133MB;1176000;1185555


Datasets quota usage


Check used space of all datasets where refquota is defined. Output will be in percentage (float) with perfdata.


./check_freenas.rb -s freenas.example.com -u  -p  -m datasets_quota_usage -z tank -w 90 -c 95
OK - tank/projects: usage 19.64%, tank/data: usage 82.98% | tank/projects=19.64%;90;95 tank/data=82.98%;90;95


Zpool usage


Checks Zpool usage in percentage with perfdata.


./check_freenas.rb -s freenas.example.com -u root -p  [-k] -m zpool_usage -z tank -w 30 -c 40
OK - tank: usage 60% | tank=60%;70;80


SSH


Following checks are performed through SSH via net-ssh to the FreeNAS host.
SSH connection is initiated from the host who executes the plugin.


ARC Cache


Checks various kstat values. Output will be in percentage (float) with perfdata.


Miss ratio


./check_freenas.rb -s freenas.example.com -u  -p  -m arc_cache_miss_ratio -w 60 -c 70
Critical - ARC cache miss ratio: 70.72% | arc_cache_miss_ratio=70.72%;60;70


Metadata usage


./check_freenas.rb -s freenas.example.com -u  -p  -m arc_cache_meta_usage -w 60 -c 70
OK - ARC cache metadata usage: 19.61% | arc_cache_meta_usage=19.61%;60;70


MRU ghost hits


./check_freenas.rb -s freenas.example.com -u  -p  -m arc_cache_mru_ghost -w 10 -c 15
OK - ARC cache mru ghost hits: 0.02% | arc_cache_mru_ghost=0.02%;10;15


MFU ghost hits


./check_freenas.rb -s freenas.example.com -u  -p  -m arc_cache_mfu_ghost -w 10 -c 15
OK - ARC cache mfu ghost hits: 2.46% | arc_cache_mfu_ghost=2.46%;10;15


IO requests pending


Checks pending io in queue via gstat from all physical disks that are at least 0.1% busy.


./check_freenas.rb -s freenas.example.com -u  -p  -m io_requests_pending -w 5 -c 10
OK - ada0: 0, da0: 0, da18: 0, da22: 0, da24: 0, da25: 0, da27: 1, da28: 0, da30: 0, da32: 0, da33: 0 | ada0=0;5;10 da0=0;5;10 da18=0;5;10 da22=0;5;10 da24=0;5;10 da25=0;5;10 da27=1;5;10 da28=0;5;10 da30=0;5;10 da32=0;5;10 da33=0;5;10


Disk busy


Checks disk busy value via gstat from all physical disks that are at least 0.1% busy.


./check_freenas.rb -s freenas.example.com -u  -p  -m disk_busy -w 40 -c 50
OK - ada0: 0.3%, da0: 0.3%, da21: 1.6%, da22: 0.6%, da25: 1.7%, da26: 3.1%, da28: 1.3%, da30: 1.3%, da31: 0.5%, da33: 1.0% | ada0=0.3%;40;50 da0=0.3%;40;50 da21=1.6%;40;50 da22=0.6%;40;50 da25=1.7%;40;50 da26=3.1%;40;50 da28=1.3%;40;50 da30=1.3%;40;50 da31=0.5%;40;50 da33=1.0%;40;50


Zpool IOPS


Checks read/write IOPS via zpool iostat command (value rounded).


./check_freenas.rb -s freenas.example.com -u  -p  -m zpool_iostat_read_iops -z  -w 400 -c 500
Critical - Read IOPS: 514.0 | read_iops=514.0;30;50


Zpool Bandwith


Checks read/write bandwith in MB via zpool iostat command (value rounded).


./check_freenas.rb -s freenas.example.com -u  -p  -m zpool_iostat_write_bw -z  -w 30 -c 50
OK - Write bandwith: 10.6MB | write_bw=10.6MB;30;50