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

APLICA-SE AO: MongoDB vCore

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

Importante

Esse recurso não está disponível com SKUs de M25, M30ou de camada livre.

Pré-requisitos

• Um cluster vCore do Azure Cosmos DB for MongoDB existente.
  • Caso não tenha uma assinatura do Azure, crie uma conta gratuitamente.
  • Se você tiver uma assinatura existente do Azure, crie um cluster VCore do Azure Cosmos DB for MongoDB.
• Um workspace do Log Analytics ou conta de armazenamento do Azure.

Criar configurações de diagnóstico

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

Gerenciar configurações de diagnóstico

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

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

   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
   

Use as consultas de diagnóstico avançado

Use estas consultas específicas de recursos para executar pesquisas comuns de solução de problemas em um cluster da API para MongoDB vCore.

Importante

Esta seção pressupõe que você esteja usando um workspace do Log Analytics com logs específicos de recursos.

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

   

2. Execute esta consulta para contar o número de solicitações de API para MongoDB vCore com falha 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 duração do runtime para obter as solicitações de API para MongoDB vCoreP99 pelo 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 solicitações da API para MongoDB vCore agrupadas pela duração total do runtime.

   // 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 solicitações da API para MongoDB vCore por agente de 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údo relacionado

• Leia mais sobre a compatibilidade de recursos com o MongoDB.
• Examinar as opções de migração do MongoDB para o Azure Cosmos DB for MongoDB vCore
• Comece criando uma conta.