Documentation
Table of Contents
8 MSSQLプラグイン
概要
このセクションでは、MSSQL Zabbixエージェント2プラグイン設定ファイル(mssql.conf) でサポートされているパラメータを一覧表示します。
MSSQL プラグインはロード可能なプラグインであり、MSSQL プラグイン リポジトリ で利用可能であり、詳細な説明が記載されています。 このプラグインは、Zabbix 6.0.27以降でサポートされています。 Windows用のコンパイル済みプラグインバイナリは、Zabbix 6.0.28 以降で利用可能であり、6.0.27バージョンと互換性があります。
注意点:
- デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。
- Zabbixの設定ファイルはBOMなしのUTF-8エンコーディングのみサポートします。
- 行の先頭が"＃"で始まった場合のみコメントとして認識されます。
パラメータ
| パラメータ | 必須 | 範囲 | デフォルト | 説明 |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | no | empty | プラグインが実行できるカスタム クエリを含むユーザー定義の .sql ファイルを含むディレクトリへのファイルパスを指定します。プラグインは、起動時に構成されたディレクトリ内のすべての使用可能な .sqlファイルをロードします。つまり、カスタムクエリ ファイルへの変更は、プラグインが再起動されるまで反映されません。プラグインは、Zabbixエージェント2とともに起動および停止されます。 | |
| Plugins.MSSQL.Default.CACertPath | no | MSSQLサーバの証明書を発行した証明機関 (CA) の公開キー証明書へのデフォルトのファイルパス。証明書は PEM 形式である必要があります。 | ||
| Plugins.MSSQL.Default.Database | no | 接続するデフォルトのデータベース名 | ||
| Plugins.MSSQL.Default.Encrypt | no | 既定の接続暗号化の種類を指定します。可能な値は次のとおりです: true - プラグインとサーバ間のデータ送信は暗号化されます。 false - プラグインとサーバ間のデータ送信は、ログインパケットを超えて暗号化されません。 strict - プラグインとサーバ間のデータ送信は、TDS8 を使用してE2Eで暗号化されます。 disable - プラグインとサーバ間のデータ送信は暗号化されません。 |
||
| Plugins.MSSQL.Default.HostNameInCertificate | no | デフォルトでは、MSSQLサーバの証明書の共通名 (CN) です。 | ||
| Plugins.MSSQL.Default.Password | no | デフォルトで保護された MSSQLサーバに送信されるパスワード | ||
| Plugins.MSSQL.Default.TLSMinVersion | no | デフォルトで使用する最小 TLS バージョン。使用可能な値:1.0、1.1、1.2、1.3 |
||
| Plugins.MSSQL.Default.TrustServerCertificate | no | プラグインがデフォルトでサーバ証明書を検証せずに信頼するかどうか。使用可能な値: true、false |
||
| Plugins.MSSQL.Default.Uri | no | sqlserver://localhost:1433 | 接続するデフォルトの URI。サポートされているスキーマは sqlserver:// のみです。スキーマは省略できます。埋め込まれた資格情報は無視されます。 |
|
| Plugins.MSSQL.Default.User | no | 保護された MSSQLサーバに送信されるデフォルトのユーザー名 | ||
| Plugins.MSSQL.KeepAlive | no | 60-900 | 300 | 未使用のプラグイン接続が閉じられるまでの最大待機時間(秒単位) |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | no | 名前付きセッションの MSSQLサーバの証明書を発行した証明機関 (CA) の公開キー証明書へのファイルパス。証明書は PEM 形式である必要があります。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | no | 名前付きセッションに接続するデータベース名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | no | 名前付きセッションの接続暗号化の種類を指定します。可能な値は次のとおりです: true - プラグインとサーバ間のデータ送信は暗号化されます。 false - プラグインとサーバ間のデータ送信は、ログイン パケットを超えて暗号化されません。 strict - プラグインとサーバ間のデータ送信は、TDS8 を使用してE2Eで暗号化されます。 disable - プラグインとサーバ間のデータ送信は暗号化されません。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | no | 名前付きセッションの MSSQLサーバの証明書の共通名 (CN)。 <SessionName> - 項目キーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | no | 名前付きセッションの保護された MSSQLサーバに送信されるパスワード。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | no | 名前付きセッションで使用する最小 TLS バージョン。使用可能な値: 1.0、1.1、1.2、1.3<SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | no | プラグインが、名前付きセッションに対して検証せずにサーバ証明書を信頼するかどうか。使用可能な値: true、false<SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | no | sqlserver://localhost:1433 | 名前付きセッションの接続先 URI。サポートされているスキーマは sqlserver:// のみです。スキーマは省略できます。埋め込まれた資格情報は無視されます。<SessionName> - 項目キーで使用するセッションの名前を定義します。 |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | no | 名前付きセッションの保護された MSSQLサーバに送信されるユーザー名。 <SessionName> - アイテムキーで使用するセッションの名前を定義します。 |
||
| Plugins.MSSQL.System.Path | no | MSSQL プラグイン実行可能ファイルへのパス。 MSSQL プラグインのグローバル設定。すべての接続に適用されます。 使用例: Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql |
||
| Plugins.MSSQL.Timeout | no | 1-30 | global timeout | セッションでの最初の接続時および後続の操作時にサーバが応答するのを待機する期間(秒単位) |
参考情報:
- 一般的なZabbixエージェント2の設定パラメーターの説明: Zabbixエージェント2 (UNIX) / Zabbixエージェント2 (Windows)
- プラグインの設定手順