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.
Como o Atlas coleta estatísticas de forma de query
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,updateedelete), 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.
Acesso necessário
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 .
Acessar insights de forma de query
Para acessar Insights da Forma de Query:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Filtrar insights de query
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.
Visualizar métricas em Charts e tabelas
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 médio de execução | |
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
Relatórios de forma de query
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.
Elegibilidade
O Atlas inscreve automaticamente um projeto para Relatórios de Forma de Query quando o projeto atende aos seguintes critérios:
O projeto recebe um
Query Targeting: Scanned Objects / Returnedalerta.O alerta se origina de um cluster dedicado (M10 ou superior) que executa a versão 8.0 do MongoDB ou superior.
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.
Denunciar Comportamento
O Atlas envia Relatórios de forma de query para agendar:
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.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.
Conteúdo do relatório
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 . |
Gerenciar assinaturas de relatórios
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.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique no ícone ao lado de Project Overview.
- A página Configurações do projeto
- exibições.
Alterne a configuração Query Shape Reports.
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.
Limitações
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.
Selecionar Formas de Consulta para Gráfico
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:
(Opcional) Filtrar entradas da tabela.
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.
(Opcional) Altere a ordem de classificação.
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.