章节:用户命令 (1)
最近更新: 2021-06-01
索引 返回主目录
zabbix_sender - Zabbix sender 实用程序
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 证书 --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] -k 键值 -o 值
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 证书 --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 证书 --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] -k 键值 -o 值
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 证书 --tls-ca-file CA文件 [--tls-crl-file CRL文件] [--tls-server-cert-issuer 证书颁发者] [--tls-server-cert-subject 证书主题] --tls-cert-file 证书文件 --tls-key-file 密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] -s 主机 --tls-connect 预共享密钥 --tls-psk-identity 预共享密钥标识 --tls-psk-file 预共享密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] -k 键值 -o 值
zabbix_sender [-v] -z 服务器 [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 预共享密钥 --tls-psk-identity 预共享密钥标识 --tls-psk-file 预共享密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 预共享密钥 --tls-psk-identity 预共享密钥标识 --tls-psk-file 预共享密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] -k 键值 -o 值
zabbix_sender [-v] -c 配置文件 [-z 服务器] [-p 端口] [-I IP地址] [-t 超时时间] [-s 主机] --tls-connect 预共享密钥 --tls-psk-identity 预共享密钥标识 --tls-psk-file 预共享密钥文件 [--tls-cipher13 加密字符串] [--tls-cipher 加密字符串] [-T] [-N] [-r] [-g] -i 输入文件
zabbix_sender -h
zabbix_sender -V
zabbix_sender 是一个命令行实用程序,用于向Zabbix server或者proxy发送监控数据。在Zabbix server上,应使用相应的密钥创建Zabbix trapper类型的监控项。请注意,传入值将仅接受从该监控项的允许的主机字段中指定的主机。
-c, --config 配置文件
使用 配置文件。Zabbix sender 从 agentd 配置文件读取服务器详细信息。默认情况下,Zabbix sender 不读取任何配置文件。仅支持参数 Hostname, ListenBacklog, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity 和 TLSPSKFile。 通过 HostnameItem 参数定义的主机名将不会被读取,在这种情况下,应通过命令行(参见 -s 选项)指定主机名。 在 agent ServerActive 配置参数中定义的所有地址 都用于发送数据。如果向某个地址发送批量数据失败, 随后的批次将不会发送到该地址。
-z, --zabbix-server 服务器
Zabbix 服务器的主机名或 IP 地址。如果主机由 proxy 监控,则应使用 proxy 的主机名或 IP 地址。与 --config 一起使用时,会覆盖在 agentd 配置文件中指定的 ServerActive 参数的条目。
-p, --port 端口
指定 Zabbix 服务器上运行的 trapper 的端口号。 默认值为 10051。与 --config 一起使用时,会覆盖 在 agentd 配置文件中指定的 ServerActive 参数的端口条目。
-I, --source-address IP 地址
指定源 IP 地址。与 --config 一起使用时, 会覆盖在 agentd 配置文件中指定的 SourceIP 参数。
-t, --timeout 秒数
指定超时时间。有效范围:1-300 秒(默认:60)
-s, --host 主机
指定监控项所属的主机名(如在 Zabbix 前端注册)。主机 IP 地址和 DNS 名称将不起作用。与 --config 一起使用时,会覆盖在 agentd 配置文件中指定的 Hostname 参数。
-k, --key 键
指定要发送值的监控项键。
-o, --value 值
指定监控项的值。
-i, --input-file 输入文件
从输入文件加载值。指定 - 作为 <input-file> 来 从标准输入读取值。文件的每一行包含空白分隔的:<hostname> <key> <value>。每个值 必须在单独的行上指定。每行必须包含 3 个空白分隔的条目:<hostname> <key> <value>,其中 "hostname" 是在 Zabbix 前端注册的监控主机的名称,"key" 是目标监控项的键,"value" - 要发送的值。 指定 - 作为 <hostname> 来使用 agent 配置文件中的主机名或从 --host 参数。
输入文件中一行的示例:
"Linux DB3" db.connections 43
在 Zabbix 前端的监控项配置中必须正确设置值类型。 Zabbix sender 将在一次连接中发送最多 250 个值。 从输入文件发送值的 大小限制 取决于 Zabbix 通信协议中描述的大小。 输入文件的内容必须是 UTF-8 编码。 输入文件中的所有值按顺序从上到下发送。 条目必须按照以下规则格式化:
-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> <ns> <value>。
输入文件
unencrypted
不加密连接(默认)
psk
使用TLS和预共享密钥进行连接
cert
使用TLS和证书进行连接
--tls-ca-file CA-file
包含用于对等证书验证的顶级CA证书的文件的完整路径名。
--tls-crl-file CRL-file
包含已吊销证书的文件的完整路径名。
--tls-server-cert-issuer cert-issuer
允许的server证书颁发者。
--tls-server-cert-subject cert-subject
允许的server证书主题。
--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
输出版本信息并退出。
如果值已发送且server已成功处理所有值,则退出状态为0。如果发送了数据,但至少一个值的处理失败,则退出状态为2。如果数据发送失败,退出状态为1。
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45
发送 342.45 作为受监视主机的 mysql.queries 监控项的值。使用代理配置文件中定义的受监视主机和 Zabbix server 。
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45
使用代理配置文件中定义的 Zabbix server发送 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 -
将带时间戳的值从命令行发送到agent配置文件中指定的 Zabbix server。输入数据中的短划线表示主机名也应从同一使用的配置文件中读取。
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -
从命令行将监控项的空值发送到端口 10000 上的 IP 地址为 192.168.1.113 的 Zabbix server。空值必须由空双引号表示。
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** 的server。
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 的server。
文档 https://www.zabbix.com/manuals
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
本文档创建于:2021年6月11日 08:42:39 GMT