Table of Contents

zabbix_sender
- 名称
- 概要
- 描述
- 选项
- 退出状态
- 例子
- 另请参阅
- 作者
- 索引

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-file。 Zabbix sender从代理配置文件中读取服务器详细信息。默认情况下， Zabbix sender 不读取任何配置文件。参数只有Hostname，ServerActive，SourceIP，TLSConnect，TLSCAFile，TLSCRLFile， TLSServerCertIssuer，TLSServerCertSubject，TLSCertFile，TLSKeyFile，TLSPSKIdentity 和TLSPSKFile支持。在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的服务器.