zabbix_get

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

名称

zabbix_get - Zabbix get 工具

概要

zabbix_get -s 主机-名称或IP [-p 端口号] [-I IP地址] [-t 超时时间] -k item-key
zabbix_get -s 主机-名称或IP [-p 端口号] [-I IP地址] [-t 超时时间] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer 证书颁发者] [--tls-agent-cert-subject 证书主题] --tls-cert-file 证书-file --tls-key-file 密钥-file [--tls-cipher13 密码套件-string] [--tls-cipher 密码套件-string] -k item-key
zabbix_get -s 主机-名称或IP [-p 端口号] [-I IP地址] [-t 超时时间] --tls-connect psk --tls-psk-identity PSK标识 --tls-psk-file PSK-file [--tls-cipher13 密码套件-string] [--tls-cipher 密码套件-string] -k item-key
zabbix_get -h
zabbix_get -V

描述

zabbix_get 是一个用于从 agent 获取数据的命令行工具。

选项

-s, --host host-name-or-IP
指定主机名或一个主机的IP地址.

-p, --port port-number
指定运行在主机上的agent端口号. 默认为10050.

-I, --source-address IP-address
指定源IP地址.

-t, --timeout seconds
指定超时时间. 有效范围: 1-30秒 (默认: 30)

-k, --key item-key
指定要获取值的监控项键名.

-P, --protocol value
与agent通信使用的协议. 可选值:

auto 使用JSON协议连接，失败后回退并重试明文协议 (默认)

json 使用JSON协议连接

plaintext 使用明文协议连接，仅发送监控项键名 (6.4.x及更早版本)

--tls-connect value
连接到agent的方式. 可选值:

unencrypted
不加密连接（默认）

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

cert
使用TLS和证书连接

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

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

--tls-agent-cert-issuer cert-issuer
允许的agent证书颁发者。

--tls-agent-cert-subject cert-subject
允许的agent证书主题。

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

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

--tls-psk-identity PSK-identity
PSK身份string。

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

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

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

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

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

示例

zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk