このページで
zabbix_sender
ZABBIX_SENDER(1) 一般コマンドマニュアル ZABBIX_SENDER(1)
名前
zabbix_sender - Zabbix送信ユーティリティ
概要
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] -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 タイプのアイテムを作成しておく必要があります。受信される値は、このアイテムの Allowed hosts フィールドで指定されたホストからのみ受け付けられることに注意してください。
オプション
-c, --config config-file
config-file を使用します。Zabbix sender は agentd の設定ファイルからサーバーの詳細を読み取ります。既定では、Zabbix sender は設定ファイルを読み取りません。サポートされるパラメータは Hostname、ServerActive、SourceIP、TLSConnect、TLSCAFile、TLSCRLFile、TLSServerCertIssuer、TLSServerCertSubject、TLSCertFile、TLSKeyFile、TLSPSKIdentity、TLSPSKFile のみです。HostnameItem パラメータで定義された Hostname は取得されません。この場合、ホスト名はコマンドラインで指定する必要があります（-s オプションを参照）。agent の ServerActive 設定パラメータで定義されたすべてのアドレスがデータ送信用に使用されます。バッチデータの送信がいずれかのアドレスで失敗した場合、以降のバッチはそのアドレスには送信されません。
-z, --zabbix-server server
Zabbix サーバーのホスト名または IP アドレスです。ホストがプロキシで監視されている場合は、代わりにプロキシのホスト名または IP アドレスを使用してください。--config と併用した場合、agentd 設定ファイルで指定された ServerActive パラメータのエントリを上書きします。
-p, --port port
サーバー上で動作している Zabbix サーバー trapper のポート番号を指定します。既定値は 10051 です。--config と併用した場合、agentd 設定ファイルで指定された ServerActive パラメータのポートエントリを上書きします。
-I, --source-address IP-address
送信元 IP アドレスを指定します。--config と併用した場合、agentd 設定ファイルで指定された SourceIP パラメータを上書きします。
-t, --timeout seconds
タイムアウトを指定します。有効範囲: 1-300 秒（既定値: 60）
-s, --host host
アイテムが属するホスト名を指定します（Zabbix Webインターフェースで登録されている名前）。ホストの 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 Webインターフェースに登録されている監視対象ホストの名前、"key" は送信先アイテムキー、"value" は送信する値です。<hostname> に - を指定すると、agent の設定ファイルまたは --host 引数のホスト名を使用します。
入力ファイルの行の例:
"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 オプションを参照してください。
タイムスタンプ付きの値が「no data」メンテナンスタイプのホストに送信された場合、その値は破棄されます。ただし、期限切れのメンテナンス期間にタイムスタンプ付きの値を送信することは可能であり、その場合は受け付けられます。
-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 識別子文字列です。
--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 を送信します。agent 設定ファイルで定義された監視対象ホストと Zabbix サーバーを使用します。
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
agent 設定ファイルで定義された Zabbix サーバーを使用して、Monitored Host ホストの mysql.queries アイテムの値として 342.45 を送信します。
zabbix_sender -z 192.168.1.113 -i data_values.txt
IP アドレス 192.168.1.113 の Zabbix サーバーに、data_values.txt ファイルから値を送信します。ホスト名とキーはファイル内で定義されます。
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -
agent 設定ファイルで指定された Zabbix サーバーに、コマンドラインからタイムスタンプ付きの値を送信します。入力データ内のダッシュは、ホスト名も同じ設定ファイルから使用することを示します。
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
コマンドラインから、IP アドレス 192.168.1.113 の Zabbix サーバーのポート 10000 にアイテムの空の値を送信します。空の値は空のダブルクォートで示す必要があります。
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 で、IP アドレス 192.168.1.113 のサーバーに、Monitored Host ホストの mysql.queries アイテムの値として 342.45 を送信します。
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
事前共有鍵（PSK）を使用した TLS で、IP アドレス 192.168.1.113 のサーバーに、Monitored Host ホストの mysql.queries アイテムの値として 342.45 を送信します。
関連項目
Documentation
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)