Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Monitore as estatísticas da forma de query com insights da forma de query

Você pode monitorar métricas de execução de query em nível de operação para formas de query com queries de execução lenta usando o Query Shape Insights. A página Query Shape Insights exibe gráficos e uma tabela que descrevem as métricas de desempenho para as formas de query em seu projeto com o maior tempo de execução total. Você pode filtrar os dados de forma de query exibidos por host, fragmento e intervalo de tempo e selecionar até cinco formas de query para visualizar nos gráficos de métricas correspondentes.

O Atlas suporta insights de forma de query apenas em clusters dedicados (M10 e superior) que executam o MongoDB versão 8.0 e superior.

A Perspicácia da forma de query exibe dados de um subconjunto das operações que são executadas no seu cluster. O método de coleção depende da versão do MongoDB do seu cluster:

  • Nos cluster executando MongoDB 8.x, O Atlas registro até 100 queries de leitura por segundo em cada hospedar. O Atlas não coleta operações de gravar.

  • Em clusters executando MongoDB 9.0 ou posterior, o Atlas amostra aleatoriamente 1% das operações de leitura e de gravar por padrão. Os valores de métricas exibidos refletem apenas operações amostradas, aproximadamente 1% do total de operações. As formas de query executadas com pouca frequência podem não aparecer nos resultados. Este método também coleta operações de gravação (insert, update e delete), que aparecem na perspicácia da forma de query juntamente com as operações de leitura.

Observação

Depois de fazer upgrade de um cluster do MongoDB 8.x para o 9.0, os totais de métricas na forma de query perspicácias podem parecer significativamente diferentes do que antes do upgrade. Essa diferença reflete a alteração no método de amostragem, não uma alteração na carga de trabalho do seu cluster.

Para visualizar métricas com o Query Shape Insights, você deve ter acesso Project Observability Viewer, Project Data Access Read Only, Project Data Access Read/Write, Project Data Access Admin ou Project Owner ao projeto.

Importante

As formas de query que expõem nomes de campo, mas valores editados podem conter PII do usuário. Para visualizar formas de query truncadas ou completas no Query Shape Insights, você deve ter uma das roles de projeto listadas acima, cada uma delas dando acesso para visualizar PII. Para usuários sem essas permissões, o Query Shape Insights identifica as formas de query pelo hash da forma de query .

Para acessar Insights da Forma de Query:

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. Na barra lateral, clique em Clusters sob o título Database.

A página Clusters é exibida.

2
  1. Clique no nome do cluster para abrir a barra lateral Cluster.

  2. Clique em Query Insights na barra lateral Cluster.

    A aba Query Shapes é exibida por padrão.

Você pode filtrar a página Query Insights por nó, estado do nó (primário ou secundário) e shard. Você também pode filtrar por um intervalo de datas personalizado nos últimos sete dias ou selecionar um dos seguintes intervalos de tempo predefinidos:

  • 7 dias

  • 5 dias

  • 2 dias

  • 24 horas (padrão)

  • 12 horas

  • 8 horas

  • 1 hora

Quando você aplica um filtro, o Atlas obtém dados novamente para os gráficos e tabela na tela atual.

Observação

Os nós de analítica são incluídos quando você filtra por estado do nó secundário.

O Query Shape Insights exibe gráficos e uma tabela que descrevem métricas para formas de query em seu projeto com queries de execução lenta.

A tabela Insights de forma de query contém uma linha para cada forma de query principal em seu projeto, em que as formas de query principais são determinadas pelo tempo de execução total mais alto. Cada linha contém a forma de query ou seu hash de forma de query , o namespace da forma de query, o comando de query e quaisquer métricas que você selecionar para exibir. Você pode usar o botão Edit Columns para escolher qual das seguintes métricas incluir como colunas da tabela:

Métrica
Descrição

Tempo total de execução

Tempo total em microssegundos gastos executando queries com a forma de query fornecida. Se a query resultou em getMore comandos, essa métrica inclui o tempo gasto no processamento das getMore solicitações. Esta métrica não inclui o tempo gasto aguardando o cliente.

