Ubuntu Manpage: zabbix_sender - Zabbix sender utility.

Provided by: zabbix-agent_2.2.2+dfsg-1ubuntu1_amd64

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 front-end. 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.

AUTHOR