Áú»¢¶Ä²©

1 Extending Áú»¢¶Ä²© agents

This tutorial provides step-by-step instructions on how to extend the functionality of Áú»¢¶Ä²© agent with the use of a user parameter.

Step 1

Write a script or command line to retrieve required parameter.

For example, we may write the following command in order to get total number of queries executed by a MySQL server:

mysqladmin -uroot status | cut -f4 -d":" | cut -f1 -d"S"

When executed, the command returns total number of SQL queries.

Step 2

Add the command to zabbix_agentd.conf:

UserParameter=mysql.questions,mysqladmin -uroot status | cut -f4 -d":" | cut -f1 -d"S"

mysql.questions is a unique identifier. It can be any valid key identifier, for example, queries.

Test this parameter by using Áú»¢¶Ä²© agent with "-t" flag (if running under root, however, note that the agent may have different permissions when launched as a daemon):

zabbix_agentd -t mysql.questions

Step 3

Reload user parameters from the configuration file by running:

zabbix_agentd -R userparameter_reload

You may also restart the agent instead of the runtime control command.

Test the parameter by using zabbix_get utility.

Step 4

Add new item with Key=mysql.questions to the monitored host. Type of the item must be either Áú»¢¶Ä²© Agent or Áú»¢¶Ä²© Agent (active).

Be aware that type of returned values must be set correctly on Áú»¢¶Ä²© server. Otherwise Áú»¢¶Ä²© won't accept them.