Zbx-multicheck : un plugin puissant pour le logiciel de supervision Zabbix

Présentation du logiciel

zbx-multicheck est une extension logiciel de supervision Zabbix, qui simplifie l’intégration d’outils de vérification externes.

Zabbix est un logiciel libre concurrent direct de Nagios, de conception plus moderne, plus facile à paramétrer et avec des fonctionnalités avancée. Zbx-multicheck a été développé pour simplifier l’écriture et l’intégration de scripts et outils de check personnalisés dans Zabbix.

Téléchargement

Zbx-multicheck, ainsi que des exemples de fichiers de configuration, sont téléchargeables sur GitHub.

Documentation

Extrait de la documentation disponible en ligne de commande :

NAME

zabbix_multichecker - A tool used to execute a serie of Unix commands
and then parse the command’s output to create a number of Zabbix
"items". It then uses "zabbix_sender" to send the items back to the
Zabbix server.

SYNOPSIS

zbx_multicheck HOSTNAME [options]

HOSTNAME must be ’localhost’ if the script is running as a
UserParameter on a Zabbix Agent.

If running on the Zabbix Server, HOSTNAME must be the name of the agent
on behalf of which we’re running this script (as an External Script).

Options:

--agent-conf=FILE, -A FILE     Path to the Zabbix Agentd configuration file
--server-conf=FILE, -C FILE    Path to the Zabbix Server configuration file
--multichecker-conf=FILE, -M FILE      Path to zbx_multicheck's configuration file
--sender=FILE, -S FILE         Path of the zabbix_sender executable
--debug, -d                    Print more information (do not use in production!)
--help|-h                      Brief help message
--version|-v                   Print version and license
--man                          Full documentation

OPTIONS

--agent-conf=FILE|-A FILE
    Path of the Zabbix Agentd configuration file. This file is parsed
    to get the serveur name and port, and the local hostname. This
    parameter is only used if HOSTNAME is equal to ’localhost’.
    Defaults to ’/etc/zabbix/zabbix_agentd.conf’.

--server-conf=FILE|-C FILE
    Path of the Zabbix Server configuration file. This file is parsed
    to get the serveur name and port. This parameter is only used if
    HOSTNAME is not equal to ’localhost’.  Defaults to
    ’/etc/zabbix/zabbix_server.conf’.

--multichecker-conf=FILE|-M FILE
    Path of zabbix_multichecker’s configuration file. The file
    contains the commands to execute and the list of regexp/items for
    each command.  Defaults to ’/etc/zabbix/zbx_multicheck.conf’.

--sender=FILE|-S FILE
    Path of the "zabbix_sender" executable. Defaults to
    ’/usr/local/bin/zabbix_sender’.

--debug|-d
    Print more information on the execution of the script. Do not use
    in production as it disturb the output processing!

--help|-h
    Prints a brief help message and exits.

--man
    Prints the manual page and exists.

--version|-v
    Print program version and license.

DESCRIPTION

zbx_multicheck parses a specific configuration file and executes in a
shell the defined command.

A list of regular expression is then executed on the output, and each
corresponding match generates an item and its corresponding value. The
items are then returned back to the server with the zabbix_agentd
program.

This script can either run as a UserParameter on the agent (in which
case the first parameter must explicitely be ’localhost’), or as an
External Script on the server (in which case the first parameter is
automatically set to the agent we’re monitoring).

SAMPLE CONFIGURATION

Every occurrence of @HOSTNAME@ in the command line will be replaced by
the name of the computer for which we are calculating items.

Sample zbx_multicheck.conf:

# First command to execute and whose output we are going to parse
command = sudo mysqladmin status
# Each line defines a regular expression and an item corresponding to
# the first group of parentheses in the regexp.
item = /Uptime: (\d+)/, mysql.uptime
item = /Threads: (\d+)/, mysql.threads
item = /Questions: (\d+)/, mysql.questions
item = /Slow queries: (\d+)/, mysql.slowqueries
item = /Queries per second avg: (\d+\.?\d*)/, mysql.qps

# Second command and its set of items
command = sudo mysqladmin version
item = /^Server version\s*(.*)\s*$/, mysql.server-version
item = /^Protocol version\s*(.*)\s*$/, mysql.protocol-version

AUTHOR

Author: Farzad FARID ffarid@pragmatic-source.com

For more information or support check http://www.pragmatic-source.com/