1ZABBIX_SENDER(8) System Manager's Manual ZABBIX_SENDER(8)
2
3
4
6 zabbix_sender - Zabbix sender utility.
7
9 zabbix_sender [-hpzvIV] {-kso | [-T] -i <inputfile>} [-c <config-file>]
10
12 zabbix_sender is a command line utility for sending data to a remote
13 Zabbix server. On the Zabbix server an item of type Zabbix trapper
14 should be created with corresponding key. Note that incoming values
15 will only be accepted from hosts specified in Allowed hosts field for
16 this item.
17
18
19 Options
20 -c, --config <config-file>
21 Specify agent configuration file for reading server details.
22
23 -z, --zabbix-server <server>
24 Hostname or IP address of Zabbix server.
25
26 -p, --port <port>
27 Specify port number of server trapper running on the server.
28 Default is 10051.
29
30 -s, --host <host>
31 Specify host name as registered in Zabbix front-end. Host IP
32 address and DNS name will not work.
33
34 -I, --source-address <IP>
35 Specify source IP address.
36
37 -k, --key <key>
38 Specify item key to send value to.
39
40 -o, --value <value>
41 Specify value.
42
43 -i, --input-file <inputfile>
44 Load values from input file. Specify - for standard input. Each
45 line of file contains whitespace delimited: <hostname> <key>
46 <value>. Specify - in <hostname> to use hostname from configura‐
47 tion file or --host argument.
48
49 -T, --with-timestamps
50 Each line of file contains whitespace delimited: <hostname>
51 <key> <timestamp> <value>. This can be used with --input-file
52 option. Timestamp should be specified in Unix timestamp format.
53
54 -r, --real-time
55 Send values one by one as soon as they are received. This can be
56 used when reading from standard input.
57
58 -v, --verbose
59 Verbose mode, -vv for more details.
60
61 -h, --help
62 Display this help and exit.
63
64 -V, --version
65 Output version information and exit.
66
68 zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
69 mysql.queries -o 342.45
70
71 Send 342.45 as the value for mysql.queries key in Monitored Host host
72 using Zabbix server defined in agent daemon configuration file.
73
74 zabbix_sender -z 192.168.1.113 -i data_values.txt
75
76 Send values from file data_values.txt to server with IP 192.168.1.113.
77 Host names and keys are defined in the file.
78
79 echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
80 /etc/zabbix/zabbix_agentd.conf -T -i -
81
82 Send a timestamped value from the commandline to Zabbix server, speci‐
83 fied in the agent daemon configuration file. Dash in the input data
84 indicates that hostname also should be used from the same configuration
85 file.
86
87
89 zabbix_agentd(8), zabbix_get(8), zabbix_proxy(8), zabbix_server(8)
90
92 Alexei Vladishev <alex@zabbix.com>
93
94
95
96 5 July 2011 ZABBIX_SENDER(8)