インストール中に設定した Proxy ポートと通信するようにアプリケーションを変更します。この場合、アプリケーションコードを変更する必要があります。また、場合によっては、アプリケーションを停止して再起動する必要もあります。ただし、MySQL サーバの変更は必要ありません。詳細については、項9.1.1. 「アプリケーションを変更して Query Analyzer を有効にする」を参照してください。

MySQL サーバのリスンポートを変更して、元の MySQL サーバポートでリスンするように Agent を設定します。アプリケーションを変更する必要はありませんが、MySQL サーバをシャットダウンして再起動する必要があります。これにより、キャッシュおよびパフォーマンスに影響を及ぼすおそれがあります。詳細については、項9.1.2. 「MySQL Server を変更して Query Analyzer を有効にする」を参照してください。

IP テーブルを使用して、ネットワークパケットをエージェントにリダイレクトします。

proxy プラグインを plugins パラメータに追加します。

plugins=proxy,agent

quan.lua アイテムファイルが agent-item-files 設定プロパティで有効にされていることを確認します。

agent-item-files = share/mysql-proxy/items/quan.lua,share/mysql-proxy/items/items-mysql-monitor.xml

proxy-address、proxy-backend-addresses、proxy-lua-script を確認して、次のように設定されているか確認します。

proxy-address=:4040
proxy-backend-addresses = 127.0.0.1:3306
proxy-lua-script        = share/mysql-proxy/quan.lua

エージェントを介して接続され、Query Analzer 情報を報告する必要があるアプリケーション内で設定されている各ユーザが、エージェントが実行するホストからサーバに接続できるようにする必要があります。このユーザがエージェントに接続し、エージェントがサーバに接続する場合、接続中の識別クライアントホスト名として、エージェントのホストが使用されます。

ユーザ権限を更新するには、GRANT ステートメントを使用する必要があります。次に例を示します。

mysql> GRANT SELECT,UPDATE,INSERT on database.* to 'user'@'localhost' IDENTIFIED BY 'password';

アプリケーションユーザは、mysql.inventory テーブルでの SELECT 権限が必要です。このテーブルには、サーバ UUID が含まれています。これは Query Analyzer データを MySQL Enterprise Service Manager に報告するときに必要です。これを有効にするには、GRANT オプションを使用します。

mysql> GRANT SELECT on mysql.inventory to 'user'@'localhost' IDENTIFIED BY 'password';

「クエリ情報」タブ:

図 9.4. クエリの「クエリ情報」タブ

このテーブルに表示される要約情報のほか、最小時間、最大時間、平均時間、合計時間、標準偏差など、実行に関する詳細な統計情報を参照できます。標準偏差を参照すると、指定クエリの回数の正規分布から外れているクエリ呼び出しを判別できます。

行統計情報は、クエリにより返された行の最大数、最小数、平均数、合計数、標準偏差に関する詳細な情報、および返されたデータの合計サイズと最大サイズを提供します。合計および平均の期間は、「実行時間統計」の下に表示されます。

クエリの詳細ビューには、クエリの 3 種類のビューも表示されます。truncated バージョンは、クエリの短縮バージョンです。クエリの full バージョンは、完全なクエリステートメントです。正規化では、個々のクエリから定数が削除されます。これにより、論理的構造が同じクエリは、同じ基本クエリに識別されます。

クエリの詳細ウィンドウを閉じるには、「閉じる」ボタンをクリックします。

指定クエリの識別を簡単にするため、クエリのエイリアスを作成できます。このエイリアスは、「Query Analyzer」テーブルで正規化されたクエリテキストの代わりに使用されます。クエリのエイリアスを作成するには、そのクエリで「エイリアスを作成」リンクをクリックします。

「クエリ例」タブ:

図 9.5. クエリの「クエリ例」タブ

「クエリ例」タブには、実行時間から求められた、最もパフォーマンスコストがかかったクエリの詳細が表示されます。

実行されたフルクエリとデータのほか、このタブには、指定クエリの実行時間、データ、ユーザ、スレッド ID、クライアントホスト、実行ホストが表示されます。

「EXPLAINクエリ」タブ:

図 9.6. クエリの「EXPLAINクエリ」タブ

「EXPLAINクエリ」タブでは、EXPLAIN プレフィックスでクエリを実行してその結果を表示できます。詳細については、EXPLAIN Syntaxを参照してください。

「検索タイプ」、「クエリ検索」。正規化されたクエリのテキスト検索をサポートします。検索タイプには、基本テキスト検索、または正規表現検索のいずれかを指定できます。基本テキスト検索のほか、特定の文字列を含まないクエリを検索することもできます。正規表現検索の場合、正規表現がクエリに一致するか、または一致しないか（非正規表現）を指定できます。正規表現は、標準の MySQL REGEXP() 関数を使用して構文解析されます。詳細については、Regular Expressionsを参照してください。

データベース - 特定のデータベース内に実行されたクエリに制限します。データベース一致は、MySQL データベースから LIKE 検索を使用して実行されます。そのため、複数および単一の文字検索に % および _ 文字を使用できます。詳細については、Pattern Matchingを参照してください。

「表示タイプ」 - このメニューでは、フィルタリングの時間選択を時間 interval に基づいて実行するか（「時間」および「分」ポップアップを使用して、表示される期間内に記録されたクエリのみが示されます）、期間（開始/終了）に基づいて実行するかを指定できます。

