Você pode monitorar métricas de execução de query em nível de operação para forma de query com query 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 no seu projeto com o maior tempo total de execução. Você pode filtrar os dados de forma de query exibidos por host, shard e faixa 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
O query Shape Insights exibe dados de um subconjunto das operações que são executadas no seu cluster. O método de collection depende da versão do MongoDB do cluster:
Em clusters que executam o MongoDB 8.x, o Atlas registra até 100 queries de leitura por segundo em cada host. O Atlas não coleta operações de gravação.
Em clusters que executam o MongoDB 9.0 ou posterior, o Atlas amostra aleatoriamente 1% das operações de leitura e gravação por padrão. Os valores de métrica exibidos refletem apenas operações amostradas, aproximadamente 1% do total de operações. Formas de query que são executadas com pouca frequência podem não aparecer nos resultados. Esse método também coleta operações de gravação (
insert,updateedelete), que aparecem nos insights da forma de query ao lado das operações de leitura.
Observação
Após atualizar um cluster do MongoDB 8.x para 9.0, os totais de métricas em Insights da Forma de Consulta podem parecer significativamente diferentes do que antes da atualização. Essa diferença reflete a alteração no método de amostragem, não uma alteração no volume 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 . |
Documentos correspondentes | Número total de documentos correspondidos por queries com a forma de query fornecida . Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Docs Modified | Número total de documentos modificados por queries com a forma de query fornecida . Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Documentos atualizados | Número total de documentos atualizados por queries com a forma de query fornecida . Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Documentos inseridos | Número total de documentos inseridos por queries com a forma de query fornecida . Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Documentos excluídos | Número total de documentos excluídos por queries com a forma de query fornecida. Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Chaves inseridas | Número total de chaves de índice inseridas por queries com a forma de query fornecida. Disponível apenas para comandos de gravação em clusters executando MongoDB 9.0 ou posterior. |
Chaves excluídas | Número total de chaves de índice excluídas por queries com a forma de query fornecida. Disponível apenas para comandos de gravação 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 consulta
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 ajudá-lo a identificar e investigar queries lentas, o relatório contém links diretamente para a página Query Shape Insights.
Elegibilidade
O Atlas inscreve automaticamente um projeto nos Relatórios de forma de query quando o projeto atende aos seguintes critérios:
O projeto recebe um alerta
Query Targeting: Scanned Objects / Returned.O alerta se origina de um cluster dedicado (M10 ou superior) executando o MongoDB versão 8.0 ou superior.
Os usuários doProject Owner também podem assinar ou cancelar a assinatura manualmente dos 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órios.
Comportamento de relatório
O Atlas envia Relatórios de Forma de Query na seguinte programação:
O Atlas envia relatórios adicionais aproximadamente uma vez por semana até que o projeto seja cancelado.
O Atlas envia cada relatório para todos os usuários com a função Project Owner.
Se não existirem formas de query qualificadas para um determinado período de relatório, o Atlas pulará esse relatório e retomará 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, projeto e agrupamento na UI 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 saber mais, consulte Gerenciar 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 queries com a forma de query fornecida . |
Contagem de Execução | Número total de vezes que as queries com a forma de query fornecida foram executadas. |
Documentos 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 assinar ou cancelar a assinatura de 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. Somente usuários com a função Project Owner podem alterar a assinatura, e somente usuários 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 botão para assinar ou desligue para cancelar a assinatura. Ao se inscrever pela primeira vez, selecione o cluster ou clusters que deseja que o relatório cubra. A alteração se aplica a todos os usuários Project Owner no projeto.
Você também pode cancelar a assinatura clicando no link de cancelamento em qualquer e-mail do Relatório de Forma de Query. O link direciona você para Project Settings, onde o Atlas cancela a assinatura do projeto. O link de cancelamento de assinatura funciona sem exigir que você faça login.
Limitações
Os relatórios de forma de query têm as seguintes limitações:
A configuração de assinatura se aplica a todo o projeto. Você não pode assinar ou cancelar a assinatura de usuários individuais.
Os Relatórios de Forma de Query não estão disponíveis por meio da API de Administração do Atlas .
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.