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.

SEE ALSO

       zabbix_agentd(8), zabbix_get(8), zabbix_proxy(8), zabbix_server(8)

AUTHOR

       Alexei Vladishev <alex@zabbix.com>

                                         10 November 2011                        ZABBIX_SENDER(1)