7 MQTTプラグイン

概要

Zabbix エージェント 2 の設定ファイルは、プラグインを設定するために使用されます。MQTT プラグインの動作には、次の Zabbix エージェント 2 の設定パラメータがサポートされています。

これらは専用の設定ファイル（例: mqtt.conf）に指定し、その後 Include ディレクティブを使用してこのファイルを Zabbix エージェント 2 の設定に追加することを推奨します。

次の点に注意してください。

  • デフォルト値は、同梱されている設定ファイルの値ではなく、プロセスのデフォルトを反映しています。
  • 値は 環境変数 をサポートします。
  • Zabbix は、BOM なしの UTF-8 エンコーディングの設定ファイルのみをサポートします。
  • "#" で始まるコメントは、行頭でのみサポートされます。

パラメータ

Parameter Mandatory Range Default Description
Plugins.MQTT.Default.Password no MQTT 接続用のデフォルトパスワード。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。
Plugins.MQTT.Default.TLSCAFile no Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信におけるピア証明書検証用の、最上位 CA 証明書を含むファイルのフルパス。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.MQTT.Default.TLSCertFile no Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信における、エージェント証明書または証明書チェーンを含むファイルのフルパス。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.MQTT.Default.TLSKeyFile no Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信における MQTT 秘密鍵を含むファイルのフルパス。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.MQTT.Default.Topic no MQTT サブスクリプション用のデフォルトトピック。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

トピックにはワイルドカード ("+","#") を含めることができます。
例: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url no tcp://localhost:1883 デフォルトの MQTT ブローカー接続文字列。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

クエリパラメータを含めてはいけません。
URL 形式に一致している必要があります。
サポートされるスキーム: tcp (デフォルト), ws, tls; スキームは省略できます。
ポートは省略できます (default=1883)。
例: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User no MQTT 接続用のデフォルトユーザー名。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。
Plugins.MQTT.Sessions.<SessionName>.Password no 名前付きセッションのパスワード。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile no ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス。Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信で使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile no エージェント証明書または証明書チェーンを含むファイルのフルパス。Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信で使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile no MQTT 秘密鍵を含むファイルのフルパス。Zabbix エージェント 2 と MQTT ブローカー間の暗号化通信で使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MQTT.Sessions.<SessionName>.Topic no 名前付きセッションの MQTT サブスクリプション用トピック。
<SessionName> - アイテムキーで使用するセッション名を定義します。

トピックにはワイルドカード ("+","#") を含めることができます。
例: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url no 名前付きセッションの接続文字列。
<SessionName> - アイテムキーで使用するセッション名を定義します。

クエリパラメータを含めてはいけません。
URL 形式に一致している必要があります。
サポートされるスキーム: tcp (デフォルト), ws, tls; スキームは省略できます。
ポートは省略できます (default=1883)。
例: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User no 名前付きセッションのユーザー名。
<SessionName> - アイテムキーで使用するセッション名を定義します。

リクエストの実行タイムアウト（リクエストが完了するまで待機してから停止するまでの時間）を設定する必要がある場合は、アイテム設定 フォームを使用してください。

関連情報: