このページで
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エージェントからデータを取得するためのコマンドライン
ユーティリティです。
オプション
-s, --host host-name-or-IP
ホストのホスト名またはIPアドレスを指定します。
-p, --port port-number
ホスト上で動作しているエージェントのポート番号を指定します。デフォルトは
10050です。
-I, --source-address IP-address
送信元IPアドレスを指定します。
-t, --timeout seconds
タイムアウトを指定します。有効範囲: 1～600秒（デフォルト: 30）
-k, --key item-key
値を取得するアイテムのキーを指定します。
-P, --protocol value
エージェントとの通信に使用するプロトコル。値:
auto JSONプロトコルを使用して接続し、失敗した場合はプレーン
テキストプロトコルで再試行します（デフォルト）
json JSONプロトコルを使用して接続します
plaintext アイテムキーのみを送信するプレーンテキストプロトコル
を使用して接続します（6.4.x以前のリリース）
--tls-connect value
エージェントへの接続方法。値:
unencrypted
暗号化なしで接続します（デフォルト）
psk TLSおよび事前共有鍵を使用して接続します
cert TLSおよび証明書を使用して接続します
--tls-ca-file CA-file
ピア証明書の検証用に、最上位CA証明書を含むファイルのフルパスを指定しま
す。
--tls-crl-file CRL-file
失効した証明書を含むファイルのフルパスを指定します。
--tls-agent-cert-issuer cert-issuer
許可するエージェント証明書の発行者。
--tls-agent-cert-subject cert-subject
許可するエージェント証明書のサブジェクト。
--tls-cert-file cert-file
証明書または証明書チェーンを含むファイルのフルパスを指定します。
--tls-key-file key-file
秘密鍵を含むファイルのフルパスを指定します。
--tls-psk-identity PSK-identity
PSK-identity文字列。
--tls-psk-file PSK-file
事前共有鍵を含むファイルのフルパスを指定します。
--tls-cipher13 cipher-string
TLS 1.3向けの、OpenSSL 1.1.1以降用の暗号スイート文字列。デフォルトの暗
号スイート選択基準を上書きします。OpenSSLのバージョンが1.1.1未満の場
合、このオプションは使用できません。
--tls-cipher cipher-string
GnuTLS優先順位文字列（TLS 1.2以降用）またはOpenSSL暗号文字列（TLS
1.2のみ）。デフォルトの暗号スイート選択基準を上書きします。
-h, --help
このヘルプを表示して終了します。
-V, --version
バージョン情報を出力して終了します。
終了ステータス
zabbix_get が Zabbixエージェントから値の取得に成功した場合、終了ステータスは
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)