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

Ver análise de query

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

1

Você pode acessar a página de pesquisa do MongoDB a partir da opção Search & Vector Search ou do Data Explorer.

2

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

3

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 Análise de Query para um índice de pesquisa MongoDB
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

Termos de query do MongoDB 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 MongoDB Search calculará 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 MongoDB 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 $search queries com a opção tracking para as quais o MongoDB Search não retornou resultados.

  • Approx % of Search Queries With No Results - porcentagem aproximada de queries$search com a opção tracking para as quais o MongoDB 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 queries rastreadas para as quais o MongoDB 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

Termos de query do MongoDB 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 MongoDB Search calculará 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 MongoDB 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 MongoDB Search são baseadas na 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 principais termos de query 10 e nos termos de query para os quais a MongoDB Search não retornou nenhum resultado. Saiba também como você pode usar sinônimos para melhorar a pesquisa de termos para os quais o MongoDB Search não retornou nenhum resultado.

Duração: 7 Minutos