クエリシェイプを使用して、実行が遅いクエリを持つクエリシェイプの操作レベルのクエリ実行メトリクスを監視できます。Query Shape Insights ページには、プロジェクト内で合計実行時間が最も長いクエリシェイプのパフォーマンス メトリクスを説明するチャートと表が表示されます。表示されるクエリシェイプデータを、ホスト、シャード、および時間範囲ごとにフィルタリングして、対応するメトリック チャートで視覚化するクエリシェイプを最大 5 つ選択できます。
Atlas は、 MongoDBバージョン 8.0 以降を実行中専用クラスター（M10 以上）に対してのみクエリシェイプ インサイトをサポートしています。
注意
クエリシェイプインサイト には、クラスターで実行されスケーラビリティクエリの合計のサンプルセットのデータが表示される場合があります。
必要なアクセス権
クエリシェイプProject Observability Viewer インサイトでメトリクスを表示するには、プロジェクトに対する 、Project Data Access Read OnlyProject Owner 、 、Project Data Access Read/Write Project Data Access Admin、または アクセス権が必要です。
重要
フィールド名を表示するクエリシェイプには、ユーザー PII が含まれる場合があります。クエリシェイプ インサイト で切り捨てられたクエリシェイプまたは完全なクエリシェイプを表示するには、上記のいずれかのプロジェクトロールが必要です。それぞれにビュー PII へのアクセス権が付与されます。これらの権限を持たないユーザーの場合、クエリシェイプインサイトはクエリシェイプハッシュによってクエリシェイプを識別します。
クエリシェイプのインサイトにアクセスする
クエリシェイプインサイトにアクセスするには
AtlasGoClustersAtlas で、プロジェクトの ページにGoします。
警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。
フィルタークエリのインサイト
Query Insights ページは、ノード、ノードの状態（プライマリまたはセカンダリ）、シャードでフィルタリングできます。過去 7 日以内のカスタム日付範囲でフィルタリングすることも、事前設定された時間範囲からいずれかを選択することもできます。
7 日間
5 日間
2 日
24 時間（デフォルト）
12時間
8 時間
1 時間
フィルターを適用すると、Atlas は現在の画面のチャートと表のデータを再取得します。
チャートと表でメトリクスを表示
クエリシェイプ インサイト には、実行速度が遅いクエリを含むプロジェクト内のクエリシェイプのメトリクスを説明するチャートと表が表示されます。
クエリシェイプ インサイト テーブルには、プロジェクト内の上位クエリシェイプごとに 1 行が含まれています。ここで、上位クエリシェイプは最も高い合計実行時間によって決まります。各行には、クエリシェイプまたはそのクエリシェイプハッシュ、クエリシェイプの名前空間、クエリコマンド、および表示するように選択したメトリックが含まれています。Edit Columns ボタンを使用して、次のいずれかをテーブルの列として含めるメトリクスを選択できます。
メトリクス | 説明 |
|---|---|
合計実行時間 | |
平均実行時間 | |
Execution Count | 特定のクエリシェイプを持つクエリが実行された合計回数。 |
検査されたキー | 指定されたクエリシェイプを持つクエリによって検査された、限界内のインデックス キーと限界外のインデックスキーの総数。 |
キーが検査され、返された | 特定のクエリシェイプを持つクエリによって返されたドキュメントを含むインデックスに対する検査された限界内のインデックス キーと限界外のインデックスキーの割合。 |
ドキュメントが検査された | 指定されたクエリシェイプを持つクエリによって検査されたドキュメントの合計数。 |
返されたDocs | 指定されたクエリシェイプを持つクエリによって返されたドキュメントの合計数。 |
ドキュメントが検査された: 返された | 指定されたクエリシェイプを持つクエリによって返されたドキュメントに対する検査されたドキュメントの割合。 |
応答までの合計時間 | クエリ処理の開始から最初のサーバー応答までに費やされた時間（マイクロ秒単位）。 |
最終実行時間 | 指定されたクエリシェイプ）。 |
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 テーブルでクエリシェイプを検索して選択するには、次の手順に従います。