MySQLプラグイン

概要

設定パラメータを使用すると、MySQLプラグインの動作をカスタマイズできます。

これらは agent 2 の設定ファイルではなく、専用の設定ファイル（例: mysql.conf）に指定することを推奨します。その後、Include ディレクティブを使用して、このファイルを Zabbix agent 2 の設定に含めます。

すべてのパラメータは、パラメータが必須であると明記されていない限り、任意です。

このページの構成は次のとおりです。

• パラメータ概要（パラメータの詳細を表示するには、名前をクリックしてください）
• パラメータ詳細

注意事項:

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

パラメーターの詳細

Plugins.Mysql.CallTimeout

リクエストの完了を待機する最大時間を秒単位で指定します。

デフォルト: global timeout
範囲: 1-30

Plugins.Mysql.CustomQueriesPath

カスタムクエリを含む .sql ファイルが格納されたディレクトリの完全なパス名を指定します。

デフォルト:
/usr/local/share/zabbix/custom-queries/mysql - Unix システムの場合。
*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql - Windows システムの場合（ここで * は ProgramFiles 環境変数のドライブ名です）

Plugins.Mysql.CustomQueriesEnabled

mysql.custom.query アイテムキーの実行を有効にします。
無効の場合、カスタムクエリディレクトリのパスからクエリは読み込まれません。

デフォルト: false
範囲: true/false

Plugins.Mysql.Default.Password

保護された MySQL サーバーのデフォルトパスワードを指定します。

Plugins.Mysql.Default.TLSConnect

Zabbix エージェント 2 と監視対象データベース間の通信に対するデフォルトの暗号化レベルを指定します。

範囲:
required - TLS 接続を必須にする;
verify_ca - 証明書を検証する;
verify_full - 証明書と IP アドレスを検証する

Plugins.Mysql.Default.TLSCAFile

Zabbix エージェント 2 と監視対象データベース間の暗号化通信で使用される、ピア証明書の検証用に最上位 CA 証明書を含むファイルのフルパスを指定します。

必須: yes。Plugins.Mysql.Default.TLSConnect が verify_ca または verify_full に設定されている場合。

Plugins.Mysql.Default.TLSCertFile

Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用される、エージェント証明書または証明書チェーンを含むファイルのフルパス名を指定します。

必須: yes、Plugins.Mysql.Default.TLSKeyFile が指定されている場合

Plugins.Mysql.Default.TLSKeyFile

Zabbix エージェント 2 と監視対象のデータベース間での暗号化通信に使用される、データベースの秘密鍵を含むファイルの完全なパス名を指定します。

必須: yes、Plugins.Mysql.Default.TLSCertFile が指定されている場合

Plugins.Mysql.Default.Uri

MySQLサーバーに接続するためのデフォルトURIを指定します。
埋め込み資格情報は無視されます。
サポートされるスキーム: tcp, unix
スキーマは省略できます。
ポートも省略できます（デフォルト=3306）。

例:

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock

Plugins.Mysql.Default.User

保護された MySQL サーバーのデフォルトのユーザー名を指定します。

Plugins.Mysql.KeepAlive

未使用のプラグイン接続を切断するまでの最大待機時間を秒単位で指定します。

デフォルト: 300
範囲: 60-900

Plugins.Mysql.Sessions.<SessionName>.Password

保護された MySQL サーバーに対する、指定したセッションのパスワードを設定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。

Plugins.Mysql.Sessions.<SessionName>.TLSConnect

Zabbix エージェント 2 と監視対象データベース間の通信に対する、名前付きセッションの暗号化レベルを指定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。

範囲:
required - TLS 接続を必須にする;
verify_ca - 証明書を検証する;
verify_full - 証明書と IP アドレスを検証する

Plugins.Mysql.Sessions.<SessionName>.TLSCAFile

名前付きセッションのピア証明書検証に使用する、最上位 CA 証明書を含むファイルのフルパスを指定します。これは、Zabbix エージェント 2 と監視対象データベース間の暗号化通信で使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。

必須: yes、Plugins.Mysql.Sessions.<SessionName>.TLSConnect が verify_ca または verify_full に設定されている場合

Plugins.Mysql.Sessions.<SessionName>.TLSCertFile

名前付きセッションのエージェント証明書または証明書チェーンを含むファイルの完全なパス名を指定します。これは、Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。

必須: yes、Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile が指定されている場合

Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile

名前付きセッションのデータベース秘密鍵を含むファイルの完全なパス名を指定します。これは、Zabbix エージェント 2 と監視対象データベース間の暗号化通信に使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。

必須: yes、Plugins.Mysql.Sessions.<SessionName>.TLSCertFile が指定されている場合

Plugins.Mysql.Sessions.<SessionName>.Uri

MySQLサーバーに接続するための、名前付きセッションのURIを指定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。
埋め込みの認証情報は無視されます。
サポートされるスキーム: tcp, unix
スキームは省略できます。
ポートも省略できます（default=3306）。

例:

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock

Plugins.Mysql.Sessions.<SessionName>.User

保護された MySQL サーバーに対して、指定したセッションのユーザー名を設定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。

Plugins.Mysql.Timeout

接続を確立する必要がある場合に、待機する最大時間を秒単位で設定します。

デフォルト: global timeout
範囲: 1-30

関連項目

• 一般的な Zabbix エージェント 2 の設定パラメータの説明: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• プラグイン の設定手順