Zabbix Documentation 5.0

Sidebar

zabbix_sender

章节:用户命令 (1)
更新: 2020-02-29
索引 返回主目录


 

名称

zabbix_sender - Zabbix sender 实用程序  

概要

zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP-地址] -s 主机 -k key -o value
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-s 主机] [-T] [-r] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-s 主机] -k key -o value
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-s 主机] [-T] [-r] -i 输入文件
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] -s 主机 --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [-T] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [-T] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] -s host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [-T] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [-T] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V  

描述

zabbix_sender 是一个命令行实用程序,用于将监视数据发送到Zabbix server 或 proxy。在Zabbixserver 上,应使用相应的密钥创建Zabbix trapper类型的项目。请注意,此值仅接受来自允许的主机字段中指定的主机的值。  

选项

-c, --config 配置文件
使用config-fileZabbix sender从代理配置文件中读取服务器详细信息。默认情况下, Zabbix sender 不读取任何配置文件。参数只有HostnameServerActiveSourceIPTLSConnectTLSCAFileTLSCRLFileTLSServerCertIssuerTLSServerCertSubjectTLSCertFileTLSKeyFileTLSPSKIdentityTLSPSKFile支持。在agent中定义ServerActive的所有地址配置参数用于发送数据。如果批处理数据发送到一个地址失败,则以下批处理不会发送到该地址。

-z, --zabbix-server server
Zabbix server的主机名或IP地址。如果主机由代理监视,则应改用代理主机名或IP地址。与--config一起使用时,将覆盖代理配置文件中指定的ServerActive参数的条目。

-p, --port port
指定服务器上运行的Zabbix服务器陷阱程序的端口号。缺省值为10051。与--config一起使用时,将覆盖代理配置文件中指定的ServerActive参数的端口条目.

-I, --source-address IP-address
指定源IP地址。当与一起使用--config,覆盖SourceIP在agentd配置文件中指定的参数.

-s, --host host
指定项目所属的主机名(在Zabbix前端中注册)。主机IP地址和DNS名称将不起作用。与--config一起使用时,将覆盖代理配置文件中指定的Hostname参数.

-k, --key key
指定要发送值的项目键.

-o, --value value
指定项目值.

-i, --input-file input-file
从输入文件加载值。指定- as 从标准输入读取值。文件的每一行包含分隔的空格: 。每个值必须在自己的行中指定。每一行必须包含3个由空格分隔的条目: ,其中<hostname> <key> <value>是被监控主机在Zabbix前端注册的名称,“key”是目标项目的key,“value”是要发送的值。指定-as 以使用代理配置文件中的 <hostname>--host参数

输入文件的一行示例:

"Linux DB3" db.connections 43

必须在Zabbix前端的项目配置中正确设置值类型。Zabbix发件人将在一个连接中最多发送250个值。输入文件的内容必须采用UTF-8编码。输入文件中的所有值均按自上而下的顺序发送。条目必须使用以下规则设置格式:


支持带引号和不带引号的条目.


双引号是引号字符.


带有空格的条目必须用引号引起来.


带引号的条目中的双引号和反斜杠字符必须以反斜杠转义.


未引用的条目不支持转义.


带引号的字符串支持换行转义序列(\n).


从条目的末尾开始修剪换行符转义序列.

-T, --with-timestamps
此选项只能与--input-file选项一起使用。 输入文件的每一行必须包含4个以空格分隔的条目:<hostname> <key> <timestamp> <value>。时间戳记应以Unix时间戳记格式指定。如果目标项目具有引用它的触发器,则所有时间戳记必须按升序排列,否则事件计算将不正确.

输入文件的一行示例:

"Linux DB3" db.connections 1429533600 43

有关更多详细信息,请参见选项 --input-file.

如果为“无数据”维护类型的主机发送带有时间戳的值,则该值将被删除;否则,该值将被删除。但是,可以在过期的维护期内发送带有时间戳的值,并且该值将被接受.

-N, --with-ns
该选项只能与--with-timestamps选项一起使用。 输入文件的每一行必须包含5个以空格分隔的条目:<hostname> <key> <timestamp> <value> 输入文件的一行示例:

"Linux DB3" db.connections 1429533600 7402561 43

有关更多详细信息,请参见选项 --input-file.

-r, --real-time
收到值后立即一一发送。从标准输入读取时可以使用此功能.

--tls-connect value
如何连接到server 或proxy。值:

 

unencrypted
不加密连接(默认)

psk
c使用TLS和预共享密钥进行连接

cert
使用TLS和证书进行连接

--tls-ca-file CA-file
包含用于对等证书验证的顶级CA证书的文件的完整路径名.

--tls-crl-file CRL-file
包含已撤销证书的文件的完整路径名.

--tls-server-cert-issuer cert-issuer
允许的服务器证书颁发者.

--tls-server-cert-subject cert-subject
允许的服务器证书主题.

--tls-cert-file cert-file
包含证书或证书链的文件的完整路径名.

--tls-key-file key-file
包含私钥的文件的完整路径名.

--tls-psk-identity PSK-identity
PSK身份字符串.

--tls-psk-file PSK-file
包含预共享密钥的文件的完整路径名.

--tls-cipher13 cipher-string
OpenSSL 1.1.1或TLS 1.3或更高版本的密码字符串。覆盖默认密码套件选择条件。如果OpenSSL版本低于1.1.1,则此选项不可用.

--tls-cipher cipher-string
GnuTLS优先级字符串(用于TLS 1.2及更高版本)或OpenSSL密码字符串(仅用于TLS 1.2)。覆盖默认密码套件选择条件.

-v, --verbose
详细模式,-vv了解更多详细信息.

-h, --help
显示此帮助并退出.

-V, --version
输出版本信息并退出.

 

退出状态

如果已发送值并且服务器已成功处理所有值,则退出状态为0。如果发送了数据,但是至少一个值的处理失败,则退出状态为2。如果数据发送失败,则退出状态为1.

 

例子

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

发送342.45作为受监视主机的mysql.queries项目的值。使用代理配置文件中定义的受监视主机和Zabbix服务器

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45

使用代理配置文件中定义的Zabbix服务器 发送342.45作为“受监视的主机”主机的mysql.queries项目的值.


zabbix_sender -z 192.168.1.113 -i data_values.txt


将文件data_values.txt中的值发送到IP为192.168.1.113的Zabbix server。主机名和密钥在文件中定义.


echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

将带有时间戳的值从命令行发送到代理配置文件中指定的Zabbix服务器。输入数据中的短划线表示还应从同一配置文件中使用主机名.


echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

从命令行在端口10000上将空值的项目发送到IP地址为192.168.1.113的Zabbix服务器。空值必须用空双引号表示.

zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file /home/zabbix/zabbix_agentd.key

使用带有证书的TLS 将342.45作为“受监视的主机”主机中mysql.queries项目的值发送到IP为192.168.1.113的服务器

zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk

使用带有预共享密钥(PSK)的TLS 将342.45作为“受监视的主机”主机中mysql.queries项目的值发送到IP为192.168.1.113的服务器.

 

另请参阅

文档 https://www.zabbix.com/manuals

zabbix_agent2(8), zabbix_agentd(8), zabbix_get(1), zabbix_js(1), zabbix_proxy(8), zabbix_server(8)  

作者

Alexei Vladishev <>


 

索引

名称

概要

描述

选项

退出状态

例子

另请参阅

作者


该文档是由 man2html, 使用手册页创建的。 时间:2020年3月18日格林尼治标准时间20:49:51