このページで
zabbix_sender
ZABBIX_SENDER(1) 一般コマンドマニュアル ZABBIX_SENDER(1)
名前
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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher 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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher 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のみです。HostnameItemパラメータで定義された
Hostnameは取得されません。この場合、ホスト名をコマンドラインで指定する
必要があります（-sオプションを参照）。エージェントのServerActive設定
パラメータで定義されたすべてのアドレスがデータ送信に使用されます。
バッチデータの送信がいずれかのアドレスで失敗した場合、それ以降の
バッチはそのアドレスには送信されません。
-z, --zabbix-server server
Zabbixサーバーのホスト名またはIPアドレス。ホストがプロキシによって
監視されている場合は、プロキシのホスト名またはIPアドレスを使用する
必要があります。--configと併用した場合、エージェントの設定ファイル
で指定されたServerActiveパラメータのエントリを上書きします。
-p, --port port
サーバー上で実行されているZabbixサーバーのtrapperのポート番号を
指定します。デフォルトは10051です。--configと併用した場合、エージェント
の設定ファイルで指定されたServerActiveパラメータのポートエントリを
上書きします。
-I, --source-address IP-address
送信元IPアドレスを指定します。--configと併用した場合、エージェントの
設定ファイルで指定されたSourceIPパラメータを上書きします。
-t, --timeout seconds
タイムアウトを指定します。有効範囲: 1～300秒（デフォルト: 60）
-s, --host host
アイテムが属するホスト名を指定します（ZabbixのWebインターフェースに
登録されている名前）。ホストの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のWebインターフェースに登録されている監視対象ホストの名前、
「key」は対象アイテムのキー、「value」は送信する値です。エージェント
設定ファイルまたは--host引数のホスト名を使用するには、<hostname>として
-を指定します。
入力ファイルの行の例:
"Linux DB3" db.connections 43
値のタイプは、ZabbixのWebインターフェースのアイテム設定で正しく設定
する必要があります。Zabbix senderは1つの接続で最大250個の値を送信します。
入力ファイルの内容はUTF-8エンコーディングでなければなりません。入力
ファイルのすべての値は、上から下へ順番に送信されます。エントリは次の
ルールに従ってフォーマットする必要があります。
• 引用符付きエントリと引用符なしエントリを使用できます。
• 二重引用符が引用文字です。
• 空白を含むエントリは引用符で囲む必要があります。
• 引用符付きエントリ内の二重引用符およびバックスラッシュ文字は、
バックスラッシュでエスケープする必要があります。
• 引用符なしエントリではエスケープはサポートされません。
• 引用符付き文字列では、改行エスケープシーケンス（\n）が
サポートされます。
• エントリ末尾の改行エスケープシーケンスは削除されます。
-T, --with-timestamps
このオプションは--input-fileオプションとの併用時のみ使用できます。
入力ファイルの各行には、空白で区切られた4つのエントリ
<hostname> <key> <timestamp> <value>を含める必要があります。タイムスタンプ
は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-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のみ）。デフォルトの暗号スイート選択基準を上書きします。
-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
TLSと証明書を使用して、Monitored Hostホストのmysql.queriesアイテムの
値として342.45を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
TLSと事前共有鍵（PSK）を使用して、Monitored Hostホストのmysql.queries
アイテムの値として342.45をIPアドレス192.168.1.113のサーバーに送信します。
関連項目
ドキュメント
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8),
zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
Zabbix 2022-01-06 ZABBIX_SENDER(1)