Você pode monitorar as 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.
Observação
Para garantir o desempenho e a escalabilidade para clusters com alto volume de queries, os Insights da Forma de Query podem exibir dados de um conjunto de amostras do total de queries executadas em seu cluster.
Acesso necessário
Para visualizar métricas com o Query Shape Insights, você deve ter Project Observability Viewer acesso , 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áGo para a Clusters página do seu projeto.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de visualização.
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.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
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 . |
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 a métrica de ecah que deseja mapear 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
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.