9 MySQLプラグイン

概要

Zabbixエージェント 2 の設定ファイルは、プラグインを設定するために使用されます。これらの Zabbixエージェント 2 の設定パラメータは、MySQL プラグインの運用でサポートされています。

これらは専用の設定ファイル（例: mysql.conf）に指定し、その後 Include ディレクティブを使用して、このファイルを Zabbixエージェント 2 の設定に追加することを推奨します。

以下の点に注意してください。

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

パラメータ

Parameter Mandatory Range Default Description
Plugins.Mysql.CallTimeout no 1-30 global timeout リクエストの完了を待機する最大時間（秒）。
Plugins.Mysql.CustomQueriesPath no Unixシステムでは /usr/local/share/zabbix/custom-queries/mysql

Windowsシステムでは *:\Program Files\Zabbix Agent 2\Custom Queries\Mysql。ここで * は ProgramFiles 環境変数のドライブ名です		 カスタムクエリを含む .sql ファイルが格納されたディレクトリのフルパス名。
Plugins.Mysql.CustomQueriesEnabled no false 設定すると、mysql.custom.query アイテムキーの実行を有効にします。無効な場合、カスタムクエリディレクトリパスからクエリは読み込まれません。
Plugins.Mysql.Default.Password no MySQL 接続用のデフォルトパスワード。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。
Plugins.Mysql.Default.TLSCAFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)		 Zabbix agent 2 と監視対象データベース間の暗号化通信において、ピア証明書の検証に使用する最上位 CA 証明書を含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.Mysql.Default.TLSCertFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)		 Zabbix agent 2 と監視対象データベース間の暗号化通信に使用するエージェント証明書または証明書チェーンを含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.Mysql.Default.TLSConnect no Zabbix agent 2 と監視対象データベース間の通信に使用する暗号化タイプ。名前付きセッションで値が指定されていない場合に使用されます。

サポートされる値:
required - TLS 接続を必須にする;
verify_ca - 証明書を検証する;
verify_full - 証明書と IP アドレスを検証する。
Plugins.Mysql.Default.TLSKeyFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)		 Zabbix agent 2 と監視対象データベース間の暗号化通信に使用するデータベース秘密鍵を含むファイルのフルパス名。名前付きセッションで値が指定されていない場合に使用されます。
Plugins.Mysql.Default.Uri no tcp://localhost:3306 MySQL 接続用のデフォルト URI。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

埋め込み認証情報を含めないでください（含まれていても無視されます）。
URI 形式に一致している必要があります。
サポートされるスキーム: tcp, unix。スキームは省略できます。
ポートは省略できます（デフォルト=3306）。
例: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User no MySQL 接続用のデフォルトユーザー名。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。
Plugins.Mysql.KeepAlive no 60-900 300 未使用のプラグイン接続を閉じるまでの最大待機時間（秒）。
Plugins.Mysql.Sessions.<SessionName>.Password no 名前付きセッションのパスワード。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 ピア証明書の検証に使用する最上位 CA 証明書を含むファイルのフルパス名。Zabbix agent 2 と監視対象データベース間の暗号化通信に使用されます。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified Zabbix agent 2 と監視対象データベース間の暗号化通信に使用するエージェント証明書または証明書チェーンを含むファイルのフルパス名。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.Mysql.Sessions.<SessionName>.TLSConnect no Zabbix agent 2 と監視対象データベース間の通信に使用する暗号化タイプ。
<SessionName> - アイテムキーで使用するセッション名を定義します。

サポートされる値:
required - TLS 接続を必須にする;
verify_ca - 証明書を検証する;
verify_full - 証明書と IP アドレスを検証する。
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified Zabbix agent 2 と監視対象データベース間の暗号化通信に使用するデータベース秘密鍵を含むファイルのフルパス名。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.Mysql.Sessions.<SessionName>.Uri no 名前付きセッションの接続文字列。
<SessionName> - アイテムキーで使用するセッション名を定義します。

埋め込み認証情報を含めないでください（含まれていても無視されます）。
URI 形式に一致している必要があります。
サポートされるスキーム: tcp, unix。スキームは省略できます。
ポートは省略できます（デフォルト=3306）。
例: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User no 名前付きセッションのユーザー名。
<SessionName> - アイテムキーで使用するセッション名を定義します。
Plugins.Mysql.Timeout no 1-30 global timeout 接続を確立する必要がある場合の最大待機時間（秒）。

関連項目: