6 zabbix_senderコマンド

概要

Zabbix sender は、パフォーマンスデータを Zabbix サーバーに送信して処理させるために使用できるコマンドラインユーティリティです。

このユーティリティは通常、可用性データとパフォーマンスデータを定期的に送信する、長時間実行されるユーザースクリプトで使用されます。

結果を Zabbix サーバーまたはプロキシに直接送信するには、Zabbix trapper アイテムタイプを設定する必要があります。

また、Zabbix sender として動作する組み込み機能を備えた Zabbix 用 Python ライブラリ も参照してください。

Zabbix senderの実行

Zabbix UNIX senderの実行例:

cd bin
./zabbix_sender -z zabbix -s "Linux DB3" -k db.connections -o 43

各オプションの意味:

  • z - Zabbixサーバーのホスト(IPアドレスも使用できます);
  • s - 監視対象ホストの技術名(Zabbix Webインターフェースに登録されている名前);
  • k - アイテムキー;
  • o - 送信する値。

空白を含むオプションは、二重引用符で囲む必要があります。

Zabbix senderは、入力ファイルから複数の値を送信するために使用できます。 詳細は Zabbix sender manpage を参照してください。

設定ファイルが指定されている場合、Zabbix senderはデータ送信にエージェントの ServerActive 設定パラメータで定義されたすべてのアドレスを使用します。 1つのアドレスへの送信に失敗した場合、senderは他のアドレスへの送信を試みます。 バッチデータの送信が1つのアドレスに失敗した場合、その後のバッチはそのアドレスには送信されません。

Zabbix senderは、UTF-8エンコーディングの文字列を、ファイル先頭にバイト順マーク(BOM)なしで受け付けます(Unix系システムとWindowsの両方)。

Windows上のZabbix senderも同様に実行できます:

zabbix_sender.exe [options]

zabbix_sender のリアルタイム送信シナリオでは、短時間に連続して渡された複数の値を収集し、1回の接続でサーバーに送信します。 前の値から0.2秒以上離れていない値は同じスタックにまとめることができますが、最大ポーリング時間は引き続き1秒です。

指定された設定ファイルに無効な(parameter=value 形式に従っていない)パラメータエントリがある場合、Zabbix senderは終了します。

Zabbix sender を低レベルディスカバリで実行する

低レベルディスカバリ用の JSON 形式の値を送信するために Zabbix sender を実行する例:

./zabbix_sender -z 192.168.1.113 -s "Zabbix server" -k trapper.discovery.item -o '[{"{#FSNAME}":"/","{#FSTYPE}":"rootfs"},{"{#FSNAME}":"/sys","{#FSTYPE}":"sysfs"}]'

これを機能させるには、低レベルディスカバリルールのアイテムタイプが Zabbix trapper である必要があります(この例では、trapper.discovery.item キーを使用しています)。