[comment]: # ({3ae0a4ae-e0afbd96})
# 7 MQTTプラグイン 

[comment]: # ({/3ae0a4ae-e0afbd96})

[comment]: # ({b12cab0f-88abc321})
#### 概要

このセクションでは、MQTT Zabbixエージェント2プラグイン設定ファイル(mqtt.conf) でサポートされているパラメータを一覧表示します。

注意点:

-   デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。
-   Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。
-   行の先頭が"\＃"で始まった場合のみコメントとして認識されます。

[comment]: # ({/b12cab0f-88abc321})

[comment]: # ({7ffda252-97d87248})
#### パラメータ

|パラメータ|必須|範囲|デフォルト|説明|
|--|--|--|--|----------|
|Plugins.MQTT.Default.Password|no| | |MQTTに接続するためのデフォルトのパスワード。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.TLSCAFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化通信のピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。<br> バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.TLSCertFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化通信用のエージェント証明書または証明書チェーンを含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。<br> バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.TLSKeyFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化通信用の MQTT 秘密キーを含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。<br> バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.Topic|no| | |MQTT サブスクリプションのデフォルト トピック。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。<br><br>トピックにはワイルドカード ("+"、"#") を含めることができます。<br>例: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.Url|no| |tcp://localhost:1883|デフォルトのMQTTブローカー接続文字列。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。<br><br>クエリパラメーターを含めないでください。<br>URL 形式と一致する必要があります。<br>サポートされているスキーム: `tcp` (デフォルト)、`ws`、`tls`。スキームは省略できます。<br>ポートは省略できます (デフォルト = 1883)。<br>例: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Default.User|no| | |MQTT に接続するためのデフォルトのユーザー名。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.Password|no| | |名前付きセッションパスワード。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.TLSCAFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化された通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.TLSCertFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化通信に使用されるエージェント証明書または証明書チェーンを含むファイルのフルパス名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile|no| | |Zabbixエージェント2とMQTTブローカー間の暗号化通信に使用される MQTT 秘密キーを含むファイルのフルパス名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.Topic|no| | |MQTT サブスクリプションの名前付きセッショントピック。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br><br>トピックにはワイルドカード ("+"、"#") を含めることができます。<br>例: `path/to/file`<br>`path/to/#`<br>`path/+/topic`<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.Url|no| | |名前付きセッションの接続文字列。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br><br>クエリパラメーターを含めないでください。<br>URL 形式と一致する必要があります。<br>サポートされているスキーム: `tcp` (既定値)、`ws`、`tls`。スキームは省略できます。<br>ポートは省略できます (既定値 = 1883)。<br>例: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Sessions.<SessionName>.User|no| | |名前付きセッションユーザー名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。<br>バージョン6.0.19以降でサポートされています。|
|Plugins.MQTT.Timeout|no|1-30|global timeout|リクエストの実行タイムアウト(リクエストが完了するのを待ってからシャットダウンするまでの時間)|

参考情報:

-   一般的なZabbixエージェント2の設定パラメーターの説明: [Zabbixエージェント2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbixエージェント2 (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   [プラグイン](/manual/config/items/plugins)の設定手順

[comment]: # ({/7ffda252-97d87248})