このページで
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 はエージェントの設定ファイルからサーバーの詳細を読み取ります。既定では、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" は送信する値です。<hostname> に - を指定すると、エージェントの設定ファイルまたは --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> を含める必要があります。timestamp は Unix タイムスタンプ形式で指定します。送信先アイテムにそれを参照するトリガーがある場合、すべての timestamp は昇順でなければなりません。そうでない場合、イベント計算が正しく行われません。
入力ファイルの行の例:
"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 を送信します。エージェントの設定ファイルで定義された監視対象ホストと 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
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 -
コマンドラインから、エージェントの設定ファイルで指定された 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 で、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)