Surveiller les journaux de diagnostic d'Azure Cosmos DB for MongoDB vCore avec Azure Monitor

S’APPLIQUE À : MongoDB vCore

Les journaux de diagnostic Azure sont essentiels pour capturer les journaux de ressources Azure pour un compte Azure Cosmos DB for MongoDB vCore. Ces journaux fournissent des informations détaillées et fréquentes sur les opérations relatives aux ressources avec le compte.

Important

Cette fonctionnalité n’est pas disponible avec des références SKU M25 (burstable) ou M30 (niveau gratuit).

Prérequis

• Un cluster vCore Azure Cosmos DB for MongoDB existant.
  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuitement.
  • Si vous disposez d’un abonnement Azure, créez un cluster Azure Cosmos DB for MongoDB vCore.
• Un espace de travail Log Analytics ou un compte de stockage Azure existant.

Créer des paramètres de diagnostic

Les métriques de plateforme et les journaux d’activité sont collectés automatiquement. Pour collecter les journaux de ressources et les router en externe à partir d’Azure Monitor, vous devez établir un paramètre de diagnostic. Pour savoir comment, consultez Créer des paramètres de diagnostic dans Azure Monitor.

Gérer les paramètres de diagnostic

Parfois, vous devez gérer les paramètres en les recherchant ou en les supprimant. Le groupe de commandes az monitor diagnostic-settings inclut des sous-commandes pour la gestion des paramètres de diagnostic.

1. Répertoriez tous les paramètres de diagnostic associés à l’API pour le cluster vCore MongoDB.

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

2. Supprimez un paramètre spécifique à l’aide de la ressource associée et du nom du paramètre.

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

Utilisez des requêtes de diagnostic avancées

Utilisez ces requêtes spécifiques aux ressources pour effectuer des recherches de dépannage courantes dans un cluster vCore MongoDB.

Important

Cette section suppose que vous utilisez un espace de travail Log Analytics avec des journaux spécifiques aux ressources.

1. Accédez à section Journaux d’activité du cluster vCore MongoDB. Observez la liste des exemples de requêtes.

   

2. Exécutez cette requête pour compter le nombre de requêtes vCore mongoDB ayant échoué regroupées par code d’erreur.

   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. Exécutez cette requête pour obtenir l’API pour la durée d'exécution P99des requêtes MongoDB vCore par nom d'opération.

   // 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. Exécutez cette requête pour obtenir le nombre de requêtes API for MongoDB vCore groupées par durée totale d'exécution.

   // 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. Lancez cette requête pour obtenir le nombre de requêtes des d'API pour MongoDB vCore par agent utilisateur.

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

Contenu connexe

• En savoir plus sur la compatibilité des fonctionnalités avec MongoDB.
• Passer en revue les options de migration de MongoDB vers Azure Cosmos DB for MongoDB vCore
• Commencez par créer un compte.