Monitorar logs de diagnóstico vCore do Azure Cosmos DB para MongoDB com o Azure Monitor

APLICA-SE A: MongoDB vCore

Os logs de diagnóstico do Azure são essenciais para capturar logs de recursos do Azure para uma conta vCore do Azure Cosmos DB para MongoDB. Esses logs fornecem informações detalhadas e frequentes sobre as operações de recursos com a conta.

Pré-requisitos

• Um cluster vCore existente do Azure Cosmos DB para MongoDB.
  • Se você não tiver uma assinatura do Azure, crie uma conta gratuitamente.
  • Se você tiver uma assinatura existente do Azure, crie um novo cluster vCore do Azure Cosmos DB para MongoDB.
• Um espaço de trabalho existente do Log Analytics ou uma conta de Armazenamento do Azure.

Criar as definições de diagnóstico

As métricas da plataforma e os registros de atividades são coletados automaticamente. Para coletar logs de recursos e roteá-los externamente do Azure Monitor, você deve estabelecer uma configuração de diagnóstico. Para saber como, consulte Criar configurações de diagnóstico no Azure Monitor.

Gerenciar configurações de diagnóstico

Às vezes, você precisa gerenciar as configurações localizando-as ou removendo-as. O az monitor diagnostic-settings grupo de comandos inclui subcomandos para o gerenciamento de configurações de diagnóstico.

1. Liste todas as configurações de diagnóstico associadas à API para cluster vCore do MongoDB.

   az monitor diagnostic-settings list \
       --resource-group $resourceGroupName \
       --resource $clusterResourceId
   

2. Exclua uma configuração específica usando o recurso associado e o nome da configuração.

   az monitor diagnostic-settings delete \
       --resource-group $resourceGroupName \
       --name $diagnosticSettingName \
       --resource $clusterResourceId
   

Usar consultas de diagnóstico avançado

Use essas consultas específicas de recursos para executar pesquisas comuns de solução de problemas em uma API para cluster vCore do MongoDB.

1. Navegue até a seção Logs da API para cluster vCore do MongoDB. Observe a lista de consultas de exemplo.

   

2. Execute esta consulta para contar o número de APIs com falha para solicitações vCore do MongoDB agrupadas por código de erro.

   VCoreMongoRequests
   // Time range filter:  | where TimeGenerated between (StartTime .. EndTime)
   // Resource id filter: | where _ResourceId == "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group-name/providers/microsoft.documentdb/mongoclusters/my-cluster-name"
   | where ErrorCode != 0
   | summarize count() by bin(TimeGenerated, 5m), ErrorCode=tostring(ErrorCode)
   

3. Execute esta consulta para obter a API para a duração do tempo de execução das solicitações P99 vCore do MongoDB por nome da operação.

   // Mongo vCore requests P99 duration by operation 
   // Mongo vCore requests P99 runtime duration by operation name. 
   VCoreMongoRequests
   // Time range filter:  | where TimeGenerated between (StartTime .. EndTime)
   // Resource id filter: | where _ResourceId == "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group-name/providers/microsoft.documentdb/mongoclusters/my-cluster-name"
   | summarize percentile(DurationMs, 99) by bin(TimeGenerated, 1h), OperationName
   

4. Execute esta consulta para obter a contagem de API para solicitações vCore do MongoDB agrupadas por duração total de tempo de execução.

   // Mongo vCore requests binned by duration 
   // Count of Mongo vCore requests binned by total runtime duration. 
   VCoreMongoRequests
   // Time range filter:  | where TimeGenerated between (StartTime .. EndTime)
   // Resource id filter: | where _ResourceId == "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group-name/providers/microsoft.documentdb/mongoclusters/my-cluster-name"
   | project TimeGenerated, DurationBin=tostring(bin(DurationMs, 5))
   | summarize count() by bin(TimeGenerated, 1m), tostring(DurationBin)
   

5. Execute esta consulta para obter a contagem de API para solicitações vCore do MongoDB pelo agente do usuário.

   // Mongo vCore requests by user agent 
   // Count of Mongo vCore requests by user agent. 
   VCoreMongoRequests
   // Time range filter:  | where TimeGenerated between (StartTime .. EndTime)
   // Resource id filter: | where _ResourceId == "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group-name/providers/microsoft.documentdb/mongoclusters/my-cluster-name"
   | summarize count() by bin(TimeGenerated, 1h), UserAgent
   

Conteúdos relacionados

• Leia mais sobre a compatibilidade de recursos com o MongoDB.
• Opções de revisão para migrar do MongoDB para o Azure Cosmos DB para MongoDB vCore
• Comece criando uma conta.