OVERVIEW
Dribbled collects and displays information about DRBD devices.
Dribbled is available as a Rubygem: gem install dribbled
SYNOPSIS
dribbled [] <action> []
Actions are one of show
, check
, snap
.
Options are as follows:
General options:
-D, --drbdadm DRBDADM Path to drbdadm binary
-P, --procdrbd PROCDRBD Path to /proc/drbd
-X, --xmldump XMLDUMP Path to output for drbdadm --dump-xml
-H, --hostname HOSTNAME Hostname
-d, --debug Enable debug mode
-a, --about Display dribbled information
-V, --version Display dribbled version
--help Show this messageSenedsa options
With no options or arguments, dribbled
displays help as shown above (unless called as check_drbd
; see Personalities).
PERSONALITIES
Dribbled has two personalities: when run as dribbled
, it behaves according to the action and parameters used; when run as check_drbd
, it assumes the check
action, which enables Nagios plugin behavior. (i.e., dribbled check
is equivalent to check_drbd
).
ACTIONS
Show
The show
action displays information about DRBD devices in the system. This action currently accepts no options.
gerir@boxie:~:dribbled show
0 r0 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd0 desthost /dev/drbd0
1 r1 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd1 desthost /dev/drbd1
5 r5 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd5 desthost /dev/drbd5
6 r6 SyncTarget [ 4%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
Check
The check
action enables Nagios plugin mode, in which a single line of output is produced on STDOUT
with the status of the devices.
gerir@boxie:~:dribbled check
warning: 6:cs:SyncTarget[4.6%%];ds:Inconsistent/UpToDate
gerir@boxie:~:dribbled check
warning: 6:cs:SyncTarget[4.6%%];ds:Inconsistent/UpToDate
Currently, there is no way to configure what constitutes alert conditions, but generally, a critical alert will be generated when a resource is found in non-Connected
and non-UpToDate
state, except when said resource is in SyncSource
, SyncTarget
, VerifyS
, VerifyT
, PausedSyncS
, PausedSyncT
, or StandAlone
connection state, which causes a warning. Also, resources that are Connected
and UpToDate
but missing from the configuration will generate a warning.
Both active and passive modes are supported, with the corresponding options:
Check Options
-M, --monitor [nagios] Monitoring system
-m, --mode [active|passive] Monitoring mode
-H, --nsca_hostname HOSTNAME NSCA hostname to send passive checks
-c, --config CONFIG Path to Senedsa (send_nsca) configuration
-S, --svc_descr SVC_DESR Nagios service description
-h, --hostname HOSTNAME Service hostname
As dribbled
uses Senedsa, configurations files are supported.
Snap
The snap
action is useful to capture raw data DRBD from a system for test and development. It produces two files, xmldump.
suffix and proddrbd.
suffix:
Snap Options
-S, --suffix SUFFIX Suffix (defaults to PID)
-D, --directory DIRECTORY Directory (defaults to /tmp)
These files can then be used with the general --procdrbd PROCDRBD
and --xmldump XMLDUMP
options:
gerir@boxie:~/dribbled -P data/procdrbd.wfconnection -X data/xmldump.wfconnection -H sourcehost show
0 r0 Connected UpToDate/UpToDate Primary/Secondary sourcehost /dev/drbd0 desthost /dev/drbd0
1 r1 Connected UpToDate/UpToDate Primary/Secondary sourcehost /dev/drbd1 desthost /dev/drbd1
12 r12 Connected UpToDate/UpToDate Primary/Secondary sourcehost /dev/drbd12 desthost /dev/drbd12
13 r13 WFConnection UpToDate/DUnknown Primary/Unknown
We use the general -H
option to let dribbled
know which host the commands were captured on (so that it can properly identify source and destination).