クエリシェイプ インサイト を使用すると、実行速度が遅いクエリを持つクエリシェイプの操作レベルのクエリ実行メトリクスを監視できます。 ページには、プロジェクト内で合計実行時間が最も長いクエリシェイプのパフォーマンス メトリクスを説明するチャートと表が表示されます。表示されるクエリシェイプデータを、ホスト、シャード、および時間範囲ごとにフィルタリングして、対応するメトリック チャートで視覚化するクエリシェイプを最大 5 つ選択できます。Query Shape Insights
Atlas は、 MongoDBバージョン 8.0 以降を実行中専用クラスター（M10 以上）に対してのみクエリシェイプ インサイトをサポートしています。
Atlas によるクエリシェイプ統計の収集方法
クエリシェイプ インサイト には、クラスターで実行される操作のサブセットのデータが表示されます。コレクション方法は、クラスターのMongoDB のバージョン によって異なります。
MongoDB 8.xを実行中クラスターでは、Atlas は各ホストで 1 秒あたり最大 100 の読み取りクエリを記録します。 Atlas は書込み (write) 操作を収集しません。
MongoDB 9.0 以降を実行中クラスターでは、Atlas は読み取りおよび書込み操作の 1% をデフォルトでランダムにサンプリングします。表示されるメトリクス値は、サンプリングされた操作のみを反映しており、合計操作の約 1% を反映しています。実行頻度の低いクエリシェイプは結果に表示されないことがあります。このメソッドは、読み取り操作とともに クエリシェイプ インサイト に表示される書込み操作（
insert、update、delete）も収集します。
注意
MongoDB 8.x から 9.0 にクラスターをアップグレードすると、クエリシェイプインサイトのメトリクス合計がアップグレード前と大きく異なる場合があります。この差は、クラスターのワークロードの変更ではなく、サンプリング方法の変更を反映します。
必要なアクセス権
クエリシェイプ インサイトでメトリクスを表示するには、プロジェクトに対する Project Observability Viewer、Project Data Access Read Only、Project Data Access Read/Write、Project Data Access Admin、またはProject Ownerアクセス権が必要です。
重要
フィールド名を表示するが編集された値にはユーザー PII が含まれる場合があります。クエリシェイプ インサイト で切り捨てられたクエリシェイプまたは完全なクエリシェイプを表示するには、上記のいずれかのプロジェクトロールが必要です。それぞれにビュー PII へのアクセス権が付与されます。これらの権限を持たないユーザーの場合、クエリシェイプインサイトはクエリシェイプハッシュによってクエリシェイプを識別します。
クエリシェイプのインサイトにアクセスする
クエリシェイプインサイトにアクセスするには
Atlas で、プロジェクトの Clusters ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 Database見出しの下のClustersをクリックします。
[ Clusters （クラスター） ] ページが表示されます。
フィルタークエリのインサイト
Query Insights ページは、ノード、ノードの状態（プライマリまたはセカンダリ）、シャードでフィルタリングできます。過去 7 日以内のカスタム日付範囲でフィルタリングすることも、事前設定された時間範囲からいずれかを選択することもできます。
7 日間
5 日間
2 日
24 時間（デフォルト）
12時間
8 時間
1 時間
フィルターを適用すると、Atlas は現在の画面のチャートと表のデータを再取得します。
チャートと表でメトリクスを表示
クエリシェイプ インサイト には、実行速度が遅いクエリを含むプロジェクト内のクエリシェイプのメトリクスを説明するチャートと表が表示されます。
クエリシェイプ インサイト テーブルには、プロジェクト内の上位クエリシェイプごとに 1 行が含まれています。ここで、上位クエリシェイプは最も高い合計実行時間によって決まります。各行には、クエリシェイプまたはそのクエリシェイプハッシュ、クエリシェイプの名前空間、クエリコマンド、および表示するように選択したメトリックが含まれています。Edit Columns ボタンを使用して、次のいずれかをテーブルの列として含めるメトリクスを選択できます。
メトリクス | 説明 |
|---|---|
合計実行時間 | |
平均実行時間 | |
Execution Count | 特定のクエリシェイプを持つクエリが実行された合計回数。 |
検査されたキー | 指定されたクエリシェイプを持つクエリによって検査された、限界内のインデックス キーと限界外のインデックスキーの総数。 |
キーが検査され、返された | 特定のクエリシェイプを持つクエリによって返されたドキュメントを含むインデックスに対する検査された限界内のインデックス キーと限界外のインデックスキーの割合。 |
ドキュメントが検査された | 指定されたクエリシェイプを持つクエリによって検査されたドキュメントの合計数。 |
返されたDocs | 指定されたクエリシェイプを持つクエリによって返されたドキュメントの合計数。 |
ドキュメントが検査された: 返された | 指定されたクエリシェイプを持つクエリによって返されたドキュメントに対する検査されたドキュメントの割合。 |
一致したドキュメント | 指定されたクエリシェイプを持つクエリによって一致したドキュメントの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
変更されたドキュメント | 指定されたクエリシェイプを持つクエリによって変更されたドキュメントの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
アップサートされた文書 | 指定されたクエリシェイプを持つクエリによってアップサートされたドキュメントの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
挿入されたドキュメント | 指定されたクエリシェイプを持つクエリによって挿入されたドキュメントの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
削除されたドキュメント | 指定されたクエリシェイプを持つクエリによって削除されたドキュメントの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
挿入されたキー | 指定されたクエリシェイプを持つクエリによって挿入されたインデックスキーの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
削除されたキー | 指定されたクエリシェイプを持つクエリによって削除されたインデックスキーの合計数。 MongoDB 9.0 以降を実行中クラスター上の書込みコマンドでのみ使用できます。 |
応答までの合計時間 | クエリ処理の開始から最初のサーバー応答までに費やされた時間（マイクロ秒単位）。 |
最終実行時間 | 指定されたクエリシェイプ）。 |
P50 実行時間 | 実行時間ヒストグラムの 50 パーセンタイル。 |
P90 実行時間 | 実行時間ヒストグラムの 90 パーセンタイル。 |
P99 実行時間 | 実行時間ヒストグラムの 99 パーセンタイル。 |
また、Query Shape Statistics コンポーネント ヘッダーのドロップダウン メニューからチャートを作成する各メトリクスを選択して、上記のメトリクスの 1 つ以上のチャートを表示することもできます。
Atlas は、一度に最大 5 つのクエリシェイプの各メトリクスをチャートできます。デフォルトでは 、Atlas は、最も高い Total Execution Time を持つ 5 つのクエリシェイプの各メトリックを Chartします。 目的のクエリシェイプの行のチェックボックスを選択または選択解除することで、さまざまなクエリシェイプをチャートすることができます。テーブルからどのクエリシェイプをチャートするかを管理するには、目的のクエリシェイプの行のチェックボックスを選択または選択解除します。
クエリシェイプの詳細を表示するには、クエリシェイプの行をクリックして Query Shape Details ビューを開きます。このビューには、完全なクエリシェイプとクエリシェイプハッシュ、上記の各テーブル メトリクス、および次の追加のメトリクスが含まれています。
最終表示タイムスタンプ
最初の参照タイムスタンプ
最後に表示されたアプリケーション
最後に表示されたドライバー名とバージョン
アプリケーションを初めて確認
最初に表示されるドライバー名とバージョン
チャート化するクエリシェイプの選択
デフォルトでは 、Query Shape Insights には、最高の Total Execution Time を持つ上位 5 つのクエリシェイプのメトリクス チャートが表示されます。Query Shape Insights テーブルでは、最大 5 つのクエリシェイプを選択できます。
Query Shape Insights テーブルでクエリシェイプを検索して選択するには、次の手順に従います。