)]}'
{"doc/source/operations/alerting.rst":[{"author":{"_account_id":17591,"name":"Steve Wilkerson","email":"wilkers.steve@gmail.com","username":"srwilkers"},"change_message_id":"c73c25dbe5bba571037313812520c72272114ac5","unresolved":false,"context_lines":[{"line_number":1,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":2,"context_line":"Alerting"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"Alerting using Nagios"},{"line_number":6,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"Once you have a running Ceph cluster, it is important for administrators to be notified in the event of a warning or error that occurs in the cluster."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Nagios Core is an open source solution for both monitoring and alerting. Large Ceph Storage clusters benefit from distributed monitoring systems such as Nagios Core that check each host in a cluster, including the health of the underlying operating system, as well as the health of the Ceph Storage Cluster daemons."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"Configuring Nagios for alerting is beyond the scope of this document, however, administrators should configure notification events based the available nagios ceph plugins listed below."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Nagios plugins for Ceph"},{"line_number":15,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"A collection of nagios plugins to monitor a [Ceph] cluster."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Authentication"},{"line_number":20,"context_line":"~~~~~~~~~~~~~~"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Ceph is normally configured to use [cephx] to authenticate its client."},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"To run the check_ceph_health or other plugins as user nagios you have to create a special keyring:"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"::"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"    kubectl -n ceph exec -it ${MON_POD}  ceph auth get-or-create client.nagios mon \u0027allow r\u0027 \u003e ceph.client.nagios.keyring"},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"And use this keyring with the plugin:"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"::"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"    nagios$ ./check_ceph_health --id nagios --keyring ceph.client.nagios.keyring"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"check_ceph_health"},{"line_number":37,"context_line":"~~~~~~~~~~~~~~~~~"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"The check_ceph_health nagios plugin monitors the ceph cluster, and report its health."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Usage"},{"line_number":42,"context_line":"~~~~~"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"::"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"    check_ceph_health [-h] [-e EXE] [-c CONF] [-m MONADDRESS] [-n NAME] [-i ID] [-k KEYRING] [-w WHITELIST] [-d]"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"**ceph health** nagios plugin."},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":52,"context_line":"| Optional argument                      | Definition                                 |"},{"line_number":53,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":54,"context_line":"| -h, --help                             | show this help message and exit            |"},{"line_number":55,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":56,"context_line":"| -e EXE, --exe EXE                      | ceph executable [/usr/bin/ceph]            |"},{"line_number":57,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":58,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                 |"},{"line_number":59,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":60,"context_line":"| -m MONADDRESS, --monaddress MONADDRESS | ceph monitor address[:port]                |"},{"line_number":61,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":62,"context_line":"| -i ID, --id ID                         | ceph client id                             |"},{"line_number":63,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":64,"context_line":"| -n NAME, --name NAME                   | ceph client name                           |"},{"line_number":65,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":66,"context_line":"| -k KEYRING, --keyring KEYRING          | ceph client keyring file                   |"},{"line_number":67,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":68,"context_line":"| -w, --whitelist REGEXP                 | whitelist regexp for ceph health warnings  |"},{"line_number":69,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":70,"context_line":"| -d, --detail                           | exec \u0027ceph health detail\u0027                  |"},{"line_number":71,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Example"},{"line_number":74,"context_line":"~~~~~~~"},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"::"},{"line_number":77,"context_line":""},{"line_number":78,"context_line":"    nagios$ ./check_ceph_health --name client.nagios --keyring ceph.client.nagios.keyring"},{"line_number":79,"context_line":"    HEALTH WARNING: 1 pgs degraded; 1 pgs recovering; 1 pgs stuck unclean; recovery 4448/28924462 degraded (0.015%); 2/9857830 unfound (0.000%);"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"    nagios$ echo $?"},{"line_number":82,"context_line":"    1"},{"line_number":83,"context_line":"    nagios$ ./check_ceph_health --id nagios --whitelist \u0027requests.are.blocked(\\s)*32.sec\u0027"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"check_ceph_mon"},{"line_number":86,"context_line":"~~~~~~~~~~~~~~"},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"The check_ceph_mon nagios plugin monitors an individual mon daemon, reporting its status."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Possible result includes OK (up), WARN (missing)."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Usage"},{"line_number":93,"context_line":"~~~~~"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"::"},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"    check_ceph_mon [-h] [-e EXE] [-c CONF] [-m MONADDRESS] [-i ID] [-k KEYRING] [-V] [-I MONID]"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"**ceph quorum_status** nagios plugin."},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":103,"context_line":"| Optional argument                      | Definition                                 |"},{"line_number":104,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":105,"context_line":"| -h, --help                             | show this help message and exit            |"},{"line_number":106,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":107,"context_line":"| -e EXE, --exe EXE                      | ceph executable [/usr/bin/ceph]            |"},{"line_number":108,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":109,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                 |"},{"line_number":110,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":111,"context_line":"| -m MONADDRESS, --monaddress MONADDRESS | ceph monitor address[:port]                |"},{"line_number":112,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":113,"context_line":"| -i ID, --id ID                         | ceph client id                             |"},{"line_number":114,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":115,"context_line":"| -I MONID, --monid MONID                | mon ID to be checked for availability      |"},{"line_number":116,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":117,"context_line":"| -k KEYRING, --keyring KEYRING          | ceph client keyring file                   |"},{"line_number":118,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":119,"context_line":"| -v, --version                          | show version and exit                      |"},{"line_number":120,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"Example"},{"line_number":123,"context_line":"~~~~~~~"},{"line_number":124,"context_line":""},{"line_number":125,"context_line":"::"},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"    nagios$ ./check_ceph_mon -I node1"},{"line_number":128,"context_line":"    MON OK"},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"    nagios$ ./check_ceph_mon --monid node2"},{"line_number":131,"context_line":"    MON WARN: no mon \u0027node2\u0027 found in quorum"},{"line_number":132,"context_line":""},{"line_number":133,"context_line":"check_ceph_osd"},{"line_number":134,"context_line":"~~~~~~~~~~~~~~"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"The check_ceph_osd nagios plugin monitors an individual osd daemon or host, reporting its status."},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"Possible result includes OK (up), WARN (down or missing)."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"Usage"},{"line_number":141,"context_line":"~~~~~"},{"line_number":142,"context_line":""},{"line_number":143,"context_line":"::"},{"line_number":144,"context_line":""},{"line_number":145,"context_line":"    usage: check_ceph_osd [-h] [-e EXE] [-c CONF] [-m MONADDRESS] [-i ID] [-k KEYRING] [-V] -H HOST [-I OSDID] [-o]"},{"line_number":146,"context_line":""},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"**ceph osd** nagios plugin."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":151,"context_line":"| Optional argument                      | Definition                                 |"},{"line_number":152,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":153,"context_line":"| -h, --help                             | show this help message and exit            |"},{"line_number":154,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":155,"context_line":"| -e EXE, --exe EXE                      | ceph executable [/usr/bin/ceph]            |"},{"line_number":156,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":157,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                 |"},{"line_number":158,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":159,"context_line":"| -m MONADDRESS, --monaddress MONADDRESS | ceph monitor address[:port]                |"},{"line_number":160,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":161,"context_line":"| -H HOST, --host HOST                   | osd host                                   |"},{"line_number":162,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":163,"context_line":"| -i ID, --id ID                         | ceph client id                             |"},{"line_number":164,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":165,"context_line":"| -I OSDID, --osdid OSDID                | osd id                                     |"},{"line_number":166,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":167,"context_line":"| -k KEYRING, --keyring KEYRING          | ceph client keyring file                   |"},{"line_number":168,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":169,"context_line":"| -o, --out                              | check osds that are set OUT                |"},{"line_number":170,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":171,"context_line":"| -V, --version                          | show version and exit                      |"},{"line_number":172,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"Example"},{"line_number":175,"context_line":"~~~~~~~"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"::"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"    nagios$ ./check_ceph_osd -H xxx.xx.xxx.xxx -I 0"},{"line_number":180,"context_line":"    OSD OK"},{"line_number":181,"context_line":""},{"line_number":182,"context_line":"    nagios$ ./check_ceph_osd -H xxx.xx.xxx.xxx -I 0"},{"line_number":183,"context_line":"    OSD WARN: OSD.0 is down at xxx.xx.xxx.xxx"},{"line_number":184,"context_line":""},{"line_number":185,"context_line":"    nagios$ ./check_ceph_osd -H xxx.xx.xxx.xxx -I 100"},{"line_number":186,"context_line":"    OSD WARN: no OSD.100 found at host xxx.xx.xxx.xxx"},{"line_number":187,"context_line":""},{"line_number":188,"context_line":"    nagios$ ./check_ceph_osd -H xxx.xx.xxx.xxx"},{"line_number":189,"context_line":"    OSD WARN: Down OSD on xxx.xx.xxx.xxx: osd.0"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"check_ceph_rgw"},{"line_number":192,"context_line":"~~~~~~~~~~~~~~"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"The check_ceph_rgw nagios plugin monitors a ceph rados gateway, reporting its status and buckets usage."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"Possible result includes OK (up), WARN (down or missing)."},{"line_number":197,"context_line":""},{"line_number":198,"context_line":"Usage"},{"line_number":199,"context_line":"~~~~~"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"::"},{"line_number":202,"context_line":""},{"line_number":203,"context_line":"    check_ceph_rgw [-h] [-d] [-B] [-e EXE] [-c CONF] [-i ID] [-V]"},{"line_number":204,"context_line":""},{"line_number":205,"context_line":""},{"line_number":206,"context_line":"**radosgw-admin bucket stats** nagios plugin."},{"line_number":207,"context_line":""},{"line_number":208,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":209,"context_line":"| Optional argument                      | Definition                                                   |"},{"line_number":210,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":211,"context_line":"| -h, --help                             | show this help message and exit                              |"},{"line_number":212,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":213,"context_line":"| -e EXE, --exe EXE                      | radosgw-admin executable [/usr/bin/radosgw-admin]            |"},{"line_number":214,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":215,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                                   |"},{"line_number":216,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":217,"context_line":"| -d, --detail                           | output perf data for all buckets                             |"},{"line_number":218,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":219,"context_line":"| -B, --byte                             | output perf data in Byte instead of KB                       |"},{"line_number":220,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":221,"context_line":"| -i ID, --id ID                         | ceph client id                                               |"},{"line_number":222,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":223,"context_line":"| -n NAME, --name NAME                   | ceph client name                                             |"},{"line_number":224,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":225,"context_line":"| -V, --version                          | show version and exit                                        |"},{"line_number":226,"context_line":"+----------------------------------------+--------------------------------------------------------------+"},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"Example"},{"line_number":229,"context_line":"~~~~~~~"},{"line_number":230,"context_line":""},{"line_number":231,"context_line":"::"},{"line_number":232,"context_line":""},{"line_number":233,"context_line":"    nagios$ ./check_ceph_rgw RGW OK: 4 buckets, 102276 KB total | /\u003d102276KB"},{"line_number":234,"context_line":""},{"line_number":235,"context_line":"    nagios$ ./check_ceph_rgw --detail --byte RGW OK: 4 buckets, 102276 KB total | /\u003d104730624B bucket-test1\u003d151552B bucket-test0\u003d12288B bucket-test2\u003d104566784B bucket-test\u003d0B"},{"line_number":236,"context_line":""},{"line_number":237,"context_line":"check_ceph_rgw_api"},{"line_number":238,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":239,"context_line":""},{"line_number":240,"context_line":"The check_ceph_rgw_api nagios plugin monitors a ceph rados gateway, reporting its status and buckets usage."},{"line_number":241,"context_line":""},{"line_number":242,"context_line":"It is important to note the difference between check_ceph_rgw_api and check_ceph_rgw. check_ceph_rgw is designed to connect to the cluster while check_ceph_rgw_api is connected to radosgw directly via [admin api]. You can check each instance of radosgw or only one endpoint via proxy/balancer (or both)."},{"line_number":243,"context_line":""},{"line_number":244,"context_line":"*Possible results*"},{"line_number":245,"context_line":"~~~~~~~~~~~~~~~~~~"},{"line_number":246,"context_line":""},{"line_number":247,"context_line":"* OK - bucket info recieved from radosgw"},{"line_number":248,"context_line":"* WARNING - connected, but wrong admin entry or usage caps"},{"line_number":249,"context_line":"* UNKNOWN - can\u0027t connect to proxy/balancer or radosgw directly"},{"line_number":250,"context_line":""},{"line_number":251,"context_line":"*Requirements*"},{"line_number":252,"context_line":"~~~~~~~~~~~~~~"},{"line_number":253,"context_line":""},{"line_number":254,"context_line":"1. Install [requests-aws](//github.com/tax/python-requests-aws) python library: ` pip install requests-aws `"},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"2. Configure admin entry point (default is \u0027admin\u0027): ` rgw admin entry \u003d \"admin\" `"},{"line_number":257,"context_line":""},{"line_number":258,"context_line":"3. Enable admin API (default is enabled): ` rgw enable apis \u003d \"s3, admin\" `"},{"line_number":259,"context_line":""},{"line_number":260,"context_line":"4. Add capability buckets\u003dread for your user who performed checks, see"},{"line_number":261,"context_line":""},{"line_number":262,"context_line":"Usage"},{"line_number":263,"context_line":"~~~~~"},{"line_number":264,"context_line":""},{"line_number":265,"context_line":"::"},{"line_number":266,"context_line":""},{"line_number":267,"context_line":"    check_ceph_rgw_api [-h] -H HOST [-k] [-e ADMIN_ENTRY] -a ACCESS_KEY -s SECRET_KEY [-d] [-b] [-v]"},{"line_number":268,"context_line":""},{"line_number":269,"context_line":""},{"line_number":270,"context_line":"**radosgw api bucket stats** nagios plugin."},{"line_number":271,"context_line":""},{"line_number":272,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":273,"context_line":"| Optional argument                         | Definition                                                              |"},{"line_number":274,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":275,"context_line":"| -h, --help                                | show this help message and exit                                         |"},{"line_number":276,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":277,"context_line":"| -H HOST, --host HOST                      | Server URL for the radosgw api (example: http://objects.dreamhost.com/) |"},{"line_number":278,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":279,"context_line":"| -k, --insecure                            | Allow insecure server connections when using SSL                        |"},{"line_number":280,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":281,"context_line":"| -e ADMIN_ENTRY, --admin_entry ADMIN_ENTRY | The entry point for an admin request URL [default is \u0027admin\u0027]           |"},{"line_number":282,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":283,"context_line":"| -a ACCESS_KEY, --access_key ACCESS_KEY    | S3 access key                                                           |"},{"line_number":284,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":285,"context_line":"| -s SECRET_KEY, --secret_key SECRET_KEY    | S3 secret key                                                           |"},{"line_number":286,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":287,"context_line":"| -d, --detail                              | output perf data for all buckets                                        |"},{"line_number":288,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":289,"context_line":"| -b, --byte                                | output perf data in Byte instead of KB                                  |"},{"line_number":290,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":291,"context_line":"| -v, --version                             | show version and exit                                                   |"},{"line_number":292,"context_line":"+-------------------------------------------+-------------------------------------------------------------------------+"},{"line_number":293,"context_line":""},{"line_number":294,"context_line":""},{"line_number":295,"context_line":"Example"},{"line_number":296,"context_line":"~~~~~~~"},{"line_number":297,"context_line":""},{"line_number":298,"context_line":"::"},{"line_number":299,"context_line":""},{"line_number":300,"context_line":"    nagios$ ./check_ceph_rgw_api -H https://objects.dreamhost.com/ -a JXUABTZZYHAFLCMF9VYV -s jjP8RDD0R156atS6ACSy2vNdJLdEPM0TJQ5jD1pwRGW OK: 1 buckets, 7696 KB total  /\u003d7696KB"},{"line_number":301,"context_line":""},{"line_number":302,"context_line":"    nagios$ ./check_ceph_rgw_api -H objects.dreamhost.com -a JXUABTZZYHAFLCMF9VYV -s jjP8RDD0R156atS6ACSy2vNdJLdEPM0TJQ5jD1pw --detail --byteRGW OK: 1 buckets, 7696 KB total  /\u003d7880704B k0ste\u003d7880704B"},{"line_number":303,"context_line":""},{"line_number":304,"context_line":"check_ceph_df"},{"line_number":305,"context_line":"~~~~~~~~~~~~~"},{"line_number":306,"context_line":""},{"line_number":307,"context_line":"The check_ceph_df nagios plugin monitors a ceph cluster, reporting its percentual RAW capacity usage, or specific pool usage."},{"line_number":308,"context_line":""},{"line_number":309,"context_line":"Possible result includes OK, WARN, and CRITICAL."},{"line_number":310,"context_line":""},{"line_number":311,"context_line":"Usage"},{"line_number":312,"context_line":"~~~~~"},{"line_number":313,"context_line":""},{"line_number":314,"context_line":"::"},{"line_number":315,"context_line":""},{"line_number":316,"context_line":"    check_ceph_df [-h] [-e EXE] [-c CONF] [-m MONADDRESS] [-i ID] [-n NAME] [-k KEYRING] [-d] [-W WARN] [-C CRITICAL] [-V]"},{"line_number":317,"context_line":""},{"line_number":318,"context_line":""},{"line_number":319,"context_line":"**ceph df** nagios plugin."},{"line_number":320,"context_line":""},{"line_number":321,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":322,"context_line":"| Optional argument                      | Definition                                 |"},{"line_number":323,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":324,"context_line":"| -h, --help                             | show this help message and exit            |"},{"line_number":325,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":326,"context_line":"| -e EXE, --exe EXE                      | ceph executable [/usr/bin/ceph]            |"},{"line_number":327,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":328,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                 |"},{"line_number":329,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":330,"context_line":"| -m MONADDRESS, --monaddress MONADDRESS | ceph monitor address[:port]                |"},{"line_number":331,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":332,"context_line":"| -n NAME, --name NAME                   | ceph client name                           |"},{"line_number":333,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":334,"context_line":"| -i ID, --id ID                         | ceph client id                             |"},{"line_number":335,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":336,"context_line":"| -p POOL, --pool POOL                   | ceph pool name                             |"},{"line_number":337,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":338,"context_line":"| -k KEYRING, --keyring KEYRING          | ceph client keyring file                   |"},{"line_number":339,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":340,"context_line":"| -d, --detail                           | show pool details on warn and critical     |"},{"line_number":341,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":342,"context_line":"| -W WARN, --warn WARN                   | warn above this percent RAW USED           |"},{"line_number":343,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":344,"context_line":"| -C CRITICAL, --critical CRITICAL       | critical alert above this percent RAW USED |"},{"line_number":345,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":346,"context_line":"| -V, --version                          | show version and exit                      |"},{"line_number":347,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":348,"context_line":""},{"line_number":349,"context_line":"Example"},{"line_number":350,"context_line":"~~~~~~~"},{"line_number":351,"context_line":""},{"line_number":352,"context_line":"::"},{"line_number":353,"context_line":""},{"line_number":354,"context_line":"    nagios$ ./check_ceph_df -i nagios -k /etc/ceph/ceph.client.nagios.keyring -W 29.12 -C 30.22 -d"},{"line_number":355,"context_line":"    RAW usage 28.36%"},{"line_number":356,"context_line":""},{"line_number":357,"context_line":"    nagios$ ./check_ceph_df -i nagios -k /etc/ceph/ceph.client.nagios.keyring -W 26.14 -C 30"},{"line_number":358,"context_line":"    WARNING: global RAW usage of 28.36% is above 26.14% (783G of 1093G free)"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":"    nagios$ ./check_ceph_df -i nagios -k /etc/ceph/ceph.client.nagios.keyring -W 60 -C 70 -p hdd"},{"line_number":361,"context_line":"    CRITICAL: Pool \u0027hdd\u0027 usage of 71.71% is above 70.0% (9703G used)"},{"line_number":362,"context_line":""},{"line_number":363,"context_line":"    nagios$ ./check_ceph_df -i nagios -k /etc/ceph/ceph.client.nagios.keyring -W 60 -C 70 -p nvme"},{"line_number":364,"context_line":"    CRITICAL: Pool \u0027nvme\u0027 usage of 76.08% is above 70.0% (223G used)"},{"line_number":365,"context_line":""},{"line_number":366,"context_line":"    nagios$ ./check_ceph_df -i nagios -k /etc/ceph/ceph.client.nagios.keyring -W 26.14 -C 30 -d"},{"line_number":367,"context_line":"    WARNING: global RAW usage of 28.36% is above 26.14% (783G of 1093G free)"},{"line_number":368,"context_line":""},{"line_number":369,"context_line":"     POOLS:"},{"line_number":370,"context_line":"         NAME                ID     USED       %USED     MAX AVAIL     OBJECTS"},{"line_number":371,"context_line":"         rbd                 0      96137M      8.59          348G       24441"},{"line_number":372,"context_line":"         cephfs_data         1      61785M      5.52          348G       99940"},{"line_number":373,"context_line":"         cephfs_metadata     2      40380k         0          348G        8037"},{"line_number":374,"context_line":"         libvirt-pool        3         145         0          348G           2"},{"line_number":375,"context_line":""},{"line_number":376,"context_line":"check_ceph_mgr"},{"line_number":377,"context_line":"~~~~~~~~~~~~~~"},{"line_number":378,"context_line":""},{"line_number":379,"context_line":"The check_ceph_mgr nagios plugin monitors the manager."},{"line_number":380,"context_line":""},{"line_number":381,"context_line":"Usage"},{"line_number":382,"context_line":"~~~~~"},{"line_number":383,"context_line":""},{"line_number":384,"context_line":"::"},{"line_number":385,"context_line":""},{"line_number":386,"context_line":"    check_ceph_mgr [-h] [-e EXE] [-c CONF] [-m MONADDRESS] [-i ID][-n NAME] [-k KEYRING] [-V]"},{"line_number":387,"context_line":""},{"line_number":388,"context_line":""},{"line_number":389,"context_line":"**ceph mgr dump** nagios plugin."},{"line_number":390,"context_line":""},{"line_number":391,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":392,"context_line":"| Optional argument                      | Definition                                 |"},{"line_number":393,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":394,"context_line":"| -h, --help                             | show this help message and exit            |"},{"line_number":395,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":396,"context_line":"| -e EXE, --exe EXE                      | ceph executable [/usr/bin/ceph]            |"},{"line_number":397,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":398,"context_line":"| -c CONF, --conf CONF                   | alternative ceph conf file                 |"},{"line_number":399,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":400,"context_line":"| -m MONADDRESS, --monaddress MONADDRESS | ceph monitor address[:port]                |"},{"line_number":401,"context_line":"+----------------------------------------+--------------------------------------------+"},{"line_number":402,"context_line":""},{"line_number":403,"context_line":"Example"},{"line_number":404,"context_line":"~~~~~~~"},{"line_number":405,"context_line":""},{"line_number":406,"context_line":"::"},{"line_number":407,"context_line":""},{"line_number":408,"context_line":"    nagios$ ./check_ceph_mgr"},{"line_number":409,"context_line":"    MGR OK: active: zhdk0013, standbys: zhdk0009, zhdk0025"},{"line_number":410,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_d26668f1","line":409,"range":{"start_line":1,"start_character":0,"end_line":409,"end_character":58},"updated":"2018-11-30 15:43:48.000000000","message":"The nagios chart we use does not contain these plugins. Furthermore, this appears to be a direct rip from the ceph-nagios-plugins here: https://github.com/ceph/ceph-nagios-plugins. Why not just point to those docs instead?","commit_id":"a5205034028efa6ac8cc823d7cb147fa8c4cdef2"}]}