Diagnostische logboeken van Azure DocumentDB bewaken met Azure Monitor

Diagnostische logboeken van Azure zijn essentieel voor het vastleggen van Azure-resourcelogboeken voor een Azure DocumentDB-account. Deze logboeken bieden gedetailleerde en frequente inzichten in de operaties voor resources die aan het account zijn gekoppeld.

Vereiste voorwaarden

• Een Azure-abonnement

  • Als u geen Azure-abonnement hebt, maakt u een gratis account

• Een bestaand Azure DocumentDB-cluster

  • Als u geen cluster hebt, maakt u een nieuw cluster

• Een bestaande Log Analytics-werkruimte of Een Azure Storage-account.

Diagnostische instellingen maken

Metrische platformgegevens en activiteitenlogboeken worden automatisch verzameld. Als u resourcelogboeken wilt verzamelen en deze extern wilt routeren vanuit Azure Monitor, moet u een diagnostische instelling instellen. Zie Diagnostische instellingen maken in Azure Monitor voor meer informatie.

Diagnostische instellingen beheren

Soms moet u instellingen beheren door ze te zoeken of te verwijderen. De az monitor diagnostic-settings opdrachtgroep bevat subopdrachten voor het beheer van diagnostische instellingen.

1. Geef alle diagnostische instellingen weer die zijn gekoppeld aan de API voor het cluster.

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

2. Verwijder een specifieke instelling met behulp van de bijbehorende resource en de naam van de instelling.

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

Geavanceerde diagnostische queries gebruiken

Gebruik deze resourcespecifieke query's om veelvoorkomend onderzoek naar probleemoplossing uit te voeren in een API voor cluster.

1. Navigeer naar de sectie Logboeken van de API voor het cluster. Bekijk de lijst met voorbeeldquery's.

   

2. Voer deze query uit om het aantal mislukte API's te tellen voor aanvragen die zijn gegroepeerd op foutcode.

   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. Voer deze query uit om de API te verkrijgen voor de looptijd van verzoeken per bewerkingsnaam.

   // 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. Voer deze query uit om het aantal API's op te halen voor aanvragen die zijn gegroepeerd op totale runtimeduur.

   // 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. Voer deze query uit om het aantal API's voor aanvragen per gebruikersagent op te halen.

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

Verwante inhoud

• Lees meer over functiecompatibiliteit met MongoDB.
• Opties voor migratie van MongoDB naar Azure DocumentDB bekijken
• Ga aan de slag door een account te maken.