From 2770f91c0249a6af000d3614d71e3f5ed4850c1c Mon Sep 17 00:00:00 2001 From: "Hahn Axel (hahn)" <axel.hahn@unibe.ch> Date: Tue, 29 Aug 2023 14:54:55 +0200 Subject: [PATCH] update doc page --- docs/20_Checks/check_couchdb.md | 53 ++++++++++++++++++++++++++++----- 1 file changed, 46 insertions(+), 7 deletions(-) diff --git a/docs/20_Checks/check_couchdb.md b/docs/20_Checks/check_couchdb.md index b5fd688..43b05a4 100644 --- a/docs/20_Checks/check_couchdb.md +++ b/docs/20_Checks/check_couchdb.md @@ -18,7 +18,7 @@ Check couchdb status. ______________________________________________________________________ CHECK_COUCHDB -v0.3 +v0.4 (c) Institute for Medical Education - University of Bern Licence: GNU GPL 3 @@ -41,6 +41,7 @@ OPTIONS: MODE is one of up show general couchdb status replication show last replication status + pending show count of pending updates for nodes, dbs and users EXAMPLE: check_couchdb -m up @@ -80,10 +81,10 @@ It switches to critical if one of the seeds is not "ok". `check_couchdb -m up` returns ```txt -OK: Couchdb status (value in /_up is 'ok') -Reponse: +OK: Couchdb :: health status (value 'status' in /_up is 'ok') +Reponse of /_up: { - "status": "ok", <<< checked value + "status": "ok", "seeds": { "couchdb@192.168.25.172": { "timestamp": "2023-08-28T07:27:54.938619Z", @@ -97,8 +98,46 @@ Reponse: "couchdb@192.168.25.61": {} } } + ``` +### pending + +From url ``/up`` it fetches from seeds -> [node] -> pending_updates the values for + +* _nodes +* _dbs +* _users + +and summarizes its values. + +It switches to warning if one of the values is > 0. + +This check sends performance data. + +``check_couchdb -m pending`` returns + +```txt +OK: Couchdb :: pending updates: 0 (values below 'pending_updates' in /_up) +Reponse: of /_up +{ + "status": "ok", + "seeds": { + "couchdb@192.168.25.172": { + "timestamp": "2023-08-28T07:27:54.938619Z", + "last_replication_status": "ok", + "pending_updates": { + "_nodes": 0, + "_dbs": 0, + "_users": 0 + } + }, + "couchdb@192.168.25.61": {} + } +} + |nodes=0;; dbs=0;; users=0;; +``` + ### replication From url ``/up`` it fetches seeds -> [node] -> last_replication_status. @@ -107,14 +146,14 @@ It switches to critical if one of the seeds is not "ok". ``check_couchdb -m replication`` returns ```txt -OK: Couchdb replication -Reponse: +OK: Couchdb :: replication (values 'last_replication_status' in /_up are 'ok') +Reponse: of /_up { "status": "ok", "seeds": { "couchdb@192.168.25.172": { "timestamp": "2023-08-28T07:27:54.938619Z", - "last_replication_status": "ok", <<< checked value + "last_replication_status": "ok", "pending_updates": { "_nodes": 0, "_dbs": 0, -- GitLab