Zabbix Sender and Trapper
zabbix_sender is a command line utility for sending data to Zabbix server.
You don't need to have Zabbix server, proxy or an agent running on the same OS to use the
zabbix_sender utility, but you do need to make sure you have the correct version for your operating system.
Download the appropriate Zabbix version and repository for your operating system. I am using Zabbix 6 LTS on Ubuntu 20.04.
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb apt update
Now to install the
sudo apt install zabbix-sender
For help use
zabbix_sender is used to send data to your Zabbix server and can be called from either the command line or from a scripting language capable of running shell commands.
zabbix_sender -z 127.0.0.1 -s "Linux DB3" -k db.connections -o 43
On Zabbix, you need to create a host and add a
Zabbix Trapper item to receive and process the
Then you can use the
zabbix_sender binary to send data to that trapper item any time you need.
Example Sender and Trapper script
This script will generate a new random number every second and send it to a host configured on Zabbix server.
1st create a new item on your host using the Zabbix UI.
|Type of information||Numeric (unsigned)|
We can test the new
Zabbix Trapper item,
zabbix_sender -z <Zabbix server/proxy IP or Domain name> -s "<host name as written in Zabbix>" -k rnd -o 123
Next create a new python script
sudo nano rnd.py
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Error "processed: 0; failed: 1; total: 1;"
Q. You try Zabbix Sender and you get
processed: 0; failed: 1; total: 1;
A. There are many reasons. Have a break, come back after an hour and double check everything. Add the
-vv option to your query to show a more verbose error message. I.e.,
zabbix_sender -vv -z <Zabbix Server/Proxy IP or Domain name> -s "<host name as written in Zabbix>" -k rnd -o 123
Zabbix Agent is monitored by proxy
Q. The Zabbix Agent where the trapper item exists, is monitored by proxy.
A. Don't use the parameter
-z <Zabbix SERVER IP or Domain name>, but
-z <Zabbix PROXY IP or Domain name>.
Also make sure your Zabbix proxy is aware of the new Zabbix trapper item for the host that it is monitoring by refreshing the proxies' config cache.
sudo zabbix_proxy -R config_cache_reload
Invalid Value Type
Q. The Zabbix UI shows an error similar to
Value of type "string" is not suitable for value type "Numeric (unsigned)".
A. Your Trapper item is set to
Numeric (Unsigned), but you sent it a float, string, or negative number.