Table of Contents

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

zabbix_sender

章节：用户命令（1）
更新日期：2021-06-01
索引 Return to Main Contents

名称

zabbix_sender - Zabbix 发送工具

概要

zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] -s 主机 -k 键名 -o 值
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] -k 键名 -o 值
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] -s 主机 --tls-connect cert --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] -k 键名 -o 值
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect cert --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect cert --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] -k 键名 -o 值
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect cert --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] -s 主机 --tls-connect psk --tls-psk-identity PSK标识 --tls-psk-file PSK文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] -k 键名 -o 值
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect psk --tls-psk-identity PSK标识 --tls-psk-file PSK文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect psk --tls-psk-identity PSK标识 --tls-psk-file PSK文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] -k 键名 -o 值
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect psk --tls-psk-identity PSK标识 --tls-psk-file PSK文件 [--tls-cipher13 加密套件-string] [--tls-cipher 加密套件-string] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender -h
zabbix_sender -V

描述

zabbix_sender 是一个用于将监控数据发送到 Zabbix server 或 proxy 的命令行工具。在 Zabbix server 上，应创建一个类型为 Zabbix trapper 的监控项，并指定相应的键值。请注意，只有来自为此监控项在 Allowed 主机 字段中指定的主机的传入值才会被接受。

选项

-c，--config 配置文件 使用 配置文件。Zabbix sender 从以下位置读取服务器详细信息： agentd 配置文件。默认情况下，Zabbix sender 不会读取任何配置文件。仅参数 Hostname、ListenBacklog、ServerActive， 源IP地址、TLS连接方式、TLS CA文件、TLS CRL文件、 TLSServerCertIssuer、TLSServerCertSubject、TLSCertFile 支持 TLSKeyFile、TLSPSKIdentity 和 TLSPSKFile。通过 HostnameItem 参数定义的主机名不会被读取，在此情况下，主机名应通过命令行指定（参见 -s 选项）。在 agent ServerActive 配置参数中定义的所有地址用于发送数据。如果批量数据发送到其中一个失败地址，以下批次未发送到此地址。

-z, --zabbix-server server Zabbix server的主机名或IP地址。如果一个主机由以下方式监控：应使用proxy、proxy 主机名或IP地址代替。当使用时与 --config 一起使用时，将覆盖 ServerActive 的条目在代理配置文件中指定的参数。

-p, --port 端口指定服务器上运行的 Zabbix server trapper 的端口号。默认值为10051。与--config一起使用时，将覆盖配置文件中定义的端口。 agentd 中指定的 ServerActive 参数的端口条目配置文件

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

-t, --timeout 秒数指定超时时间。有效范围：1-300 秒（默认值：60）

-s, --host 主机指定主机名所属的监控项（在 Zabbix 中注册的）前端）。主机IP地址和 DNS 名称将无法工作。当使用时与 --config 一起使用时，将覆盖指定的 Hostname 参数在 agentd 配置文件中。

-k, --key key 指定要发送值的监控项键。

-o, --value value 指定监控项值。

-i, --input-file input-file 从输入文件加载值。将 <input-file> 指定为 - 以从标准输入读取值。file 的每一行包含空格以空格分隔：<主机名> <键> <值>。每个值必须在其单独的行上指定。每行必须包含 3 空格以分隔符分隔的条目：<hostname> <key> <value>，其中 “hostname”是受监控的主机的名称，该名称在Zabbix中注册。前端，"key" 是 target 监控项键，而 "value" 是要发送的值。指定 - 作为 <hostname> 以使用来自 agent 的主机名配置 file 或来自 --host 参数。

输入文件的一行示例：

"Linux DB3" 数据库连接 43

在Zabbix前端的监控项配置中，必须正确设置值类型。 Zabbix sender 将在一次连接中发送最多 250 个值。用于从输入发送值的Size limit和file 取决于Zabbix通信协议中描述的大小。输入内容 file 必须采用 UTF-8 编码。输入中的所有值按顺序file依次向下发送Top。条目必须使用以下规则进行格式化：

