MySQL のモニター

このセンサーは、 Instana のホストエージェントと同じオペレーティングシステムに対応しています。 詳細については、各ホストエージェントの 「対応OS 」セクションを参照してください。例：

• Unix の対応OS
• Linux の対応OS
• Windows の対応OS

このセンサーは、以下のバージョンの MySQL: に対応しています

• 5.6.x
• 5.7.x
• 8.0.x
• 8.4.x
• 9.1.x

以下の表は、最新のサポート対象バージョンとサポート方針を示しています：

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

この技術において、 Instana は以下の言語およびランタイムのクライアントサイドトレースをサポートしています：

• Java
• Go
• Node.js
• PHP
• Python
• .NET Framework
• .Net Core

Instana エージェントが MySQL データベースに安全に接続するには、エージェントの設定ファイルで以下の設定を行 <agent_install_dir>/etc/instana/configuration.yamlってください：

com.instana.plugin.mysql:
  enabled: true
  user: '<username>'
  password: '<password>'
  poll_rate: 10 #Values are in seconds. Default Value 1 Sec.
  schema_excludes: ['INFORMATION_SCHEMA', 'PERFORMANCE_SCHEMA'] #optional
  sslKeyStore: '/path/to/keystore.jks'
  sslKeyStorePassword: '<keystore password>'
  #disableSslHostnameVerification: true

鍵は Java 鍵ストア 形式 (JKS) でなければなりません。 keytool を使用してこれらを作成できます。

新しいバージョンの MySQL （特に認証 caching_sha2_password を使用するバージョン）との互換性を確保するには、更新された MySQL Connector/Jドライバーを使用する必要があります：

1. 「 MySQL 」 のダウンロードページから、最新の MySQL Connector/Jドライバーをダウンロードしてください。

2. ダウンロードしたJARファイル（例： mysql-connector-j-9.6.0.jar）を、 Instana エージェントのデプロイディレクトリにコピーします：

   cp mysql-connector-j-9.6.0.jar <agent_install_dir>/deploy/

センサーが DBMS に関するパフォーマンス情報を収集できるようにするには、スキーマ PERFORMANCE_SCHEMA に対する読み取り専用アクセス権限が必要です。

• 8.0.0より前のバージョンの MySQL の場合、必要な権限を持つアカウントを作成する方法について、以下の例を参照してください。

  GRANT REPLICATION CLIENT ON *.* TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_waits_summary_global_by_event_name' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_statements_summary_by_digest' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_statements_summary_global_by_event_name' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'replication_connection_status' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
   

• MySQL バージョン 8.0.0 以降の場合、必要な権限を持つアカウントを作成する方法について、以下の例を参照してください。

  GRANT REPLICATION CLIENT ON *.* TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_waits_summary_global_by_event_name TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_statements_summary_by_digest TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_statements_summary_global_by_event_name TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.replication_connection_status TO '<instana_mon_user>'@'localhost';
   

• 8.0.0より前のバージョンの MySQL の場合、SQL ユーザーのすべてのデータベース・スキーマに PROCESS 権限を付与するには、以下のコマンドを実行します。

  GRANT PROCESS ON *.* TO <instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
   

• MySQL バージョン 8.0.0 以降の場合、SQL ユーザーのすべてのデータベース・スキーマに PROCESS 権限を付与するには、以下のコマンドを実行します。

  GRANT PROCESS ON *.* TO '<instana_mon_user>'@'localhost';
   

  アカウント名のホスト名部分は、 MySQL 構成によって異なります。

• これらのカウンターを使用可能にするには、以下のコマンドを実行します。

  SET GLOBAL innodb_monitor_enable = 'trx_nl_ro_commits';
  SET GLOBAL innodb_monitor_enable = 'trx_ro_commits';
  SET GLOBAL innodb_monitor_enable = 'trx_rollbacks';
  SET GLOBAL innodb_monitor_enable = 'trx_rw_commits';
   

ビルド 266 以降、 Instana は MySQL 8.0.0 以降のバージョンを自動的に監視します。 「 MySQL 」ドライバーのJARファイルを、「 Instana 」 エージェントのデプロイフォルダに手動で追加する必要はありません。

以前のビルドでは、ライセンス上の理由により、 Instana は MySQL 8.0.0以降を対象とした MySQL の自動監視機能を提供していません。 したがって、 Maven リポジトリから MySQL ドライバーのJARファイルを手動で取得し、コマンド <agent_install_dir>/deploy/ を使用してそれを Instanadeploy エージェントフォルダに追加する必要があります。 Maven リポジトリーから取得された MySQL ドライバー JAR ファイルには、バージョン 8.0.16 以降が必要です。

• プロセス ID
• ポート
• バージョン
• 開始時刻
• 役割
• 最大接続数

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

MySQL センサーの built-events については、 組み込みイベントのリファレンスを参照してください。

以下のようなエラー・メッセージが Instana エージェント・ログに表示される場合:

java.sql.SQLSyntaxErrorException: (conn=2) Table 'performance_schema.global_status' doesn't exist
 

おそらく、MySQL サーバー・コピーが、デフォルトでパフォーマンス・スキーマが無効になった状態でコンパイルされました。 これは 既知のバグです。

これを修正するには、MySQL CLI から有効化を試行できます。

mysql> set @@global.show_compatibility_56=ON;
Query OK, 0 rows affected (0.00 sec)
 

有効になっていることを確認します。

mysql>select @@show_compatibility_56;
+-------------------------+
| @@show_compatibility_56 |
+-------------------------+
|                       1 |
+-------------------------+
1 row in set (0.00 sec)
 

有効にすると、 mysql>show status; が機能するようになります。 Instana エージェントを再始動してください。

以下のようなエラー・メッセージが Instana エージェント・ログに表示される場合:

The server time zone value 'CEST' is unrecognized or represents more than one time zone.
You must configure either the server or JDBC driver (via the serverTimezone configuration property)
to use a more specifc time zone value if you want to utilize time zone support.
 

サーバーのタイム・ゾーンを構成する必要があります。

MySQL がホスト時間帯を適切に読み取らないため、これは 既知の問題 です。

このエラーは、「 MySQL Server Time Zone Support」の説明に従って修正できます。

以下のようなエラー・メッセージが Instana エージェント・ログに表示される場合:

Client does not support authentication protocol requested by server
 

caching_sha2_password メカニズムではなく、mysql_native_password を使用する必要があります。

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'
mysql> flush privileges;
 

Instana のホストエージェントのログに、次のようなエラーメッセージが表示されることがあります：

Agent could not connect to MySQL.  Could not connect: Access denied for user 'user'@'ipaddress/hostname' (using password: YES)
 

この場合、 MySQL 側で別のホスト名を使用するように MySQL ユーザーを変更する必要があります。 たとえば、 MySQL ユーザーを「 user@localhost」として作成した場合、エラーメッセージに記載されているとおり、 MySQL 側のユーザー名を「user」@「IPアドレスまたはホスト名」に変更する必要があります。その後、エージェントがホスト名を自動的に検出するため、エージェント設定ファイルの com.instana.plugin.mysql > user フィールドを、ホスト名を除いた「ユーザー名」で更新してください。 このエラーは、 MySQL がコンテナー内で実行された場合に発生する可能性があります。