Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ /

Ver análise de query

Nesta página

  • Navegue até a página Análise de query
  • No Atlas, Go para a página Clusters do seu projeto.
  • Acesse a página do Atlas Search do seu cluster.
  • Clique no nome do índice.
  • Clique em Query Analytics para visualizar as análises de query monitoradas executadas usando este Atlas Search índice de pesquisa.
  • Visualize a query de análise para termo de pesquisar rastreados
  • Métricas para todas as query $search monitoradas
  • Métricas para query sem resultados
  • Fatores que afetam os dados exibidos
  • Continuar aprendendo

Você pode visualizar métricas para os termos de query do Atlas Search rastreados usando a opção tracking na página Query Analytics da IU do Atlas para o índice que você usou para fazer uma query do termo. Para saber como marcar termos de pesquisa em suas queries, consulte Rastrear termos de pesquisa.

Esta página descreve as métricas que o Atlas captura para query monitoradas e como visualizar a analítica de query de um índice do Atlas Search na UI do Atlas.

Observação

Você deve ter um cluster M10 ou superior executando o MongoDB v5.0 ou superior para visualizar as informações analíticas dos termos de pesquisa monitorados na UI do Atlas. O Atlas Search não rastreia termo de pesquisar nem exibe análises para query em clusters de nível gratuito e compartilhado.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Se ainda não estiver exibido, clique em Clusters na barra lateral.

    A página Clusters é exibida.

2

Você pode acessar a página do Atlas Search pela barra lateral, pelo Data Explorer ou pela página de detalhes do cluster.

  1. Na barra lateral, clique em Atlas Search sob o título Services.

  2. No menu suspenso Select data source, selecione seu cluster e clique em Go to Atlas Search.

    A página Atlas Search é exibida.

  1. Clique no botão Browse Collections para o seu cluster.

  2. Expanda o banco de dados e selecione a coleção.

  3. Clique na guia Search Indexes da coleção.

    A página Atlas Search é exibida.

  1. Clique no nome do seu cluster.

  2. Clique na aba Atlas Search.

    A página Atlas Search é exibida.

3

A página exibe uma visão geral desse índice, incluindo Index Configurations e Field Mappings na definição do índice. O lado esquerdo da página também fornece opções de navegação para as seguintes páginas:

4

O Atlas exibe analítica de query para queries para termos de pesquisa monitorados que foram executados usando apenas o índice selecionado.

A página Query Analytics exibe o seguinte 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 um por granularidade do dia:

Captura de tela da query para um índice de pesquisa do Atlas Search
clique para ampliar

Esta seção mostra as seguintes métricas:

  • Approx # of Tracked $search Queries - contagem aproximada de query $search que incluíram a opção tracking .

  • Approx % of Top 10 Tracked Queries - porcentagem de $search query com a opção tracking que também são as 10 principais query.

A seção também mostra um gráfico do número de query rastreadas para o intervalo de datas selecionado.

Você pode expandir Show Top Search Queries abaixo do gráfico para visualizar as seguintes métricas:

Search Terms
Termo de query do Atlas Search (um por linha).
Approx #
Número aproximado de todas as query $search monitoradas para o termo (na mesma linha).
Approx %

Porcentagem aproximada de todas as query $search monitoradas para o termo (na mesma linha). Essa é a porcentagem de queries com o termo de query, do número total de queries, somente nos dias em que o Atlas captou a query durante o intervalo de datas selecionado.

Por exemplo, se você executar uma query para coffee, o Atlas Search calcula a porcentagem da seguinte forma:

  • 4 queries para coffee de um total de 8 queries em dias capturados são iguais a 50%.

  • A query 1 para coffee de um total de 2 queries em dias capturados é igual a 50%.

View

Vincule para visualizar as seguintes métricas em um intervalo de datas predefinido ou personalizado para o termo (na mesma linha):

  • Número de query e porcentagem de query monitoradas para o termo no intervalo de datas selecionado.

  • Gráfico do número de query monitoradas para o termo durante o intervalo de datas selecionado.

Clique em View factors affecting data para abrir uma janela que exibe os dias em que não houve queries registradas para o termo de pesquisa e informações sobre fatores que afetam as métricas que o Atlas Search exibe na página. Para saber mais, consulte Fatores que afetam os dados exibidos. Você pode clicar em Close para fechar a janela.

Para saber mais, veja como o Atlas captura os termos de pesquisa.

