MySQL Enterprise Plugin for Connector/J を使用すると、Connector/J JDBC ドライバを使用するどのアプリケーションでも、Query Analyzer の情報を自動的に直接 MySQL Enterprise Service Manager へ提供できるようになります。既存の Connector/J ドライバと組み合わせてプラグインライブラリをインストールすると、情報が MySQL Enterprise Service Manager に送信されて解析されます。 この機能を有効にするために、使用するアプリケーションを修正したり変更したりする必要はありません。

必要条件

インストール

使用中の MySQL Connector/J のバージョンから見えるアプリケーションの CLASSPATH 内に、jar ファイル lib/cj-query-analyzer-plugin-[version].jar を配置します。 この場所は、可能であれば MySQL Connector/J の jar ファイルと同じ場所か、MySQL Connector/J の jar ファイルの場所の親クラスローダー内にしてください。

解析対象アプリケーションの CLASSPATH に Apache Commons Logging がない場合、アプリケーションの CLASSPATH 内に lib/required/commons-logging-1.1.1.jar ファイルもインストールします。アプリケーションのほかのコンポーネントがどれも Apache Commons Logging を使用しない場合、Query Analyzer プラグインをインストールした場所と同じ場所にインストールします。

構成

必須 jar ファイルが配備されたら、Query Analyzer プラグインを使用および設定するために、jdbc の接続 URL を修正する必要があります。解析対象アプリケーションが使用する URL に、次のプロパティおよび対応する値を追加する必要があります。

Connector/J プロパティの詳細については、Connector/J (JDBC) Referenceを参照してください。

SSL を使用して MySQL Enterprise Service Manager とクエリ情報を通信する場合、次のプロパティを使用して設定できます。初期設定では、プラグインは Enterprise Monitor に含まれる自己署名付き証明書で機能するように設定されています。このため、サービスマネージャの URL が https:// で始まっている場合、プラグインから送信される情報の機密性が確保されます。しかし、この構成では、プラグインは中間者攻撃を防げず、またクライアント側の証明書による認証もサポートしていません。これらの機能を有効にするには、次のパラメータのデフォルト以外の値を参照してください。

たとえば、ポート 18080 で、エージェントユーザ名「agent」とパスワード「PASSWORD」を使用して、MySQL Enterprise Service Manager のローカルホストと通信するように Connector/J を設定するには、次のオプションを接続文字列に追加します。

statementInterceptors=com.mysql.etools.jdbc.StatementPerformanceCounters»
    &serviceManagerUrl=http://localhost:18080/»
    &serviceManagerUser=agent»
    &serviceManagerPassword=PASSWORD

JDBC URLにアプリケーションに固有のオプションを指定しなければならないことに注意してください。たとえば、次のコードの一部は、localhostのMySQLデータベースtestにmysqltestのユーザーとパスワードを使用して接続し、クエリデータを収集しそれをlocalhostの MySQL Enterprise Service Manager へ送信します。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

Connection conn = null;
...
try {
    conn =
       DriverManager.getConnection("jdbc:mysql://localhost/test?" +
                                   "user=mysqltest" + 
                                   "&password=mysqltest" +
                                   "&statementInterceptors=com.mysql.etools.jdbc.StatementPerformanceCounters" +
                                   "&serviceManagerUrl=http://localhost:18080/" + 
                                   "&serviceManagerUser=agent" + 
                                   "&serviceManagerPassword=PASSWORD"
                                   );

    // Do something with the Connection

   ...
} catch (SQLException ex) {
    // handle any errors
}

Connector/J に代わりのロギングシステムが選択されていない場合、URL または DataSource に次のプロパティを追加して、Connector/J のログファクトリが標準ロガー以外のものを使用するように設定することをお勧めします。

Enterprise Service Manager ユーザインタフェースの「Query Analyzer」タブを使用して、プラグインに関するほかの設定が行えます。ここから、プラグインが存在する特定の MySQL インスタンスに対して、クエリパフォーマンスデータの取り込みを有効または無効にできます。さらに、取り込むレベルの詳細、要約、例 (ソースコードの場所付き)、および EXPLAIN 計画も設定できます。

Query Analyzer プラグインは、1 分に 1 回 (収集したデータの報告中に) 設定を確認するため、設定の変更はすぐには反映されません。

使用上の注意

MySQL Enterprise Plugin for Connector/Jを使用する場合、以下のことに注意する必要があります。