Rastrear termos de pesquisa

Sintaxe

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

Opções

Comportamento

Para cada índice do MongoDB Search em seu cluster, o Atlas coleta as seguintes métricas para os termos de pesquisa monitorados que foram executados usando esse índice:

• Número de queries do MongoDB Search para os termos monitorados.

• Número de vezes que o MongoDB Search não retornou nenhum resultado para queries para os termos 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 MongoDB Search não usa o termo que você especifica com a opção tracking para processar a query. Além disso, o termo de pesquisa que você especifica com a opção tracking não tem nenhum efeito sobre os resultados que a pesquisa do MongoDB retorna para a query.

Saída

Você pode visualizar as métricas das queries rastreadas usando a opção tracking na página Query Analytics da UI do Atlas para um índice do MongoDB 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 usa a opção tracking (destacada) para permitir que o MongoDB Search capture informações analíticas para o termo de query summer. Se você tiver os dados de amostra em seu cluster e um índice de Pesquisa do MongoDB denominado default no campo title na coleção, poderá executar a seguinte consulta na coleção sample_mflix.movies em seu cluster. Para saber mais sobre como carregar os dados de amostra e criar um índice do MongoDB Search, consulte o tutorial de início rápido do 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' }
]

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.