Tempo médio de execução

Tempo médio em microssegundos gastos executando queries com a forma de query fornecida. Se a query resultou em getMore comandos, essa métrica inclui o tempo gasto no processamento das getMore solicitações. Esta métrica não inclui o tempo gasto aguardando o cliente.

Contagem de Execução

Número total de vezes que queries com a forma de query fornecida foram executadas.

Chaves examinadas

Número total de chaves de índice dentro e fora dos limites examinadas por queries com a forma de query fornecida.

Chaves examinadas:devolvidas

Proporção de chaves de índice dentro e fora dos limites examinadas para índices contendo documentos retornados por queries com a forma de query fornecida.

Documentos examinados

Número total de documentos examinados por queries com a forma de query fornecida .

Docs devolvidos

Número total de documentos retornados por queries com a forma de query fornecida .

Documentos examinados: devolvidos

Proporção de documentos examinados em relação aos documentos retornados por queries com a forma de query fornecida .

Docs Correspondidos

Número total de documentos correspondidos por querys com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Docs Modificado

Número total de documentos modificados por querys com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Docs atualizados ou inseridos

Número total de documentos upsertados por querys com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Docs Inserido

Número total de documentos inseridos por query com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Docs excluídos

Número total de documentos excluídos por queries com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Chaves inseridas

Número total de chaves de índice inseridas por query com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Chaves excluir

Número total de chaves de índice excluídas por queries com a forma de query fornecida. Disponível apenas para comandos de gravar em clusters executando MongoDB 9.0 ou posterior.

Tempo total de resposta

Tempo em microssegundos gastos desde o início do processamento da query até a primeira resposta do servidor .

Última execução

Tempo de execução de execução em microssegundos para a query mais recente com a forma de query fornecida.

Tempo de execução do P50

50º percentil no histograma de tempo de execução.

Tempo de execução do P90

90º percentil no histograma de tempo de execução.

Tempo de execução do P99

99º percentil no histograma de tempo de execução.

Você também pode exibir gráficos para uma ou mais das métricas acima, selecionando cada métrica que deseja exibir gráficos no menu suspenso no cabeçalho do componente Query Shape Statistics.

O Atlas pode mapear cada métrica para até cinco formas de query de cada vez. Por padrão, os gráficos do Atlas cada métrica para as cinco formas de query com o Total Execution Time mais alto. Você pode optar por traçar diferentes formas de query marcando ou desmarcando a caixa de seleção na linha das formas de query desejadas. Você pode gerenciar quais formas de query devem ser mapeadas da tabela, marcando ou desmarcando a caixa de seleção na linha das formas de query desejadas.

Para ver mais detalhes sobre uma forma de query, clique na linha da forma de query para abrir a visualização Query Shape Details. Essa visualização contém a forma de query completa e o hash de forma de query , cada métrica de tabela listada acima e as seguintes métricas adicionais:

  • Carimbo de data/hora da última visualização

  • Carimbo de data/hora da primeira visualização

  • Último aplicativo visualizado

  • Último nome e versão do driver visto

  • Primeiro aplicativo visto

  • Nome e versão do driver visto primeiro

O Atlas pode enviar a você um e-mail de Relatório de Forma de Query que resume formas de query ineficientes para um cluster em seu projeto. Para ajudar você a identificar e investigar queries lentas, o relatório vincula diretamente à página Query Shape Insights.

O Atlas inscreve automaticamente um projeto para Relatórios de Forma de Query quando o projeto atende aos seguintes critérios:

Os usuários Project Owner também podem se inscrever ou cancelar a inscrição manualmente nos Relatórios de forma de query, independentemente de o projeto ter recebido um alerta de direcionamento de query. Para saber mais, consulte Gerenciar assinaturas de relatório.

O Atlas envia Relatórios de forma de query para agendar:

  1. Quando um projeto se torna elegível, o Atlas envia o primeiro relatório aproximadamente uma hora após o alerta Query Targeting: Scanned Objects / Returned.

  2. O Atlas envia relatórios adicionais aproximadamente uma vez por semana até que o projeto se desinscreva.

