zbx-multicheck

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 14 Open GitHub ↗

Execute multiple commands and send multiple values to Zabbix with a single call

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Documentation

This is the online documentation printed by the script when run as:
    zbx_multicheck --man

### 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/>

zbx-multicheck

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README