クエリシェイプインサイトを使用して、実行の遅いクエリとともに クエリシェイプの操作レベルのクエリ実行メトリクスをモニターできます。Query Shape Insights ページには、合計実行時間が最も長いプロジェクト内のクエリシェイプのパフォーマンスメトリクスを説明するチャートとテーブルが表示されます。表示されているクエリシェイプデータをホスト、シャード、時間範囲でフィルターできます。また、最大 5 つのクエリシェイプを選択して、対応するメトリクスチャートで視覚化できます。
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 ビューを開きます。このビューには、完全なクエリシェイプとクエリシェイプハッシュ、上記の各テーブル メトリクス、および次の追加のメトリクスが含まれています。
最終表示タイムスタンプ
最初の参照タイムスタンプ
最後に表示されたアプリケーション
最後に表示されたドライバー名とバージョン
アプリケーションを初めて確認
最初に表示されるドライバー名とバージョン
クエリシェイプ レポート
Atlas は、プロジェクト内のクラスターの非効率的なクエリシェイプをまとめた クエリシェイプ レポートメールを送信できます。低速クエリを識別して調査するために、レポートは Query Shape Insights ページに直接リンクします。
適格
Atlas は、プロジェクトが次の条件を満たしている場合、プロジェクトをクエリ形状レポート に自動的にサブスクライブします。
プロジェクトは
Query Targeting: Scanned Objects / Returnedアラートを受信します。アラートは、 MongoDBバージョン 8.0 以降を実行中専有クラスター（M10 以上）からアラートされます。
Project Ownerユーザーは、プロジェクトがクエリ ターゲティングアラートを受信しているかどうかに関係なく、クエリシェイプ レポートに手動でサブスクライブまたはサブスクライブ解除することもできます。詳細については、「 レポート サブスクリプションの管理 」を参照してください。
動作を報告する
Atlas は次のスケジュールでクエリ形状レポートを送信します。
プロジェクトが適格になると、Atlas は アラート の約 1
Query Targeting: Scanned Objects / Returned時間後に最初のレポートを送信します。Atlas は、プロジェクトがサブスクライブを解除するまで、約 1 週間に 1 回追加のレポートを送信します。
Atlas は各レポートをProject Owner ロールを持つすべてのユーザーに送信します。
特定のレポート期間に対象となるクエリシェイプが存在しない場合、Atlas はそのレポートをスキップし、次のスケジュールされたレポートで再開します。
レポートの内容
各クエリシェイプレポートのメールには、次の情報が含まれています。
Atlas UIの組織、プロジェクト、 クラスター へのリンク。
クラスターの Query Shape Insights ページへのリンク。
合計実行時間で順位付けされた、最大 5 つのクエリシェイプのテーブル。各クエリシェイプは、レポート期間中に少なくとも 10 回実行される必要があります。
Query Shape Insights ページの各クエリシェイプの詳細へのリンク。
Project Settingsのレポートサブスクライブ設定へのリンク。詳細については、「 プロジェクト設定の管理 」を参照してください。
クエリシェイプテーブルには、過去 3 日間の各クエリシェイプに関する次のメトリックが含まれています。
コラム | 説明 |
|---|---|
コレクション名 | クエリシェイプが対象とするコレクションの名前。 |
平均実行時間 | 特定のクエリシェイプでクエリの実行中に費やされた平均時間。 |
Execution Count | 指定されたクエリシェイプを持つクエリが実行された合計回数。 |
ドキュメントが検査された: 返された比率 | 指定されたクエリシェイプを持つクエリによって返されたドキュメントに対する検査されたドキュメントの割合。 |
レポート サブスクリプションの管理
プロジェクトの 設定で、クエリ シェイプ レポートをサブスクライブまたはサブスクライブ解除できます。この設定は、プロジェクト内のすべてのユーザーのレポートを制御します。サブスクライブを変更Project Owner できるのは ロールを持つユーザーのみで、レポートはProject Owner ユーザーのみに送信されます。
クエリシェイプ レポートを管理するには、次の手順に従います。
Atlas で、 Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、 アイコンを Project Overview の横にあるをクリックします。
- プロジェクト設定ページ
- は を表示します。
Query Shape Reports設定を切り替えます。
サブスクライブするには をオンに、サブスクライブを解除するにはオフにします。初めてサブスクライブするときは、レポートでカバーするクラスターを選択します。変更は、プロジェクト内のすべてのProject Owner ユーザーに適用されます。
また、 クエリシェイプ レポートメールでサブスクライブ解除リンクをクリックして、サブスクライブを解除することもできます。このリンクは Project Settings にアクセスします。ここで Atlas はプロジェクトのサブスクライブを解除します。ログしなくても、サブスクライブ解除リンクは機能します。
制限
クエリシェイプレポートには、次の制限があります。
サブスクライブ設定はプロジェクト全体 に適用されます。個々のユーザーをサブスクライブまたはサブスクリプション解除することはできません。
クエリシェイプ レポートは、 Atlas Administration APIでは利用できません。
チャート化するクエリシェイプの選択
デフォルトでは 、Query Shape Insights には、最高の Total Execution Time を持つ上位 5 つのクエリシェイプのメトリクス チャートが表示されます。Query Shape Insights テーブルでは、最大 5 つのクエリシェイプを選択できます。
Query Shape Insights テーブルでクエリシェイプを検索して選択するには、次の手順に従います。