10 User Parameters
Functionality of Zabbix agents can be enhanced by defining user parameters (UserParameter configuration parameter) in agent's configuration file. Once user parameters are defined, they can be accessed in the same way as any other agent items by using the key, specified in the parameter definition.
User parameters are commands executed by Zabbix agent. /bin/sh is used as a command line interpreter under UNIX operating systems.
See a step-by-step tutorial on making use of user parameters.
1 Simple user parameters
In order to define a new parameter for monitoring, one line has to be added to configuration file of Zabbix agent and the agent must be restarted.
User parameter has the following syntax:
UserParameter=key,command
| Parameter | Description |
|---|---|
| Key | Unique item key. |
| Command | Command to be executed to evaluate value of the Key. |
Example 1
Simple command
UserParameter=ping,echo 1
The agent will always return '1' for item with key 'ping'.
Example 2
More complex example
UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive
The agent will return '1', if MySQL server is alive, '0' – otherwise.
2 Flexible user parameters
Flexible user parameters can be used for more control and flexibility.
For flexible user parameters,
UserParameter=key[*],command
| Parameter | Description |
|---|---|
| Key | Unique item key. The [*] defines that this key accepts parameters. |
| Command | Command to be executed to evaluate value of the Key. Zabbix parses content of [] and substitutes $1,…,$9 in the command. $0 will be substituted by the original command (prior to expansion of $0,…,$9) to be run. |
Example 1
Something very simple
UserParameter=ping[*],echo $1
We may define unlimited number of items for monitoring all having format ping[something].
-
ping[0] – will always return '0'
-
ping[aaa] – will always return 'aaa'
Example 2
Let's add more sense!
UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive
This parameter can be used for monitoring availability of MySQL database. We can pass user name and password:
mysql.ping[zabbix,our_password]
Example 3
How many lines matching a regular expression in a file?
UserParameter=wc[*],grep -c "$2" $1
This parameter can be used to calculate number of lines in a file.
wc[/etc/passwd,root] wc[/etc/services,zabbix]
Data source: Zabbix