Table of Contents

zabbix_sender
- 名前
- 概要
- 説明
- オプション
  - 接続方法の値:
- 終了ステータス
- 例
- 参照
- 著者
- 目次

zabbix_sender

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

名前

zabbix_sender - Zabbix sender ユーティリティ

概要

zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] -k key -o value zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-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-address] [-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] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-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-address] [-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] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-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-address] [-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] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address] [-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-address] [-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] -i input-file
zabbix_sender -h
zabbix_sender -V

説明

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

オプション

-c, --config config-file
config-file を使用します。Zabbix senderは、エージェント設定ファイルからサーバーの詳細を読み取ります。デフォルトではZabbix senderは設定ファイルを読み取りません。以下のパラメーターのみががサポートされています。 Hostname,ServerActive,SourceIP,TLSConnect,TLSCAFile,TLSCRLFile,TLSServerCertIssuer,TLSServerCertSubject,*TLSCertFile,TLSKeyFile,TLSPSKIdentity,TLSPSKFile エージェント ServerActive** 設定パラメーターで定義されたすべてのアドレスは、データの送信に使用されます。 1 つのアドレスへのバッチデータの送信に失敗した場合、次のバッチはこのアドレスに送信されません。

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

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

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

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

-s, --host host
アイテムが属するホスト名を指定します (Zabbixフロントエンドに登録されている通り)。ホストの IP アドレスと DNS 名は機能しません。--config と一緒に使用すると、エージェント設定ファイルで指定された 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 引数からホスト名を使用します。

入力ファイルの行の例：

"Linux DB3" db.connections 43

Zabbixフロントエンドのアイテム設定で値の型を正しく設定する必要があります。 Zabbix センダーは 1 回の接続で最大 250 個の値を送信します。入力ファイルから値を送信する場合のサイズ制限は、Zabbix コミュニケーションプロトコルに記載されているサイズに依存します。入力ファイルの内容は、UTF-8 エンコーディングでなければなりません。入力ファイルの値は、すべて上から順に送信されます。エントリは次の規則に従ってフォーマットする必要があります：

•
引用されたエントリと引用されていないエントリがサポートされています。

•
二重引用符を引用文字として使用します。

•
空白を含むエントリは引用符で囲む必要があります。

•
引用符で囲まれたエントリ内の二重引用符とバックスラッシュ文字は、バックスラッシュでエスケープする必要があります。

•
引用符で囲まれていないエントリでは、エスケープはサポートされていません。

•
改行エスケープシーケンス (\n) は、引用符で囲まれた文字列でサポートされています。

•
改行エスケープシーケンスは、エントリの末尾から削除されます。

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

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

入力ファイルの行の例：

"Linux DB3" db.connections 1429533600 43

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

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

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

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

入力ファイルの行の例：

"Linux DB3" db.connections 1429533600 7402561 43

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

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

--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)

著者

Alexei Vladishev <[email protected]>

Documentation

zabbix_sender

名前

概要

説明

オプション

接続方法の値:

終了ステータス

例

参照

著者

目次