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

Ver análise de query

Você pode visualizar as métricas dos termos de query do Atlas Search rastreados usando a tracking opção na página da interface do usuário do Atlas Query Analytics do índice que você usou para fazer a 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 termos de pesquisa nem exibe análises para queries em clusters gratuitos e flexíveis.

1

Aviso

Melhorias de navegação em andamento

No momento, estamos lançando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na UI do Atlas, consulte a documentação de visualização.

  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.

    Se você não tiver clusters, clique em Create cluster para criar um. Para saber mais, consulte Criar um cluster.

  2. Se o seu projeto tiver vários clusters, selecione o cluster que deseja usar no menu suspenso Select 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:

  • Visão geral do índice - Visualizar a configuração deste índice

  • pesquisar Tester - pesquisar sua collection usando este índice

  • query - Visualize análises de sua query para obter termo rastreados que usaram esse índice

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 descartar 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 descartar 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