クエリ分析¶
クエリ分析はデータベースモジュールの独立した分析エントリであり、複数インスタンスにまたがるクエリの集約表示をサポートします。複数のデータベースインスタンスを管理している場合、各インスタンスの詳細ページを個別に開かなくても、グローバルな視点でシステムレベルのスロークエリのボトルネックを特定できます。
対応データベースの種類
クエリ分析は現在 MySQL、PostgreSQL、Oracle、SQL Server、MongoDB に対応しています。データベースの種類を切り替えると、リストはその種類に応じて該当インスタンスのクエリデータを再読み込みします。
機能¶
エクスプローラーが単一インスタンスを単位としたクエリ分析であるのに対し、クエリ分析の中心的な機能は次のとおりです。
- インスタンス間集約: 同じ業務 SQL が複数のインスタンスで実行された場合、自動的にグローバルな累計データとして集約されるため、インスタンスごとに調査する必要はありません。
- 類似クエリの統合: パラメータ値が異なる類似 SQL(例:
WHERE id = 1とWHERE id = 2)は、システムが自動的に同一のクエリテンプレートとして認識し、統計をまとめます。同じステートメントがパラメータの差異によって分散表示されることを防ぎます。 - グローバルなパフォーマンス順位付け: 総所要時間、実行回数、平均所要時間などの複数の次元での並べ替えに対応しており、グローバルなパフォーマンスのボトルネックをすばやく見つけられます。
ページレイアウト¶
クエリ分析ページは、上部操作バー、左側のクイックフィルター、クエリリスト、詳細サイドパネルで構成されます。
上部操作バー¶
| 要素 | 説明 |
|---|---|
| データベース種別セレクター | ドロップダウンで MySQL / PostgreSQL / Oracle / SQL Server / MongoDB を切り替え。切り替え後、リストはその種類に応じて再読み込みされます |
| SQL テンプレート検索 | キーワードによる SQL テンプレートの検索に対応。入力制限は 512 バイト |
| クエリ総数 | 現在のフィルター条件におけるクエリテンプレートの数を表示 |
| エクスポート | 現在のリストページを CSV ファイル、TXT、またはダッシュボードへエクスポート |
| 表示項目 | リスト列の表示/非表示をカスタマイズ可能 |
左側のクイックフィルター¶
| フィルター次元 | 説明 |
|---|---|
| インスタンス名 | 複数選択可能。このデータベース種別配下のすべてのインスタンスを表示 |
| データベースアドレス | 複数選択可能。データベース接続アドレスでフィルター |
| 総所要時間 | 範囲によるセグメントフィルター |
| 実行回数 | 範囲によるセグメントフィルター |
時間範囲の連動
クエリ分析の時間範囲は、グローバルの時間ウィジェットと連動します。リストデータと詳細サイドパネルのトレンドグラフは、どちらも選択した時間ウィンドウに基づいてリアルタイムに集約されます。
クエリリスト¶
リストには、現在の時間範囲と現在のデータベース種別において、集約されたすべてのクエリテンプレートが表示されます。各レコードは 1 種類の SQL(パラメータは ? に置換済み)を表し、選択したすべてのインスタンスにおけるその SQL 種別の実行データを集計して表示します。
リストのフィールド¶
| フィールド | 説明 |
|---|---|
| SQL テンプレート | パラメータを ? に置換した SQL テキスト。リスト内では最大 2 行まで表示されます。クリックすると右側の詳細サイドパネルを展開できます |
| 実行回数 | 時間範囲内における、このクエリ種別の全インスタンスでの累計実行回数 |
| 平均所要時間 | このクエリ種別の平均単回実行時間 |
| 総所要時間 | 時間範囲内における、このクエリ種別の全インスタンスでの累計実行時間 |
| パフォーマンスオーバーヘッド割合 | このクエリ種別の累計総所要時間が、全クエリの累計総所要時間に占める割合。プログレスバーで可視化されます。割合が高いほど、このクエリ種別がシステム全体のパフォーマンスに与える影響が大きいことを示します |
| 平均スキャン行数 | このクエリ種別の全インスタンスにおける平均スキャン/返却行数。クエリのデータスキャン範囲の評価に使用します |
| トレンド | 現在の時間範囲における実行回数のミニ折れ線グラフ(スパークライン)。リストページの時間範囲と連動します |
SQL テンプレートと元の SQL
リストに表示される SQL テンプレートは、具体的なパラメータ値が ? に置換されています。これは、ステートメントの構造そのものに注目していただくためです。詳細サイドパネルでは、このテンプレートに該当する直近の元の SQL サンプルを確認でき、完全なテキストをワンクリックでコピーできます。
クエリ詳細サイドパネル¶
リストの任意の行をクリックすると、右側にクエリ詳細サイドパネルがスライド表示され、このクエリ種別のグローバルなパフォーマンスデータが表示されます。サイドパネルには以下のタブがあります。
完全な SQL¶
サイドパネル上部に、このクエリ種別の完全な SQL テンプレート(パラメータは ? に置換済み)が固定表示され、ワンクリックでコピーできます。
パフォーマンストレンド¶
リストページの時間範囲と連動し、時系列グラフでこのクエリ種別の 3 つの主要メトリクスを表示します。
| グラフ | 説明 |
|---|---|
| 実行回数 | 回/分。このクエリ種別の並行処理負荷のトレンドを反映 |
| 平均所要時間 | ミリ秒(ms)。このクエリ種別の単回実行効率のトレンドを反映 |
| 総所要時間 | ミリ秒(ms)。このクエリ種別のシステム全体における時間消費のトレンドを反映 |
各メトリクスは独立した時系列グラフで表示され、時間間隔の選択によるフィルターやグラフのエクスポートに対応しています。
インスタンス¶
このクエリ種別の各インスタンスにおける実行分布を表示し、ボトルネックがどのインスタンスに集中しているかの判断に役立ちます。
| フィールド | 説明 |
|---|---|
| データベースアドレス | インスタンスの接続アドレス |
| インスタンス名 | データベースインスタンスの識別子 |
| 実行回数 | このインスタンスにおけるこのクエリ種別の実行回数。プログレスバーで可視化 |
| 平均所要時間 | このインスタンスにおけるこのクエリ種別の平均実行時間 |
| 総所要時間 | このインスタンスにおけるこのクエリ種別の累計実行時間。プログレスバーで可視化 |
| 平均送信行数 | このインスタンスにおけるこのクエリ種別の平均返却行数 |
| エラー回数 | このインスタンスにおけるこのクエリ種別の実行失敗回数 |
- インスタンス名はクリック可能で、新しいページでそのインスタンスの単一インスタンスのクエリ詳細ページ(既存のエクスプローラー詳細を再利用)が開きます。
- 検索ボックスでインスタンス名またはデータベースアドレスによるフィルターに対応しています。
ユーザー¶
このクエリ種別の各データベースアカウントにおける実行分布を表示します。
| フィールド | 説明 |
|---|---|
| ユーザー | データベースアカウント名 |
| サンプル数 | このユーザーがこのクエリ種別を実行した回数 |
| 平均所要時間 | このユーザーがこのクエリ種別を実行した平均時間 |
- 検索ボックスでユーザー名によるフィルターに対応しています。
クエリサンプル¶
このクエリ種別の実際のサンプルレコードを表示します。フィールドはデータベースの種類によって異なります。
MySQL のフィールド例:
| フィールド | 説明 |
|---|---|
| 時間 | サンプリングが発生したタイムスタンプ |
| データベース | ターゲットデータベース(スキーマ) |
| 実行時間 | このサンプルの実際の実行所要時間 |
| ユーザー | このサンプルを実行したデータベースアカウント |
| 待機グループ | このサンプルの待機イベントグループ |
データベースによるサンプルフィールドの差異
クエリサンプルの表示フィールドはデータベースの種類に関連します。たとえば SQL Server では「セッション ID、待機タイプ、CPU 所要時間」などのフィールドが表示され、Oracle と PostgreSQL でもそれぞれのネイティブなパフォーマンスフィールドが表示されます。具体的なフィールドは、ページ上の実際の表示を基準としてください。
実行プラン¶
クエリリストで対象クエリの詳細サイドパネルを開き、実行プランに入ります。実行プランは、データベースのオプティマイザが現在のクエリに対して選択した実行方法を示すもので、クエリに全表スキャン、集合スキャン、インデックスの不適切な使用、または Join コストの高さなどの問題がないかを判断するために使用できます。
対応データベースの種類
実行プランは現在 MySQL、PostgreSQL、Oracle、SQL Server、MongoDB の収集と表示に対応しています。現在の環境で実行プラン収集が有効になっており、かつシステムが対応するプランデータを収集済みの場合にのみ、ページに実行プランが表示されます。
MongoDB の実行プランを確認する場合は、先に上部のデータベース種別セレクターで MongoDB を選択し、そのうえで対象クエリの詳細を開いて実行プランに入ります。
実行プランの選択¶
同じクエリでも、データベースインスタンスによって異なる実行プランが採用される場合があり、同じインスタンス上に複数のプランが存在する場合もあります。ページ上部のセレクターで切り替えて表示できます。オプションはインスタンス名とプラン識別子で構成され、たとえば prod-sql-01 · 0x72AE91F3 のように表示されます。
SQL Server を例にとると、プラン識別子は Plan Hash として表示されます。同じクエリの Plan Hash が変化した場合、通常はデータベースが異なる実行プランを採用したことを示します。
プランを選択すると、ページにはそのプランが属するデータベースインスタンス、データベース名、プラン識別子が表示されます。
利用上のアドバイス
まずパフォーマンストレンドとインスタンスで所要時間の異常を特定してから、実行プランでノードの依存関係と高コスト操作を確認することをお勧めします。トポロジービューは全体的な実行パスの把握に適しており、ノードリストはノードデータの比較に適しており、XML / JSON はデータベースが返す完全な生の情報の確認に適しています。
トポロジービュー¶
トポロジービューは、実行プラン内のノード階層に従ってデータベースの実行ステップを表示します。ノード間の線はノード間の依存関係を示しており、クエリの実際の実行タイムラインではありません。
各ノードには、データベースが返したデータに基づいて以下の情報が表示されます。
- 実行操作名
- 論理操作(元のプランにこのフィールドが含まれ、かつ実行操作と異なる場合のみ表示)
- アクセスするテーブル、コレクション、またはインデックス
Rows: データベースオプティマイザが予測するノードの出力行数Cost: 現在のノードとその子ノードの相対コスト
トポロジービューは拡大、縮小、ドラッグ、全体表示が可能です。ノードにマウスをホバーすると、実行操作、論理操作、アクセスオブジェクト、予測読み取り行数、フィルター条件、Join 条件、データベースのネイティブ警告などの情報をさらに確認できます。ページには、元のプランに実際に存在するフィールドのみが表示されます。
Rows と Cost の解釈について
Estimated Rows はデータベースオプティマイザが予測するノードの出力行数であり、実際に処理された行数ではありません。Node Cost は同じ実行プラン内の各ノードの相対コストを比較するために使用するもので、実際の実行所要時間を表すものではなく、異なるデータベース間での直接比較にも適していません。
ノードリスト¶
ノードリストは、実行プランのノード階層をインデント形式で表示し、各ノードがアクセスするオブジェクト、予測行数、ノードコストをすばやく比較するのに適しています。リストの順序はノード間の階層関係を表すためのもので、実際の実行時間の順序を表すものではありません。
| フィールド | 説明 |
|---|---|
| 実行ステップ | データベースが返した実行操作名とノード階層 |
| アクセスオブジェクト/インデックス | 現在のノードがアクセスするテーブル、ビュー、コレクション、またはインデックス |
| Estimated Rows | データベースオプティマイザが予測するノードの出力行数。元のプランに読み取り行数も含まれる場合は、出力と読み取りの両方のデータがそれぞれ表示されます |
| Node Cost | 現在のノードとその子ノードの相対コスト |
XML / JSON¶
元のビューには、コレクターが取得した完全な実行プランが表示され、フォーマット、検索、コピー、ダウンロードに対応しています。
| データベース | 元の形式 | ダウンロード形式 |
|---|---|---|
| SQL Server | XML | ShowPlan XML 形式に準拠する場合は .sqlplan としてダウンロードされ、その他の XML は .xml としてダウンロードされます |
| MySQL | JSON | .json |
| PostgreSQL | JSON | .json |
| Oracle | JSON | .json |
| MongoDB | JSON | .json |
MongoDB の元の実行プランはステージ単位で構成されます。一般的な COLLSCAN はコレクションスキャンを、IXSCAN はインデックススキャンを示します。元のフィールドは MongoDB のバージョンとクエリエンジンによって異なるため、実際に収集されたプランを基準としてください。フィールドの詳細については MongoDB Explain Results を参照してください。
実行プランのデータに関する説明
実行プランはコレクターがすでに取得したデータに基づいています。ページを閲覧してもクエリが再実行されることはなく、EXPLAIN や EXPLAIN ANALYZE が自発的に実行されることもありません。実行プランは、ページで現在選択されている時間範囲に必ずしも生成されたものではなく、特定の 1 回の実行に必ずしも対応するものでもありません。実際の行数や実際の所要時間が含まれるかどうかは、データベースが返した元のプランに基づきます。
メトリクスの計算方法¶
クエリ分析における集約メトリクスは、以下のロジックで計算されます。
| メトリクス | 計算方法 |
|---|---|
| 実行回数 | すべてのインスタンスにおけるこのクエリ種別の実行回数の累計 |
| 平均所要時間 | すべてのインスタンスの累計総所要時間 ÷ すべてのインスタンスの累計実行回数 |
| 総所要時間 | すべてのインスタンスにおけるこのクエリ種別の所要時間の累計 |
| パフォーマンスオーバーヘッド割合 | このクエリ種別の累計総所要時間 ÷ 全クエリの累計総所要時間 × 100% |
| 平均スキャン行数 | すべてのインスタンスにおけるこのクエリ種別の平均スキャン行数の平均値 |
データの鮮度に関する説明
クエリ分析のデータは、ユーザーが選択した時間範囲に基づいてリアルタイムに集約されます。選択した時間範囲内でデータの報告がないインスタンスは、集約結果に表示されません。