NAME¶
zabbix_sender - Zabbix sender utility.
SYNOPSIS¶
zabbix_sender [-hpzvIV] {-kso | [-T] -i <inputfile>} [-c
<config-file>]
DESCRIPTION¶
zabbix_sender is a command line utility for sending data to a remote
Zabbix server. On the Zabbix server an item of type
Zabbix trapper
should be created with corresponding key. Note that incoming values will only
be accepted from hosts specified in
Allowed hosts field for this item.
Options¶
- -c, --config <config-file>
- Use config-file. Zabbix sender reads server details from the agent
configuration file. By default Zabbix sender does not read any
configuration file. Absolute path should be specified. Only parameters
Hostname, ServerActive and SourceIP are supported.
First entry from the ServerActive parameter is used.
- -z, --zabbix-server <server>
- Hostname or IP address of Zabbix server. If a host is monitored by a
proxy, proxy hostname or IP address should be used instead.
- -p, --port <port>
- Specify port number of server trapper running on the server. Default is
10051.
- -s, --host <host>
- Specify host name as registered in Zabbix frontend. Host IP address and
DNS name will not work.
- -I, --source-address <IP>
- Specify source IP address.
- -k, --key <key>
- Specify item key to send value to.
- -o, --value <value>
- Specify value.
- -i, --input-file <inputfile>
- Load values from input file. Specify - for standard input. Each
line of file contains whitespace delimited: <hostname>
<key> <value>. Specify - in <hostname>
to use hostname from configuration file or --host argument. All
entries are sent in a sequential order top-down.
- -T, --with-timestamps
- Each line of file contains whitespace delimited: <hostname>
<key> <timestamp> <value>. This can be used with
--input-file option. Timestamp should be specified in Unix
timestamp format. If target item has triggers referencing it, all
timestamps must be in an increasing order, otherwise event calculation
will not be correct.
- -r, --real-time
- Send values one by one as soon as they are received. This can be used when
reading from standard input.
- -v, --verbose
- Verbose mode, -vv for more details.
- -h, --help
- Display this help and exit.
- -V, --version
- Output version information and exit.
EXIT STATUS¶
The exit status is 0 if the values were sent and all of them were successfully
processed by server. If data was sent, but processing of at least one of the
values failed, the exit status is 2. If data sending failed, the exit status
is 1.
EXAMPLES¶
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host"
-k mysql.queries -o 342.45
Send
342.45 as the value for
mysql.queries key in
Monitored
Host host using Zabbix server defined in agent daemon configuration file.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Send values from file
data_values.txt to server with IP
192.168.1.113. Host names and keys are defined in the file.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/etc/zabbix/zabbix_agentd.conf -T -i -
Send a timestamped value from the commandline to Zabbix server, specified in the
agent daemon configuration file. Dash in the input data indicates that
hostname also should be used from the same configuration file.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z
192.168.1.113 -p 10000 -i -
Send empty value of an item to the Zabbix server with IP address
192.168.1.113 on port
10000 from the commandline. Empty values
must be indicated by double empty double quotes.
SEE ALSO¶
zabbix_agentd(8),
zabbix_get(8),
zabbix_proxy(8),
zabbix_server(8)
AUTHOR¶
Alexei Vladishev <alex@zabbix.com>