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] -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] -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] -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] -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] -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] -i 输入文件
zabbix_sender -h
zabbix_sender -V

描述

zabbix_sender 是一个用于向 Zabbix server 或 proxy 发送监控数据的命令行工具。在 Zabbix server 上需要创建一个类型为 Zabbix trapper 的监控项并配置对应键值。请注意，只有在此监控项的 允许主机 字段中指定的主机所传入的值才会被接受。

选项

-c, --config 配置文件
使用指定的配置文件。Zabbix sender会从agentd配置文件中读取服务器详细信息。默认情况下Zabbix sender不会读取任何配置文件。仅支持Hostname、ServerActive、SourceIP、TLSConnect、TLSCAFile、TLSCRLFile、TLSServerCertIssuer、TLSServerCertSubject、TLSCertFile、TLSKeyFile、TLSPSKIdentity和TLSPSKFile参数。通过HostnameItem参数定义的主机名不会被识别，此时应通过命令行指定主机名（参见-s选项）。agent ServerActive配置参数中定义的所有地址都将用于发送数据。如果批量数据发送到某个地址失败，后续批次将不再发送至该地址。

-z, --zabbix-server 服务器
指定Zabbix server的主机名或IP地址。若主机由proxy监控，则应使用proxy 主机名或IP地址替代。与--config联用时，将覆盖agentd配置文件中ServerActive参数的条目。

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

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

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

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

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

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

-i, --input-file 输入文件
从输入文件加载数值。指定-作为<输入文件>可从标准输入读取。每行文件包含以空格分隔的：<主机名> <键> <值>。每个数值必须独占一行。每行必须包含3个以空格分隔的条目：<主机名> <键> <值>，其中"主机名"为Zabbix前端注册的监控主机名称，"键"为目标监控项键，"值"为待发送数值。指定-作为<主机名>可使用agent配置文件或--主机参数中的主机名。

输入文件行示例：

"Linux DB3" db.connections 43

数值类型必须在Zabbix前端的监控项配置中正确设置。Zabbix sender每次连接最多发送250个值。Size limit取决于Zabbix通信协议描述的尺寸。输入文件内容必须采用UTF-8编码。所有数值按Top顺序发送。条目格式需遵循以下规则：

支持引号和非引号条目
双引号为引用符
含空格的条目必须加引号
引号条目内的双引号和反斜杠必须用反斜杠转义
非引号条目不支持转义
引号字符串支持换行转义序列（\n）
换行转义序列会从条目末尾截断

-T, --with-timestamps
该选项仅能与--input-file联用。

输入文件每行必须包含4个以空格分隔的条目：<主机名> <键> <时间戳> <值>。时间戳需采用Unix时间戳格式。若目标监控项关联了触发器，则所有时间戳必须按递增顺序排列，否则事件计算将不准确。

输入文件行示例：

"Linux DB3" db.connections 1429533600 43

详情参见--input-file选项。

若为处于"无数据"维护类型的主机发送带时间戳的值，该值将被丢弃；但可以为已过期的维护期发送带时间戳的值，此时会被接受。

-N, --with-ns
该选项仅能与--with-timestamps联用。

输入文件每行必须包含5个以空格分隔的条目：<主机名> <键> <时间戳> <纳秒> <值>。

输入文件行示例：

"Linux DB3" db.connections 1429533600 7402561 43

详情参见--input-file选项。

-r, --real-time
实时逐条发送接收到的数值。适用于从标准输入读取时使用。

--tls-connect 值
指定连接server 或 proxy的方式。可选值：

unencrypted
不加密连接（默认）

psk
connect using TLS and a pre-shared key

{=html}
       <!-- -->

cert
connect using TLS and a certificate

{=html}
       <!-- -->

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

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

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

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

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

--tls-key-file 密钥文件
包含私钥的完整路径文件。

--tls-psk-identity PSK标识
预共享密钥string。

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

--tls-cipher13 密码套件
用于OpenSSL 1.1.1或更高版本的TLS 1.3的密码string。覆盖默认的密码套件选择标准。如果OpenSSL版本低于1.1.1，则此选项不可用。

--tls-cipher 密码套件
GnuTLS优先级string（适用于TLS 1.2及以上版本）或OpenSSL密码string（仅适用于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监控项的值发送给被监控主机。使用agent配置文件中定义的被监控主机和Zabbix server。

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

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

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

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

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

zabbix_sender -z 192.168.1.113 -s "被监控主机" -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作为mysql.queries监控项的值发送给被监控主机主机，使用证书通过TLS连接到IP为192.168.1.113的服务器。

zabbix_sender -z 192.168.1.113 -s "被监控主机" -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作为mysql.queries监控项的值发送给被监控主机主机，使用预共享密钥（PSK）通过TLS连接到IP为192.168.1.113的服务器。