8 MSSQLプラグイン

概要

Zabbix agent 2の設定ファイルは、プラグインの設定に使用されます。これらのZabbix agent 2の設定パラメータは、MSSQLプラグインの操作に対応しています。

これらのパラメータは独自の設定ファイル（例：mssql.conf）に指定し、このファイルをZabbix agent 2の設定に追加するためにIncludeディレクティブを使用することを推奨します。

MSSQLプラグインはロード可能なプラグインであり、MSSQLプラグインリポジトリで利用可能で、完全に説明されています。

注意事項：

デフォルト値はプロセスのデフォルト値を反映しており、配布されている設定ファイルの値ではありません。
値は環境変数をサポートします。
ZabbixはUTF-8エンコーディング（BOMなし）の設定ファイルのみをサポートします。
「#」で始まるコメントは、行の先頭でのみサポートされます。

オプション

パラメータ	説明
-V --version	プラグインのバージョンとライセンス情報を表示します。
-h --help	ヘルプ情報を表示します（省略形）。
-t, --test <item key>	テストのためにプラグインを起動します（プラグイン設定は無視されます）。

パラメータ

パラメータ	必須	範囲	デフォルト	説明
Plugins.MSSQL.CustomQueriesDir	いいえ		Unixシステムの場合は`/usr/local/share/zabbix/custom-queries/mssql` Windowsシステムの場合は`:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL`（``は`ProgramFiles`環境変数のドライブ名）	プラグインが実行できるカスタムクエリを含むユーザー定義の.sqlファイルが格納されているディレクトリへのファイルパスを指定します。プラグインは起動時に設定されたディレクトリ内のすべての.sqlファイルを読み込みます。つまり、カスタムクエリファイルへの変更は、プラグインを再起動するまで反映されません。プラグインはZabbix agent 2と一緒に起動および停止します。
Plugins.MSSQL.CustomQueriesEnabled	いいえ		false	設定されている場合、`mssql.custom.query`アイテムキーの実行を有効にします。無効にすると、カスタムクエリディレクトリパスからクエリは読み込まれません。
Plugins.MSSQL.Default.CACertPath	いいえ			MSSQLサーバーの証明書を発行した認証局（CA）の公開鍵証明書へのデフォルトのファイルパス。証明書はPEM形式である必要があります。
Plugins.MSSQL.Default.Database	いいえ			接続するデフォルトのデータベース名。
Plugins.MSSQL.Default.Encrypt	いいえ			デフォルトの接続暗号化タイプを指定します。可能な値は: true - プラグインとサーバー間のデータ送信が暗号化されます; false - ログインパケット以外のプラグインとサーバー間のデータ送信は暗号化されません; strict - TDS8を使用してプラグインとサーバー間のデータ送信がE2Eで暗号化されます; disable - プラグインとサーバー間のデータ送信は暗号化されません。
Plugins.MSSQL.Default.HostNameInCertificate	いいえ			デフォルトでのMSSQLサーバー証明書のコモンネーム（CN）。
Plugins.MSSQL.Default.Password	いいえ			デフォルトで保護されたMSSQLサーバーに送信されるパスワード。
Plugins.MSSQL.Default.TLSMinVersion	いいえ			デフォルトで使用する最小TLSバージョン。可能な値は: `1.0`, `1.1`, `1.2`, `1.3`。
Plugins.MSSQL.Default.TrustServerCertificate	いいえ			デフォルトでプラグインがサーバー証明書を検証せずに信頼するかどうか。可能な値: `true`, `false`。
Plugins.MSSQL.Default.Uri	いいえ		sqlserver://localhost:1433	デフォルトの接続URI。サポートされているスキーマは`sqlserver://`のみです。スキーマは省略可能です。埋め込み認証情報は無視されます。
Plugins.MSSQL.Default.User	いいえ			デフォルトで保護されたMSSQLサーバーに送信されるユーザー名。
Plugins.MSSQL.KeepAlive	いいえ	60-900	300	未使用のプラグイン接続が閉じられるまでの最大待機時間（秒単位）。
Plugins.MSSQL.Sessions.<SessionName>.CACertPath	いいえ			指定したセッションのMSSQLサーバー証明書を発行した認証局（CA）の公開鍵証明書へのファイルパス。証明書はPEM形式である必要があります。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.Database	いいえ			指定したセッションで接続するデータベース名。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.Encrypt	いいえ			指定したセッションの接続暗号化タイプを指定します。可能な値は: true - プラグインとサーバー間のデータ送信が暗号化されます; false - ログインパケット以外のプラグインとサーバー間のデータ送信は暗号化されません; strict - TDS8を使用してプラグインとサーバー間のデータ送信がE2Eで暗号化されます; disable - プラグインとサーバー間のデータ送信は暗号化されません。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate	いいえ			指定したセッションのMSSQLサーバー証明書のコモンネーム（CN）。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.Password	いいえ			指定したセッションで保護されたMSSQLサーバーに送信されるパスワード。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion	いいえ			指定したセッションで使用する最小TLSバージョン。可能な値は: `1.0`, `1.1`, `1.2`, `1.3`。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate	いいえ			指定したセッションでプラグインがサーバー証明書を検証せずに信頼するかどうか。可能な値: `true`, `false`。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.Uri	いいえ		sqlserver://localhost:1433	指定したセッションの接続URI。サポートされているスキーマは`sqlserver://`のみです。スキーマは省略可能です。埋め込み認証情報は無視されます。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.Sessions.<SessionName>.User	いいえ			指定したセッションで保護されたMSSQLサーバーに送信されるユーザー名。 <SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.MSSQL.System.Path	いいえ			MSSQLプラグイン実行ファイルへのパス。 MSSQLプラグインのグローバル設定。すべての接続に適用されます。使用例: `Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql`
Plugins.MSSQL.Timeout	いいえ	1-30	グローバルタイムアウト	最初の接続時およびセッション内の後続操作でサーバーの応答を待機する秒数。

Documentation

8 MSSQLプラグイン

概要

オプション

パラメータ