zabbix_get

ZABBIX_GET(1)               通用命令手册              ZABBIX_GET(1)

名称
       zabbix_get - Zabbix 获取工具

概要
       zabbix_get  -s  host-name-or-IP  [-p  port-number]  [-I IP-address] [-t
       timeout] -k item-key
       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
       timeout]   --tls-connect  cert  --tls-ca-file  CA-file  [--tls-crl-file
       CRL-file] [--tls-agent-cert-issuer cert-issuer]  [--tls-agent-cert-sub‐
       ject  cert-subject]  --tls-cert-file  cert-file --tls-key-file key-file
       [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
       timeout]     --tls-connect    psk    --tls-psk-identity    PSK-identity
       --tls-psk-file PSK-file  [--tls-cipher13  cipher-string]  [--tls-cipher
       cipher-string] -k item-key
       zabbix_get -h
       zabbix_get -V

描述
       zabbix_get  是一个命令行工具，用于从 Zabbix agent 获取数据。

选项
       -s, --host host-name-or-IP
              指定主机的主机名或 IP 地址。

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

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

       -t, --timeout seconds
              指定超时时间。有效范围：1-600 秒（默认：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
              包含用于对端证书验证的顶级 CA 证书的文件完整路径。

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

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

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

       --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）。覆盖默认的密码套件选择条件。

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

       -V, --version
              输出版本信息并退出。
退出状态
       如果 zabbix_get 成功从 Zabbix agent 获取到值，则退出状态为 0。
       如果取值失败，则退出状态为 1。

示例
       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  op‐
       erations,O=Example  Corp,DC=example,DC=com"  --tls-cert-file /home/zab‐
       bix/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

另请参见
       文档

       zabbix_agentd(8), zabbix_proxy(8), zabbix_sender(1),  zabbix_server(8),
       zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)

Zabbix                            2022-01-06                     ZABBIX_GET(1)