支持带引号和不带引号的条目。
双引号是引号字符。
包含空格的条目必须用引号括起来。
带引号的条目内部的双引号和反斜杠字符必须使用反斜杠进行转义。
非引号条目中不支持转义。
在带引号的字符串中支持换行转义序列（\n）。
条目末尾的换行转义序列将被删除。

-T，--with-timestamps 此选项只能与 --input-file 选项一起使用。

输入的每一行 file 必须包含以空白分隔的 4 条目： <主机名> <键值> <时间戳> <数值> 时间戳应以Unix时间戳格式指定。如果target 监控项具有引用它的触发器时，所有时间戳必须递增否则事件计算将不正确。

输入文件的一行示例：

"Linux DB3" db.connections 1429533600 43

有关详细信息，请参见选项 --input-file。

如果为一个主机发送了一个时间戳值，而该值处于“无数据”状态维护类型，此值将被丢弃；但是，可以为已过期的维护发送带时间戳的值周期，并将被接受。

-N, --with-ns 此选项只能与 --with-timestamps 选项一起使用。

输入的每一行 file 必须包含以空白分隔的 5 条目： <主机名> <键值> <时间戳> <纳秒> <value>.

输入文件的一行示例：

"Linux DB3" db.connections 1429533600 7402561 43

有关详细信息，请参见选项 --input-file。

-r, --real-time 逐个发送接收到的值。此方式可用于从标准输入读取时。

-g, --group 按主机对值进行分组，并将每个主机作为单独的批次发送。

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

unencrypted
不加密连接（默认）

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

证书使用TLS和证书进行连接

--tls-ca-file CA-file file的完整路径名，其中包含用于Top级别的CA证书对等证书验证。

--tls-crl-file CRL-file 包含已吊销证书的file完整路径名。

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

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

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

--tls-key-file key-file 包含私钥的file完整路径名。

--tls-psk-identity PSK身份标识 PSK身份标识 string

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

--tls-cipher13 cipher-string OpenSSL 1 的密码 string。1。1 或更高版本用于 TLS 1。3. 覆盖默认密码套件选择标准。如果...则此选项不可用 OpenSSL version 小于 1.1.1.

--tls-cipher cipher-string GnuTLS优先级string（适用于TLS 1.2及以上版本）或OpenSSL加密套件string （仅适用于TLS 1.2）。覆盖默认的密码套件选择标准。

-v，--verbose 详细模式，-vv 可获取更多详细信息。

-h，--help 显示此帮助信息并退出。

-V，--version 输出version信息并退出。

退出状态

如果值被发送并且全部被服务器成功处理，则退出状态为 0。如果数据被发送，但至少有一个值的处理失败，则退出状态为 2。如果数据发送失败，则退出状态为 1。

示例

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

发送 342.45 作为监控的 mysql.queries 监控项的值。使用监控的主机和 Zabbix server，它们在 agent 配置文件中定义。

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

发送 342.45 作为 Monitored 主机 主机的 mysql.queries 监控项的值，并使用 Zabbix server，该 Zabbix server 在 agent 配置文件中定义。

zabbix_sender -z 192.168.1.113 -i data_values.txt

将来自 file 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 server，该 Zabbix server 在 agent 配置文件中指定。输入数据中的短横线表示主机名也应从同一配置文件中获取。

echo '"Zabbix server" trapper.监控项 ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

从命令行发送一个空值的监控项到 IP 地址为 192.168.1.113 的 Zabbix server，端口为 10000。空值必须用空的双引号表示。

zabbix_sender -z 192.168.1.113 -s "Monitored 主机" -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

发送 342.45 作为 Monitored 主机 主机中的 mysql.queries 监控项的值到 IP 为 192.168.1.113 的服务器，使用带有证书的 TLS。

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

发送 342.45 作为 Monitored 主机 主机中的 mysql.queries 监控项的值到 IP 为 192.168.1.113 的服务器，使用带有预共享密钥（PSK）的 TLS。