A seção Aggregation pipeline Query exibe o seguinte:

  • Sample aggregation pipeline suspenso que mostra as diferentes query que o Atlas captou para o termo.

  • MongoDB API guia que mostra a query mongosh associada ao pipeline selecionado.

  • Export to Language guia que permite visualizar, copiar e exportar query sintaxe em outros idiomas de driver MongoDB suportados.

  • Open Aggregation Pipeline link para abrir a guia Aggregation da collection. Para executar sua query em relação à collection na guia Aggregation :

    1. Copie sua query.

    2. Clique em Create New na aba Aggregation.

    3. Habilite Preview se ainda não estiver habilitado e clique em </> Text.

    4. Cole sua query no painel esquerdo para visualizar os resultados no painel Pipeline Output à direita.

Clique em < Query Analytics para retornar a página Query Analytics .

Esta seção mostra as seguintes métricas para query para as quais o Atlas não retornou nenhum resultado para todo o aggregation pipeline:

  • Approx # of Search Queries With No Results - contagem aproximada de query $search com a opção tracking para as quais o Atlas Search não retornou resultados.

  • Approx % of Search Queries With No Results - porcentagem aproximada de $search query com a opção tracking para as quais o Atlas Search não retornou nenhum resultado.

Para o intervalo de datas selecionado, a seção também mostra um gráfico do número de query rastreadas para as quais o Atlas Search não retornou nenhum resultado.

Você pode expandir Show Top No Results Queries abaixo do gráfico para visualizar as seguintes métricas:

Search Terms
Termo de query do Atlas Search (um por linha).
Approx # of Searches
Número aproximado de query para o termo (na mesma linha).
Approx % of all Tracked Searches

Porcentagem aproximada de query rastreadas para o termo (na mesma linha). Essa é a porcentagem de queries com o termo de query, do número total de queries, somente nos dias em que o Atlas captou a query durante o intervalo de datas selecionado.

Por exemplo, se você executar uma query para coffee, o Atlas Search calcula a porcentagem da seguinte forma:

  • 4 queries para coffee de um total de queries 8 em dias capturados são iguais a 50%

  • 1 query para coffee de um total de 2 queries em dias capturados é igual a 50%

View

Vincule para visualizar as seguintes métricas em um intervalo de datas predefinido ou personalizado para o termo (na mesma linha):

  • Número e porcentagem de todas as query $search monitoradas para o termo no intervalo de datas selecionado.

  • Gráfico do número de query $search monitoradas para o termo durante o intervalo de datas selecionado.

Clique em View factors affecting data para abrir uma janela que exibe os dias em que não houve queries registradas para o termo de pesquisa e informações sobre fatores que afetam as métricas que o Atlas Search exibe na página. Para saber mais, consulte Fatores que afetam os dados exibidos. Você pode clicar em Close para fechar a janela.

Para saber mais, veja como o Atlas captura os termos de pesquisa.

A seção Aggregation pipeline Query exibe o seguinte:

  • Sample aggregation pipeline suspenso que mostra as diferentes query que o Atlas captou para o termo.

  • MongoDB API guia que mostra a query mongosh associada ao pipeline selecionado.

  • Export to Language guia que permite visualizar, copiar e exportar a sintaxe de consulta em outros idiomas do driver MongoDB suportados.

  • Open Aggregation Pipeline link para abrir a guia Aggregation da collection. Para executar sua query em relação à collection na guia Aggregation :

    1. Copie sua query.

    2. Clique em Create New na aba Aggregation.

    3. Habilite Preview se ainda não estiver habilitado e clique em </> Text.

    4. Cole sua query no painel esquerdo para visualizar os resultados no painel Pipeline Output à direita.

Clique em < Query Analytics para retornar a página Query Analytics .

Muitos fatores afetam as métricas exibidas na página.

As métricas de query do Atlas Search são baseadas em amostragem, o que pode afetar a precisão de todas as métricas exibidas.

Além disso, o Atlas tem um limite de número de termo de pesquisar únicos que o Atlas captura por dia a partir de query $search rastreadas. Quando o Atlas atinge o limite, ele não captura termos de pesquisa novos e exclusivos. O seguinte poderá ser afetado se o Atlas atingir o limite:

  • A porcentagem aproximada das 10 principais queries monitoradas

  • A ordem na qual o Atlas exibe os principais termos de pesquisa

As métricas de termos de pesquisar rastreados individualmente poderiam ser afetadas se o Atlas parasse de capturar antes que as query de um termo de pesquisar fossem executadas. Nesses dias, o Atlas não exibe o número de pesquisas para esse termo de pesquisa, resultando em uma lacuna.

Para saber mais, consulte Comportamento.

Acompanhe este vídeo para saber como você pode usar a análise de query para recuperar métricas nos 10 principais termo de query e termo de query para os quais o Atlas Search não retornou nenhum resultado. Saiba também como usar sinônimos para melhorar a pesquisa de termos para os quais o Atlas Search não retornou nenhum resultado.

Duração: 7 Minutos