GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


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)



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.102 seconds. Last modified: November 04 2018 12:49:43.