Rastrear termos de pesquisa

Sintaxe

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

Opções

Comportamento

Para cada índice de pesquisa do Atlas Search em seu cluster do Atlas, o Atlas coleta as seguintes métricas para o termo monitorados que foram executados utilizando este índice:

• Número de query de pesquisa do Atlas Search para o termo rastreados.

• Número de vezes que o Atlas Search não retornou nenhum resultado para query para o termo rastreados.

O Atlas conta o número de consultas por dia para termos de pesquisa rastreados. O Atlas tem um limite no número de termos de pesquisa que ele captura por cluster todos os dias a partir de consultas $searchrastreadas. Quando o Atlas atinge o limite, ele não captura termos de pesquisa novos e exclusivos. No entanto, se você executar consultas para termos previamente rastreados no dia seguinte ao Atlas atingir o limite e interromper a captura, o Atlas continuará incrementando o contador desses termos, independentemente do limite do dia.

O Atlas redefine os termos que são rastreados, a contagem dos termos que são rastreados e o limite do número de termos de pesquisa rastreados no início de cada dia em UTC.

O Atlas Search não utiliza o termo que você especifica com a opção tracking para processar a query. Além disso, o termo de pesquisar que você especifica com a opção tracking não tem qualquer efeito sobre os resultados que o Atlas Search retorna para a query.

Saída

Você pode visualizar métricas para as query rastreadas utilizando a opção tracking na página da UI do Atlas Query Analytics para um índice de pesquisa do Atlas Search. Para saber mais, consulte Navegar até a página Análise de query.

A página Query Analytics exibe as seguintes métricas para um intervalo de datas predefinido, como o dia atual, últimos 7 dias, últimos 30 dias ou últimos 90 dias, ou um intervalo personalizado (em UTC) que você especifica, com uma granularidade por dia :

• Métricas para todas as query $search monitoradas

• Métricas para query sem resultados

Para saber mais, consulte Visualizar análise de query.

Exemplos

A query a seguir na coleção sample_mflix.movies pesquisa o campo title para o termo summer. A query utiliza a opção tracking (destacada) para permitir que o Atlas Search capture informações analíticas para o termo de query summer. Se você tiver os dados de amostra no seu cluster e um índice do Atlas Search chamado default no campo title da coleção, poderá executar a seguinte query na coleção sample_mflix.movies no seu cluster. Para saber mais sobre como carregar os dados de amostra e criar um índice do Atlas Search, consulte o tutorial Início rápido do Atlas 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' }
]

Se você executar esta query, poderá visualizar as métricas para ela na página Query Analytics do índice se o Atlas coletou dados para o termo de pesquisa rastreado. Para saber mais, consulte Visualizar query Analytics.