「間隔」モードを使用すると、グラフが更新された時点からの指定期間内のクエリが表示されます。たとえば、30 分を選択した場合、30 分以内にキャプチャされたクエリが表示されます。このとき、表示を 14:00 に更新した場合、13:00 から 14:00 にキャプチャされたクエリが表示されます。「間隔」モードを使用すると、フィルタ選択の期間を最大 23 時間 59 分に制限できます。

「開始/終了」モードを使用すると、特定の日付および時刻の間のクエリを表示できます。このモードを使用すると、特定の期間中に受け取ったクエリのみを表示できます。また、クエリ解析情報を記録している場合、さらに長い期間のクエリ履歴を表示できます。

「表示」-すべての監視対象サーバで実行された同じクエリをまとめて表示するように、「グループ」に基づいて情報を返すか、または「サーバ」に基づいて個々のサーバでクエリを要約するかを指定できます。「サーバ」を選択した場合、テーブルには、サーバを表示する追加のカラムが含まれます。

「クエリタイプ」-クエリをフィルタリングするクエリのタイプを選択できます。「全てl」を選択すると、すべてのクエリが表示されます。選択できる追加クエリのタイプは、SELECT、INSERT、UPDATE およびその他のメイン SQL クエリタイプです。

「上限」-各ページ内に表示されるクエリの数を指定できます。

実行カウント — 実行回数が多い場合、特に、頻繁には実行されないと思われるクエリでは、アプリケーションが簡単なクエリを頻繁に実行しているか、または別の方法でキャッシュに入れられるクエリを複数回実行している可能性があります。この場合、通常の実行率に比べ、短期間で実行回数が大きく増加しているクエリに注意する必要があります。

特定方法: ソート機能を使用して、実行回数によりクエリをソートします。

新規クエリ — 「Query Analyzer」タブに表示される新しいクエリは、特に、他のクエリが数時間または数日表示された後で表示される場合、いくつかの問題を示していることがあります。

実行時間 — 実行時間が長い場合、および平均実行時間と比較して最大実行時間が長い場合、特定のクエリおよび特定のパラメータで問題が発生している可能性があります。

特定方法: ソート機能を使用して、実行回数によりクエリをソートします。

Agentログと MySQL Enterprise Service Manager内のでサーバのステータスをチェックして、エージェントが実行しているか確認します。

各エージェントの設定ファイルをバックアップします。次のことを確認します。

完全な設定ファイル（mysql-monitor-agent.ini）の例を次に示します。この例は、MySQL バックエンドサーバとして 127.0.0.1 を使用し、monitor という名前の MySQL Enterprise Service Manager に報告します。

[mysql-proxy]

plugins=proxy,agent
agent-mgmt-hostname = http://agent:password@monitor:18080/heartbeat
mysqld-instance-dir= etc/instances
agent-item-files = share/mysql-proxy/items/quan.lua,share/mysql-proxy/items/items-mysql-monitor.xml
proxy-address=:4040
proxy-backend-addresses = 127.0.0.1:3306
proxy-lua-script        = share/mysql-proxy/quan.lua


agent-uuid = a3113263-4993-4890-8235-cadef9617c4b
log-file = mysql-monitor-agent.log
pid-file=/opt/mysql/enterprise/agent/mysql-monitor-agent.pid

エージェントプロキシを介してバックエンド MySQL サーバに接続できるか確認します。これを確認するには、MySQL クライアントをチェックします。同じユーザおよびパスワード情報を指定するなど、元のサーバに接続する場合と同じオプションを指定する必要があります。

shell> mysql -h 127.0.0.1 --port 4040 --user=root -p
Enter password: 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 299239
Server version: 5.0.60-log Gentoo Linux mysql-5.0.60-r1

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> 

アプリケーションが、クエリ送信時の実際の MySQL ポートではなく、指定されているプロキシポートを使用するように設定されているか確認します。

Query Analyzer がホストで有効にされているか確認します。詳細については、項9.6. 「Query Analyzer の設定」を参照してください。

「Query Analyzer を有効にする」。このサーバまたはサーバグループで Query Analyzer を有効にするかどうかを設定します。選択した場合、Query Anayzer が有効になります。無効にするには、チェックボックスの選択を解除します。

Query Analyzer が有効にされている場合、「クエリ例を有効にする」チェックボックスを選択して、「クエリ例」機能を設定できます。このオプションを有効にした場合、クエリをクリックして開かれる「クエリ情報」ウィンドウに追加のタブが表示されます。

「クエリ例を有効にする」。Query Analyzer で、個々のクエリの詳細情報を表示できます。有効にした場合、クエリおよびそのデータアイテム（デフォルト表示される標準フォーム以外）が表示されます。このオプションを有効にすると、フルクエリステートメントが公開されるので、セキュリティ問題が発生することがあります。

「クエリ例」オプションを有効にすると、クエリ要約詳細の追加タブを使用できます。詳細については、項9.2. 「詳細なクエリ情報の取得」を参照してください。

「クエリ例」を有効にした場合、「EXPLAIN例」も有効にできます。このタブを有効にするには、「クエリ例のEXPLAIN を有効にする」チェックボックスを選択します。

「EXPLAIN例を有効にする」。クエリを表示するときに別のタブが表示されます。このタブでは、選択したクエリに対する MySQL からの EXPLAIN 出力の結果を表示できます。この結果には、フルクエリ、およびクエリがサーバ内でどのように実行されたかが示されます。

このオプションを有効にすると、サーバの実行にオーバーヘッドがかかります。これは、サーバが、実行時間が長いクエリを識別するたびに、EXPLAIN ステートメントを実行するからです。詳細については、MySQL Enterprise Monitor Frequently Asked Questionsを参照してください。