Table of Contents

zabbix_sender
- 名前
- 概要
- 説明
- オプション
- 終了ステータス
- 例
- 参照
- 目次

zabbix_sender

セクション: ユーザーコマンド (1)
更新日: 2021-06-01
目次メインコンテンツに戻る

名前

zabbix_sender - Zabbix senderユーティリティ

概要

zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] -s host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] [-s host] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] -s host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] -s host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IPアドレス] [-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender -h
zabbix_sender -V

説明

zabbix_senderは、監視データをZabbixサーバーまたはプロキシに送信するためのコマンドラインユーティリティです。Zabbixサーバーでは、Zabbix trapperタイプのアイテムに対応するキーで作成する必要があります。受信データは、このアイテムの許可されたホストフィールドで指定されたホストからのみ受け入れられることに注意してください。

オプション

-c, --config config-file
config-file を使用します。Zabbix sender はサーバーの詳細を agentd の設定ファイルから読み取ります。デフォルトでは Zabbix sender は設定ファイルを読み取りません。サポートされているパラメーターは Hostname、ServerActive、SourceIP、TLSConnect、TLSCAFile、TLSCRLFile、TLSServerCertIssuer、TLSServerCertSubject、TLSCertFile、TLSKeyFile、TLSPSKIdentity、TLSPSKFile のみです。HostnameItem パラメーターで定義されたホスト名は取得されません。この場合、ホスト名はコマンドラインで指定する必要があります（-s オプションを参照）。エージェントの ServerActive 設定パラメーターで定義されたすべてのアドレスがデータ送信に使用されます。バッチデータの送信が1つのアドレスで失敗した場合、次のバッチはそのアドレスには送信されません。

-z, --zabbix-server server
Zabbixサーバーのホスト名またはIPアドレス。ホストがプロキシによって監視されている場合は、プロキシのホスト名またはIPアドレスを使用する必要があります。--config と一緒に使用すると、agentd 設定ファイルで指定された ServerActive パラメーターのエントリを上書きします。

-p, --port port
サーバーで実行されているZabbixサーバートラッパーのポート番号を指定します。デフォルトは10051です。--config と一緒に使用すると、agentd 設定ファイルで指定された ServerActive パラメーターのポートエントリを上書きします。

-I, --source-address IP-address
送信元IPアドレスを指定します。--config と一緒に使用すると、agentd 設定ファイルで指定された SourceIP パラメーターを上書きします。

-t, --timeout seconds
タイムアウトを指定します。有効範囲: 1-300秒（デフォルト: 60）

-s, --host host
アイテムが属するホスト名を指定します（Zabbixフロントエンドに登録されているもの）。ホストのIPアドレスやDNS名は使用できません。--config と一緒に使用すると、agentd 設定ファイルで指定された Hostname パラメーターを上書きします。

-k, --key key
値を送信するアイテムキーを指定します。

-o, --value value
アイテムの値を指定します。

-i, --input-file input-file
入力ファイルから値を読み込みます。<input-file> に - を指定すると、標準入力から値を読み取ります。ファイルの各行には、空白で区切られた <hostname> <key> <value> が含まれます。各値は独自の行で指定する必要があります。各行には、空白で区切られた3つのエントリ <hostname> <key> <value> が含まれている必要があります。ここで "hostname" はZabbixフロントエンドに登録されている監視対象ホストの名前、"key" は対象アイテムのキー、"value" は送信する値です。<hostname> に - を指定すると、エージェントの設定ファイルまたは --host 引数からホスト名を使用します。

入力ファイルの1行の例:

"Linux DB3" db.connections 43

値のタイプは、Zabbixフロントエンドのアイテム設定で正しく設定されている必要があります。Zabbix senderは1つの接続で最大250個の値を送信します。入力ファイルから値を送信する場合のサイズ制限は、Zabbix通信プロトコルで記述されているサイズに依存します。入力ファイルの内容はUTF-8エンコーディングである必要があります。入力ファイルのすべての値は、上から下へ順番に送信されます。エントリは次のルールでフォーマットする必要があります:

引用符付きおよび引用符なしのエントリがサポートされています。
ダブルクォートが引用文字です。
空白を含むエントリは引用符で囲む必要があります。
引用符付きエントリ内のダブルクォートおよびバックスラッシュ文字は、バックスラッシュでエスケープする必要があります。
引用符なしのエントリではエスケープはサポートされていません。
改行エスケープシーケンス（\n）は引用符付き文字列でサポートされています。
改行エスケープシーケンスはエントリの末尾からトリムされます。

-T, --with-timestamps
このオプションは --input-file オプションと一緒にのみ使用できます。

入力ファイルの各行には、空白で区切られた4つのエントリ <hostname> <key> <timestamp> <value> が含まれている必要があります。タイムスタンプはUnixタイムスタンプ形式で指定する必要があります。対象アイテムにそれを参照するトリガーがある場合、すべてのタイムスタンプは昇順でなければなりません。そうでない場合、イベント計算が正しく行われません。

入力ファイルの1行の例:

"Linux DB3" db.connections 1429533600 43

詳細については、--input-file オプションを参照してください。

「データなし」メンテナンスタイプのホストにタイムスタンプ付きの値が送信された場合、この値は破棄されます。ただし、期限切れのメンテナンス期間にタイムスタンプ付きの値を送信することは可能であり、受け入れられます。

-N, --with-ns
このオプションは --with-timestamps オプションと一緒にのみ使用できます。

入力ファイルの各行には、空白で区切られた5つのエントリ <hostname> <key> <timestamp> <ns> <value> が含まれている必要があります。

入力ファイルの1行の例:

"Linux DB3" db.connections 1429533600 7402561 43

詳細については、--input-file オプションを参照してください。

-r, --real-time
値を受信したらすぐに1つずつ送信します。これは標準入力から読み取る場合に使用できます。

-g, --group
値をホストごとにグループ化し、各ホストに個別のバッチで送信します。

--tls-connect value
サーバーまたはプロキシへの接続方法。値:

unencrypted 暗号化なしで接続します (デフォルト)。

psk TLSと事前共有キーを使用して接続します。

cert TLS と証明書を使用して接続します。

--tls-ca-file CA-file ピア証明書検証用の最上位CA証明書を含むファイルのフルパス名。

--tls-crl-file CRL-file 失効した証明書を含むファイルのフルパス名。

--tls-server-cert-issuer cert-issuer 許可されたサーバー証明書の発行者。

--tls-server-cert-subject cert-subject 許可されたサーバー証明書のサブジェクト。

--tls-cert-file cert-file 証明書または証明書チェーンを含むファイルのフルパス名。

--tls-key-file key-file 秘密鍵を含むファイルのフルパス名。

--tls-psk-identity PSK-identity PSK ID文字列。

--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のみ)。デフォルトの暗号スイート選択基準をオーバーライドします。

