検索タームの追跡

構文

{
  $search: {
    "index": "<index name>",
    "<operator>": {
      <operator-specification>
    },
    "tracking": {
      "searchTerms": "<term-to-search>"
    }
  }
}

オプション

動作

Atlas は、クラスター上の各MongoDB Searchインデックスについて、そのインデックスを使用して実行された追跡検索タームについて、次のメトリクスを収集します。

• 追跡されたタームのMongoDB Search クエリの数。

• MongoDB Search が追跡対象のタームのクエリに対して結果を返さなかった回数です。

Atlas は、追跡された検索タームの 1 日あたりのクエリ数をカウントします。 Atlas では、追跡された $searchクエリから毎日クラスターごとに取得される検索タームの数に制限があります。 Atlas が 制限に達すると、新しい一意の検索タームは取得されなくなります。 ただし、Atlas が 制限に達して取得を停止した後の 1 日間、過去に追跡されたタームのクエリを実行すると、その日の制限に関係なく、Atlas はそれらのタームのカウンターを増加させ続けます。

Atlas は、追跡されるタームの数、追跡されるタームのカウント、および追跡される検索タームの数の制限を UTCの毎日の先頭にリセットします。

MongoDB Search では、クエリを処理するために、tracking オプションで指定したタームは使用されません。また、tracking オプションで指定した検索タームは、 MongoDB Search がクエリに対して返す結果には影響しません。

出力

MongoDB Searchインデックスの Atlas UI Query Analytics ページで、tracking オプションを使用して追跡されたクエリのメトリクスを表示できます。詳しくは、「クエリ分析ページに移動する」を参照してください。

Query Analyticsページには、現在日、過去 7 日間、過去 30 日間、過去 90 日間などの事前定義された日付範囲、または指定したカスタム範囲（ UTC ）に関する 1 日ごとの粒度が表示されます:

• すべての追跡された $search クエリのメトリクス

• 結果のないクエリのメトリクス

詳しくは、「クエリ分析の表示 」を参照してください。

例

sample_mflix.moviesコレクションに対する次のクエリは、titleフィールドで summer というタームを検索します。クエリは tracking オプション（強調表示）を使用して、 MongoDB Search がクエリタームsummer の分析情報を取得できるようにします。クラスターにサンプルデータがあり、コレクションの titleフィールドに default という名前のMongoDB Searchインデックスがある場合は、クラスターの sample_mflix.moviesコレクションに対して次のクエリを実行できます。サンプルデータのロードとMongoDB Searchインデックスの作成の詳細については、 MongoDB Search クイック スタートチュートリアルを参照してください。

db.movies.aggregate([
  {
    "$search": {
      "text": {
        "query": "summer",
        "path": "title"
      },
      "tracking": {
        "searchTerms": "summer"
      }
    }
  },
  {
    "$limit": 5
  },
  {
    "$project": {
      "_id": 0,
      "title": 1
    }
  }
])

[
  { title: 'Summer' },
  { title: 'Summer Stock' },
  { title: 'Early Summer' },
  { title: 'Summer Interlude' },
  { title: 'Violent Summer' }
]

このクエリを実行すると、Atlas が追跡検索タームのデータを収集している場合、インデックスのQuery Analyticsページでそのクエリに関するメトリクスを表示できます。 詳しくは、「クエリ分析の表示 」を参照してください。