O Atlas envia cada relatório a todos os usuários com a função Project Owner.

Se não houver formas de query qualificadas para um determinado período de relatório, o Atlas ignora esse relatório e continua com o próximo relatório agendado.

Cada e-mail de Relatório de forma de query contém as seguintes informações:

  • Links para a organização, o projeto e o cluster na IU do Atlas.

  • Um link para a página Query Shape Insights do cluster.

  • Uma tabela de até cinco formas de query, classificadas por tempo total de execução. Cada forma de query deve ter pelo menos 10 execuções no período do relatório para aparecer.

  • Um link para os detalhes de cada forma de query na página Query Shape Insights.

  • Um link para as configurações de assinatura do relatório em Project Settings. Para aprender mais, consulte Gerenciar as configurações do projeto.

A tabela de forma de query inclui as seguintes métricas para cada forma de query nos últimos três dias:

coluna
Descrição

Nome da collection

Nome da coleção que a forma de query tem como alvo.

Tempo médio de execução

Tempo médio gasto executando querys com a forma de query fornecida.

Contagem de Execução

Número total de vezes que as query com a forma de query fornecida executaram.

Docs Examinados:Proporção Retornada

Proporção de documentos examinados em relação aos documentos retornados por queries com a forma de query fornecida .

Você pode inscrever-se ou cancelar a inscrição em Relatórios de forma de query nas configurações do seu projeto. Esta configuração controla relatórios para todos os usuários no projeto. Apenas usuários com a função de Project Owner podem alterar a assinatura, e apenas usuários de Project Owner recebem os relatórios.

Para gerenciar Relatórios de Forma de Query:

No Atlas, acesse a página Project Settings.

  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. Na barra lateral, clique no ícone ao lado de Project Overview.

A página Configurações do projeto

exibições.
1

Ative o interruptor para se inscrever ou desative para cancelar a inscrição. Ao assinar pela primeira vez, selecione o cluster ou os clusters que você deseja que o relatório cubra. A alteração aplica-se a todos os usuários Project Owner no projeto.

Você também pode cancelar a inscrição clicando no link de cancelamento de inscrição em qualquer e-mail de Relatório de Forma de Query. O link direciona você para Project Settings, onde o Atlas cancela a inscrição do projeto. O link para cancelar a inscrição funciona sem exigir que você se conecte.

Relatórios de forma de query têm as seguintes limitações:

  • A configuração de assinatura aplica-se a todo o projeto. Não é possível inscrever ou cancelar a inscrição de usuários individuais.

  • Relatórios de forma de query não estão disponíveis na Atlas Administration API.

Por padrão, o Query Shape Insights exibe gráficos de métrica para as cinco principais formas de query com o Total Execution Time mais alto. Você pode selecionar até cinco formas de query para mapear na tabela Query Shape Insights.

Para pesquisar e selecionar formas de query na tabela Query Shape Insights:

1

Você pode filtrar a tabela Query Shape Insights pelas seguintes categorias:

  • Forma de query: Na caixa de pesquisa Search by Query Shape, insira a forma de query ou seu hash de query associado.

  • Namespace: no menu suspenso Select Namespaces, selecione um ou mais namespaces para filtrar.

  • Comando: no menu suspenso Select Commands, selecione um ou mais comandos para filtrar.

2

Você pode classificar a tabela Query Shape Insights por uma ou mais colunas de métricas para ajudar a identificar quais formas de query devem ser mapeadas.

Para classificar por uma métrica em ordem decrescente ou crescente, clique no ícone sort ao lado do nome da coluna associada uma ou duas vezes, respectivamente. Para classificar por várias colunas, pressione Shift e clique nos ícones sort na ordem em que você deseja classificar várias colunas da tabela.

3

Clique na caixa de seleção na linha da forma de query desejada .

Você pode selecionar até cinco formas de query de cada vez.