-v, --verbose 冗長化モード。詳細は-vvを参照して下さい。

-h, --help ヘルプを出力して終了します。

-V, --version バージョン情報を出力して終了します。

終了ステータス

値が送信され、それらすべてがサーバーによって正常に処理された時の終了ステータスは0です。データが送信されたが、少なくとも1つの値の処理が失敗した時の終了ステータスは2です。データ送信が失敗した時の終了ステータスは1です。

例

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45

監視対象ホストのmysql.queriesアイテムの値として342.45を送信します。エージェントの設定ファイルで定義された監視対象ホストとZabbixサーバーを使用します。

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45

エージェントの設定ファイルで定義されたZabbixサーバーを使用してMonitored Hostホストのmysql.queriesアイテムの値として342.45を送信します。

zabbix_sender -z 192.168.1.113 -i data_values.txt

ファイルdata_values.txtから IP 192.168.1.113の Zabbixサーバーに値を送信します。ホスト名とキーはファイルで定義されます。

echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

エージェントの設定ファイルで指定されたコマンドラインからZabbixサーバーにタイムスタンプ付きの値を送信します。入力データのダッシュは、ホスト名も同じ設定ファイルから使用する必要があることを示します。

echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

コマンドラインからIPアドレス192.168.1.113のポート10000でリッスンしているZabbixサーバーに空のアイテムの値を送信します。空の値は、空の二重引用符で示します。

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

*Monitored Host**ホスト*のmysql.queriesアイテムの値として342.45を、証明書付きのTLSを使用してIP 192.168.1.113のサーバーに送信します。

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

Monitored Hostホストのmysql.queriesアイテムの値として342.45をIP 192.168.1.113のサーバーに、TLSと事前共有キー(PSK)を使用して送信します。

参照

ドキュメント 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)

Documentation

zabbix_sender

名前

概要

説明

オプション

終了ステータス

例

参照

目次