Monitorare i log di diagnostica di Azure Cosmos DB for MongoDB vCore con Monitoraggio di Azure

SI APPLICA A: MongoDB vCore

I log di diagnostica di Azure sono essenziali per acquisire i log delle risorse di Azure per un account vCore di Azure Cosmos DB for MongoDB. Questi log forniscono informazioni dettagliate e frequenti sulle operazioni delle risorse con l'account.

Importante

Questa funzionalità non è disponibile con M25gli SKU di livello gratuito , M30o .

Prerequisiti

• Un cluster Azure Cosmos DB for MongoDB vCore esistente.
  • Se non si ha una sottoscrizione di Azure, creare un account gratuitamente.
  • Se si ha una sottoscrizione di Azure esistente, creare un nuovo cluster Azure Cosmos DB for MongoDB vCore.
• Un'area di lavoro Log Analytics esistente o un account di Archiviazione di Azure.

Creare impostazioni di diagnostica

Le metriche della piattaforma e i log attività vengono raccolti automaticamente. Per raccogliere i log delle risorse e instradarli esternamente da Monitoraggio di Azure, è necessario stabilire un'impostazione di diagnostica. Per scoprire come fare, vedere Creare impostazioni di diagnostica in Monitoraggio di Azure.

Gestire le impostazioni di diagnostica

A volte è necessario gestire le impostazioni individuandole o rimuovendole. Il gruppo di comandi az monitor diagnostic-settings include sottocomandi per la gestione delle impostazioni di diagnostica.

1. Elencare tutte le impostazioni di diagnostica associate all'API per il cluster MongoDB vCore.

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

2. Eliminare un'impostazione specifica usando la risorsa associata e il nome dell'impostazione.

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

Usare query di diagnostica avanzate

Usare queste query specifiche delle risorse per eseguire ricerche comuni sulla risoluzione dei problemi in un cluster vCore dell'API per MongoDB.

Importante

Questa sezione presuppone che si stia usando un'area di lavoro Log Analytics con log specifici delle risorse.

1. Passare alla sezione Log del cluster vCore dell'API per MongoDB. Osservare l'elenco delle query di esempio.

   

2. Eseguire questa query per contare il numero di richieste non riuscite dell'API per MongoDB vCore raggruppate in base al codice di errore.

   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. Eseguire questa query per ottenere l'API per le richieste MongoDB vCore P99 la durata del runtime in base al nome dell'operazione.

   // 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. Eseguire questa query per ottenere il conteggio delle richieste dell'API per MongoDB vCore raggruppate per durata totale di 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. Eseguire questa query per ottenere il numero di richieste dell'API per MongoDB vCore da parte dell'agente utente.

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

Contenuto correlato

• In questa sezione sono disponibili maggiori informazioni sulla compatibilità delle funzionalità con MongoDB.
• Esaminare le opzioni per eseguire la migrazione da MongoDB ad Azure Cosmos DB for MongoDB vCore.
• Per iniziare, creare un account.