取得

概要

Zabbix get は、Zabbix エージェントと通信して、エージェントから必要な情報を取得するために使用できるコマンドラインユーティリティです。

このユーティリティは、通常、Zabbix エージェントのトラブルシューティングに使用されます。

Zabbix get のように動作する組み込み機能を備えた Zabbix 用 Python ライブラリ も参照してください。

Zabbix get の実行

UNIX で Zabbix get を実行して、エージェントからプロセッサ負荷の値を取得する例です:

cd bin
./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

Webサイトから文字列を取得するために Zabbix get を実行する別の例です:

cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"

ここでのアイテムキーにはスペースが含まれているため、シェルに対してアイテムキーを示すために引用符を使用しています。 引用符はアイテムキーの一部ではありません。シェルによって取り除かれ、Zabbix エージェントには渡されません。

アイテムキーがサポートされていない場合、Zabbix get は終了コード 1 を返します。

Zabbix get は次のコマンドラインパラメーターを受け付けます:

-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 およびそれ以前のリリース)
-h --help                               このヘルプメッセージを表示
-V --version                            バージョン番号を表示

--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>       事前共有鍵を識別するために使用される、一意で大文字小文字を区別する文字列
--tls-psk-file <PSK-file>               事前共有鍵を含むファイルの完全パス名
--tls-cipher13 <cipher-string>          OpenSSL 1.1.1 以降向けの TLS 1.3 用暗号スイート文字列。既定の暗号スイート選択基準を上書きします。このオプションは OpenSSL のバージョンが 1.1.1 未満の場合は使用できません
--tls-cipher <cipher-string>            TLS 1.2 以降向けの GnuTLS 優先度文字列、または TLS 1.2 のみ向けの OpenSSL 暗号スイート文字列。既定の暗号スイート選択基準を上書きします

詳細については、Zabbix get の man ページも参照してください。

Windows での Zabbix get も同様に実行できます:

zabbix_get.exe [options]