Zabbix Documentation 2.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


manpages:zabbix_sender

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manpages:zabbix_sender [2014/09/25 14:43] (current)
sasha Page moved from 2.0:manpages:zabbix_sender to manpages:zabbix_sender
Line 1: Line 1:
 +<​HTML><​HEAD><​TITLE>​Manpage of ZABBIX_SENDER</​TITLE>​
 +</​HEAD><​BODY>​
 +<​H1>​ZABBIX_SENDER</​H1>​
 +Section: Maintenance Commands (8)<​BR>​Updated:​ 10 November 2011<​BR><​A HREF="#​index">​Index</​A>​
 +<a href=/​documentation/​2.0/​manpages>​Return to Main Contents</​A><​HR>​
  
 +
 +
 +<A NAME="​lbAB">&​nbsp;</​A>​
 +<​H2>​NAME</​H2>​
 +
 +zabbix_sender - Zabbix sender utility.
 +<A NAME="​lbAC">&​nbsp;</​A>​
 +<​H2>​SYNOPSIS</​H2>​
 +
 +<​B>​zabbix_sender [-hpzvIV] {-kso | [-T] -i </​B><​I>&​lt;​inputfile&​gt;</​I><​B>​} [-c </​B><​I>&​lt;​config-file&​gt;</​I><​B>​]</​B>​
 +
 +<A NAME="​lbAD">&​nbsp;</​A>​
 +<​H2>​DESCRIPTION</​H2>​
 +
 +<​B>​zabbix_sender</​B>​
 +
 +is a command line utility for sending data to a remote Zabbix server. On the Zabbix server an item of type <​B>​Zabbix trapper</​B>​ should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in <​B>​Allowed hosts</​B>​ field for this item.
 +<P>
 +<A NAME="​lbAE">&​nbsp;</​A>​
 +<​H3>​Options</​H3>​
 +
 +<DL COMPACT>
 +<​DT>​-c,​ --config <​I>&​lt;​config-file&​gt;</​I><​DD>​
 +Use <​I>​config-file</​I>​. 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 <​B>​Hostname</​B>,​ <​B>​ServerActive</​B>​ and <​B>​SourceIP</​B>​ are supported (starting with Zabbix 2.0.5). First entry from the <​B>​ServerActive</​B>​ parameter is used.
 +<​DT>​-z,​ --zabbix-server <​I>&​lt;​server&​gt;</​I><​DD>​
 +Hostname or IP address of Zabbix server. If a host is monitored by a proxy, proxy hostname or IP address should be used instead.
 +<​DT>​-p,​ --port <​I>&​lt;​port&​gt;</​I><​DD>​
 +Specify port number of server trapper running on the server. Default is 10051.
 +<​DT>​-s,​ --host <​I>&​lt;​host&​gt;</​I><​DD>​
 +Specify host name as registered in Zabbix frontend. Host IP address and DNS name will not work.
 +<​DT>​-I,​ --source-address <​I>&​lt;​IP&​gt;</​I><​DD>​
 +Specify source IP address.
 +<​DT>​-k,​ --key <​I>&​lt;​key&​gt;</​I><​DD>​
 +Specify item key to send value to.
 +<​DT>​-o,​ --value <​I>&​lt;​value&​gt;</​I><​DD>​
 +Specify value.
 +<​DT>​-i,​ --input-file <​I>&​lt;​inputfile&​gt;</​I><​DD>​
 +Load values from input file. Specify <​B>​-</​B>​ for standard input. Each line of file contains whitespace delimited: <​B>&​lt;​hostname&​gt;​ &​lt;​key&​gt;​ &​lt;​value&​gt;</​B>​. Specify <​B>​-</​B>​ in <​B>&​lt;​hostname&​gt;</​B>​ to use hostname from configuration file or <​B>​--host</​B>​ argument. All entries are sent in a sequential order top-down.
 +<​DT>​-T,​ --with-timestamps<​DD>​
 +Each line of file contains whitespace delimited: <​B>&​lt;​hostname&​gt;​ &​lt;​key&​gt;​ &​lt;​timestamp&​gt;​ &​lt;​value&​gt;</​B>​. This can be used with <​B>​--input-file</​B>​ 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.
 +<​DT>​-r,​ --real-time<​DD>​
 +Send values one by one as soon as they are received. This can be used when reading from standard input.
 +<​DT>​-v,​ --verbose<​DD>​
 +Verbose mode, -vv for more details.
 +<​DT>​-h,​ --help<​DD>​
 +Display this help and exit.
 +<​DT>​-V,​ --version<​DD>​
 +Output version information and exit.
 +</DL>
 +<A NAME="​lbAF">&​nbsp;</​A>​
 +<​H2>​EXAMPLES</​H2>​
 +
 +<​B>​zabbix_sender -c /​usr/​local/​etc/​zabbix_agentd.conf -s Monitored Host -k mysql.queries -o 342.45</​B>​
 +
 +<P>
 +Send <​B>​342.45</​B>​ as the value for <​B>​mysql.queries</​B>​ key in <​B>​Monitored Host</​B>​ host using Zabbix server defined in agent daemon configuration file.
 +<P>
 +<​B>​zabbix_sender -z 192.168.1.113 -i data_values.txt</​B>​
 +
 +<P>
 +Send values from file <​B>​data_values.txt</​B>​ to server with IP <​B>​192.168.1.113</​B>​. Host names and keys are defined in the file.
 +<P>
 +<​B>​echo - hw.serial.number 1287872261 SQ4321ASDF | zabbix_sender -c /​usr/​local/​etc/​zabbix_agentd.conf -T -i -</B>
 +
 +<P>
 +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.
 +<P>
 +<A NAME="​lbAG">&​nbsp;</​A>​
 +<​H2>​SEE ALSO</​H2>​
 +
 +<​B><​A HREF="​zabbix_agentd">​zabbix_agentd</​A></​B>​(8),​
 +
 +<​B><​A HREF="​zabbix_get">​zabbix_get</​A></​B>​(8),​
 +
 +<​B><​A HREF="​zabbix_proxy">​zabbix_proxy</​A></​B>​(8),​
 +
 +<​B><​A HREF="​zabbix_server">​zabbix_server</​A></​B>​(8)
 +
 +<A NAME="​lbAH">&​nbsp;</​A>​
 +<​H2>​AUTHOR</​H2>​
 +
 +Alexei Vladishev &​lt;<​A HREF="​mailto:​[email protected]">​[email protected]</​A>&​gt;​
 +<P>
 +
 +<HR>
 +<A NAME="​index">&​nbsp;</​A><​H2>​Index</​H2>​
 +<DL>
 +<​DT><​A HREF="#​lbAB">​NAME</​A><​DD>​
 +<​DT><​A HREF="#​lbAC">​SYNOPSIS</​A><​DD>​
 +<​DT><​A HREF="#​lbAD">​DESCRIPTION</​A><​DD>​
 +<DL>
 +<​DT><​A HREF="#​lbAE">​Options</​A><​DD>​
 +</DL>
 +<​DT><​A HREF="#​lbAF">​EXAMPLES</​A><​DD>​
 +<​DT><​A HREF="#​lbAG">​SEE ALSO</​A><​DD>​
 +<​DT><​A HREF="#​lbAH">​AUTHOR</​A><​DD>​
 +</DL>
 +<HR>
 +This document was created by
 +man2html,
 +using the manual pages.<​BR>​
 +Time: 14:48:41 GMT, July 23, 2012
 +</​BODY>​
 +</​HTML>​