Supervisión de registros de diagnóstico de Azure DocumentDB con Azure Monitor

Los registros de diagnóstico de Azure son esenciales para capturar registros de recursos de Azure para una cuenta de Azure DocumentDB. Estos registros proporcionan información detallada y frecuente sobre las operaciones de los recursos asociados a la cuenta.

Importante

Esta característica no está disponible con el nivel M30 de proceso o los niveles inferiores, ni con las SKU de nivel libre.

Prerrequisitos

• Una suscripción de Azure

  • Si no tiene ninguna suscripción a Azure, cree una cuenta gratuita

• Un clúster de Azure DocumentDB existente

  • Si no tiene un clúster, cree un nuevo clúster.

• Un área de trabajo de Log Analytics existente o una cuenta de Azure Storage.

Crear configuraciones 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 más información, consulte Creación de una configuración de diagnóstico en Azure Monitor.

Administrar la configuración de diagnóstico

A veces necesitas administrar la configuración encontrándolos o eliminándolos. El az monitor diagnostic-settings grupo de comandos incluye subcomandos para la administración de la configuración de diagnóstico.

1. Enumere todas las opciones de diagnóstico asociadas a la API para el clúster.

   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 clústeres.

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 de la API para el clúster. Observe la lista de consultas de ejemplo.

   

2. Ejecute esta consulta para contar el número de API con errores para las solicitudes 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 la API para la duración del tiempo de ejecución de las solicitudes P99 por nombre de la operación.

   // Mongo requests P99 duration by operation 
   // Mongo 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 API para las solicitudes agrupadas por duración total del tiempo de ejecución.

   // Mongo requests binned by duration 
   // Count of Mongo 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 API para las solicitudes por agente de usuario.

   // Mongo requests by user agent 
   // Count of Mongo 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.
• Revisión de las opciones para migrar de MongoDB a Azure DocumentDB
• Para empezar, cree una cuenta.