このページで
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, Server‐
Active, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKey‐
File, TLSPSKIdentity and TLSPSKFile の各パラメータのみです。Host‐
nameItem パラメータで定義された Hostname は取得されないため、こ
の場合はコマンドラインでホスト名を指定する必要があります（-s オ
プションを参照）。エージェント の ServerActive 設定パラメータで
定義されたすべてのアドレスがデータ送信に使用されます。あるアド
レスへのバッチデータ送信に失敗した場合、以降のバッチはそのアド
レスには送信されません。
-z, --zabbix-server server
Zabbixサーバー のホスト名または IP アドレスを指定します。ホスト
が プロキシ によって監視されている場合は、代わりに プロキシ の
ホスト名または IP アドレスを使用する必要があります。--config と
一緒に使用した場合、agentd 設定ファイルで指定された ServerActive
パラメータのエントリを上書きします。
-p, --port port
サーバー 上で動作している Zabbix server 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" は送信する値で
す。agent 設定ファイルまたは --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> を含める必要があります。
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-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
IP 192.168.1.113 のサーバー に対して、Monitored Host ホストの
mysql.queries アイテム の値として 342.45 を、証明書を使用した
TLS で送信します。
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
IP 192.168.1.113 のサーバー に対して、Monitored Host ホストの
mysql.queries アイテム の値として 342.45 を、事前共有鍵（PSK）
を使用した TLS で送信します。
関連項目
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)