Documentation
Table of Contents
6 MongoDBプラグイン
概要
このセクションでは、MongoDB Zabbixエージェント2プラグイン設定ファイル(mongo.conf) でサポートされているパラメータを一覧表示します。
Zabbix 6.0.6 以降、MongoDB プラグインはロード可能なプラグインであり、MongoDB プラグイン リポジトリ で利用可能であり、詳細な説明が記載されています。
Windows 用のコンパイル済みプラグイン バイナリは Zabbix 6.0.19 以降で利用可能であり、以前の 6.0 バージョンと互換性があります。
注意点:
- デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。
- Zabbixの設定ファイルはBOMなしのUTF-8エンコーディングのみサポートします。
- 行の先頭が"＃"で始まった場合のみコメントとして認識されます。
オプション
| パラメータ | 説明 |
|---|---|
| -V --version | プラグインのバージョンとライセンス情報を表示します |
| -h --help | ヘルプ情報を表示します (省略形) |
パラメータ
Zabbix バージョン 6.0.6未満では、パラメータ名は Plugins.MongoDB.<Parameter> ではなく Plugins.Mongo.<Parameter> で始まります。たとえば、Plugins.Mongo.KeepAlive です。
| パラメータ | 必須 | 範囲 | デフォルト | 説明 |
|---|---|---|---|---|
| Plugins.MongoDB.Default.Password | no | MongoDB に接続するためのデフォルトのパスワード。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています |
||
| Plugins.MongoDB.Default.Uri | no | MongoDB に接続するためのデフォルトの URI。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 埋め込まれた資格情報を含めないでください (無視されます)。 URI 形式と一致する必要があります。 tcp スキームのみがサポートされています。スキームは省略できます。ポートは省略できます。(デフォルト = 27017) 例: tcp://127.0.0.1:27017、tcp:localhost、localhostバージョン6.0.18以降でサポートされています |
||
| Plugins.MongoDB.Default.User | no | MongoDB に接続するためのデフォルトのユーザー名。アイテムキーまたは名前付きセッションに値が指定されていない場合に使用されます。 バージョン6.0.18以降でサポートされています。 |
||
| Plugins.MongoDB.KeepAlive | no | 60-900 | 300 | 未使用のプラグイン接続が閉じられるまでの最大待機時間 (秒単位) |
| Plugins.MongoDB.Sessions.<SessionName>.Password | no | 名前付きセッション パスワード。 <SessionName> - アイテム キーで使用するセッションの名前を定義します。 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile | no (Plugins.MongoDB.Sessions.<SessionName>.TLSConnectにverify_ca、verify_fullのいずれかが設定されている場合、必須) |
Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフル パス名。 <SessionName> - アイテム キーで使用するセッションの名前を定義します。 プラグインバージョン6.0.13(1.2.0)以降でサポートされています。1 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile | 必須(Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile が指定されている場合) バージョン 6.0.24未満では、Plugins.MongoDB.Sessions.<SessionName>.TLSConnectにverify_ca、verify_full のいずれかが設定されている場合、常に必須です |
Zabbixエージェント2 と監視対象データベース間の暗号化通信に使用されるエージェント証明書または証明書チェーンを含むファイルのフル パス名。 <SessionName> - アイテム キーで使用するセッションの名前を定義します。 プラグインバージョン6.0.13(1.2.0)以降でサポートされています。1 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSConnect | no | Zabbix エージェント 2 と監視対象データベース間の通信の暗号化タイプ。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 サポートされる値: required - TLS 接続が必要です。 verify_ca - 証明書を検証します。 verify_full - 証明書とIPアドレスを検証します。 プラグインバージョン6.0.13(1.2.0)以降でサポートされています。1 |
||
| Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile | 必須(Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile が指定されている場合) バージョン6.0.24未満では、Plugins.MongoDB.Sessions.<SessionName>.TLSConnectにverify_ca、verify_fullのいずれかが設定されている場合、常に必須です。 |
Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用されるデータベース秘密キーを含むファイルの完全パス名。 <SessionName> - アイテム キーで使用するセッションの名前を定義します。 プラグインバージョン6.0.13(1.2.0)以降でサポートされています。1 |
||
| Plugins.MongoDB.Sessions.<SessionName>.Uri | no | 名前付きセッションの接続文字列。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 埋め込まれた資格情報を含めないでください (無視されます)。 URI 形式と一致する必要があります。 tcpスキームのみがサポートされています。スキームは省略できます。ポートは省略できます (デフォルト = 27017)。 例: tcp://127.0.0.1:27017、tcp:localhost、localhost |
||
| Plugins.MongoDB.Sessions.<SessionName>.User | no | 名前付きセッションユーザー名 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MongoDB.System.Path | no | 外部プラグイン実行ファイルへのパス。Zabbix 6.0.6以降でサポートされています | ||
| Plugins.MongoDB.Timeout | no | 1-30 | global timeout | リクエストの実行タイムアウト(リクエストが完了するのを待ってからシャットダウンするまでの時間) |
参考情報:
- 一般的なZabbixエージェント2の設定パラメーターの説明: Zabbixエージェント2 (UNIX) / Zabbixエージェント2 (Windows)
- プラグインの設定手順
脚注
1 - Zabbix 6.0.13以降、ロード可能なプラグインはZabbixと同じバージョンで管理されるようになりました。 これに伴い、MongoDBプラグインのバージョンが1.2.0から6.0.13に変更されました。