Supervisión de registros de diagnóstico de núcleo virtual de Azure Cosmos DB for MongoDB con Azure Monitor

SE APLICA A: núcleo virtual de MongoDB

Los registros de diagnóstico de Azure son esenciales para capturar registros de recursos de Azure para una cuenta de núcleo virtual de Azure Cosmos DB for MongoDB. Estos registros proporcionan información detallada y frecuente sobre las operaciones de los recursos con la cuenta.

Importante

Esta característica no está disponible con M25, M30 ni las SKU de nivel gratuito.

Requisitos previos

• Un clúster existente de núcleos virtuales de Azure Cosmos DB for MongoDB.
  • Si no tiene una suscripción de Azure, cree una cuenta gratuita.
  • Si tiene una suscripción de Azure existente, cree un clúster de núcleo virtual de Azure Cosmos DB for MongoDB.
• Un área de trabajo de Log Analytics existente o una cuenta de Azure Storage.

Creación de configuración de diagnóstico

Las métricas de la plataforma y los registros de actividad se recopilan automáticamente. Para recopilar registros de recursos y enrutarlos externamente desde Azure Monitor, debe establecer una configuración de diagnóstico. Para obtener información, consulte Crear configuraciones de diagnóstico en Azure Monitor.

Administrar la configuración de diagnóstico

A veces es necesario administrar las configuraciones encontrándolas o eliminándolas. El grupo de comandos az monitor diagnostic-settings incluye subcomandos para la administración de la configuración de diagnóstico.

1. Enumere todas las opciones de diagnóstico asociadas con la API para el clúster de núcleo virtual de MongoDB.

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

2. Elimine una configuración específica mediante el recurso asociado y el nombre de la configuración.

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

Uso de consultas de diagnóstico avanzadas

Use estas consultas específicas de recursos para realizar investigaciones comunes de solución de problemas en una API para el clúster de núcleo virtual de MongoDB.

Importante

En esta sección se supone que usa un área de trabajo de Log Analytics con registros específicos del recurso.

1. Vaya a la sección Registros del clúster de la API para el clúster de núcleo virtual de MongoDB. Observe la lista de consultas de ejemplo.

   

2. Ejecute esta consulta para contar el número de solicitudes de la API para el clúster de núcleo virtual de MongoDB con errores agrupadas por código de error.

   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. Ejecute esta consulta para obtener las solicitudes de la API para de núcleo virtual de MongoDB P99 duración del runtime por nombre de operación.

   // 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. Ejecute esta consulta para obtener el recuento de solicitudes de la API para núcleo virtual de MongoDB agrupadas por duración total de 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. Ejecute esta consulta para obtener el recuento de solicitudes de la API para núcleo virtual de MongoDB por agente de usuario.

   // 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
   

Contenido relacionado

• Obtenga más información sobre la compatibilidad de características con MongoDB.
• Revise las opciones para migrar de MongoDB a un núcleo virtual de Azure Cosmos DB for MongoDB.
• Para empezar, cree una cuenta.