Azure Cosmos DB controleren

In dit artikel wordt het volgende beschreven:

  • De typen bewakingsgegevens die u voor deze service kunt verzamelen.
  • Manieren om die gegevens te analyseren.

Opmerking

Als u al bekend bent met deze service en/of Azure Monitor en alleen wilt weten hoe u bewakingsgegevens moet analyseren, raadpleegt u de sectie Analyze aan het einde van dit artikel.

Wanneer u kritieke toepassingen en bedrijfsprocessen hebt die afhankelijk zijn van Azure-resources, moet u waarschuwingen voor uw systeem bewaken en ontvangen. De Azure Monitor-service verzamelt en aggregeert metrische gegevens en logboeken van elk onderdeel van uw systeem. Azure Monitor biedt u een overzicht van beschikbaarheid, prestaties en tolerantie, en geeft u een bericht over problemen. U kunt de Azure-portal, PowerShell, Azure CLI, REST API of clientbibliotheken gebruiken om bewakingsgegevens in te stellen en weer te geven.

Insights

Sommige services in Azure hebben een ingebouwd bewakingsdashboard in Azure Portal dat een beginpunt biedt voor het bewaken van uw service. Deze dashboards worden insights genoemd en u vindt deze in de Insights Hub van Azure Monitor in de Azure-portal.

Inzichten in Azure Cosmos DB

Azure Cosmos DB-inzichten is een functie op basis van de werkmapfunctie van Azure Monitor. Gebruik Azure Cosmos DB-inzichten voor een overzicht van de algehele prestaties, fouten, capaciteit en operationele status van al uw Azure Cosmos DB-resources in een geïntegreerde interactieve ervaring.

Zie de volgende artikelen voor meer informatie over Inzichten in Azure Cosmos DB:

Resourcetypen

Azure maakt gebruik van het concept van resourcetypen en id's om alles in een abonnement te identificeren. Resourcetypen maken ook deel uit van de resource-id's voor elke resource die wordt uitgevoerd in Azure. Eén resourcetype voor een virtuele machine is bijvoorbeeld Microsoft.Compute/virtualMachines. Zie Resourceproviders voor een lijst met services en de bijbehorende resourcetypen.

Azure Monitor organiseert op dezelfde manier kernbewakingsgegevens in metrische gegevens en logboeken op basis van resourcetypen, ook wel namespaces genoemd. Er zijn verschillende metrische gegevens en logboeken beschikbaar voor verschillende resourcetypen. Uw service is mogelijk gekoppeld aan meer dan één resourcetype.

Zie de naslaginformatie over bewakingsgegevens van Azure Cosmos DB voor meer informatie over de resourcetypen voor Azure Cosmos DB.

Gegevensopslag

Voor Azure Monitor:

  • Metrische gegevens worden opgeslagen in de metrische gegevensdatabase van Azure Monitor.
  • Logboekgegevens worden opgeslagen in de Azure Monitor-logboekenopslag. Log Analytics is een hulpprogramma in de Azure-portal waarmee je een query kunt uitvoeren op deze opslagplaats.
  • Het Azure-activiteitenlogboek is een afzonderlijk archief met een eigen interface in Azure Portal.

U kunt eventueel metrische gegevens en activiteitenlogboekgegevens routeren naar het logboekarchief van Azure Monitor. Vervolgens kunt u Log Analytics gebruiken om een query uit te voeren op de gegevens en deze te correleren met andere logboekgegevens.

Veel services kunnen diagnostische instellingen gebruiken om metrische gegevens en logboekgegevens te verzenden naar andere opslaglocaties buiten Azure Monitor. Voorbeelden hiervan zijn Azure Storage, gehoste partnersystemen en niet-Azure-partnersystemen, met behulp van Event Hubs.

Zie Azure Monitor-gegevensplatform voor gedetailleerde informatie over hoe Azure Monitor gegevens opslaat.

Metrische gegevens van het Azure Monitor-platform

Azure Monitor biedt metrische platformgegevens voor de meeste services. Deze metrische gegevens zijn:

  • Afzonderlijk gedefinieerd voor elke naamruimte.
  • Opgeslagen in de Azure Monitor metrische gegevensdatabase voor tijdreeksen.
  • Lichtgewicht en in staat om bijna in realtime waarschuwingen te geven.
  • Wordt gebruikt om de prestaties van een resource in de loop van de tijd bij te houden.

Verzameling: Azure Monitor verzamelt automatisch metrische platformgegevens. Er is geen configuratie vereist.

Routering: U kunt sommige metrische platformgegevens ook routeren naar Azure Monitor-logboeken/Log Analytics, zodat u er query's op kunt uitvoeren met andere logboekgegevens. Controleer de DS-exportinstelling voor elke metriek om te zien of u een diagnostische instelling kunt gebruiken om de metrische gegevens te routeren naar Azure Monitor-logboeken/Log Analytics.

Zie Ondersteunde statistieken in Azure Monitor voor een lijst van alle statistieken die mogelijk zijn te verzamelen voor alle bronnen in Azure Monitor.

Azure Monitor verzamelt standaard metrische gegevens van Azure Cosmos DB. U hoeft niets expliciet te configureren. De meeste metrische gegevens zijn beschikbaar op de azure Cosmos DB-portalpagina of op de Azure Monitor-pagina. De metrische gegevens worden standaard verzameld met granulariteit van één minuut. De granulariteit kan variëren op basis van de metrische gegevens die u kiest. Zie Retentie van metrische gegevens van Azure Monitor voor meer informatie over de standaardretentieperiode

Metrische gegevens aan de serverzijde van Azure Cosmos DB omvatten doorvoer, opslag, beschikbaarheid, latentie, consistentie en metrische gegevens op systeemniveau. Aan de clientzijde kunt u details verzamelen voor aanvraagkosten, activiteits-id, uitzonderings- en stacktraceringsgegevens, HTTP-status en substatuscode en diagnostische tekenreeks. Deze metrische gegevens hebben standaard een bewaarperiode van zeven dagen. U kunt deze gegevens gebruiken om problemen op te lossen of als u contact moet opnemen met het ondersteuningsteam van Azure Cosmos DB.

De dimensiewaarden voor de metrische gegevens, zoals containernaam, zijn niet hoofdlettergevoelig. Deze situatie kan leiden tot verwarring of botsing van telemetrie en acties op containers met dergelijke namen. Gebruik hoofdletterongevoelige vergelijking bij stringvergelijkingen op deze dimensiewaarden.

Zie de naslaginformatie over bewakingsgegevens van Azure Cosmos DB voor een lijst met beschikbare metrische gegevens voor Azure Cosmos DB.

Metrische gegevens op basis van niet-Azure Monitor

Deze service biedt andere metrische gegevens die niet zijn opgenomen in de metrische Gegevensdatabase van Azure Monitor.

Logboeken van Azure Monitor-resources

Resourcelogboeken bieden inzicht in bewerkingen die zijn uitgevoerd door een Azure-resource. Logboeken worden automatisch gegenereerd, maar u moet ze routeren naar Azure Monitor-logboeken om ze op te slaan of er query's op uit te voeren. Logboeken zijn ingedeeld in categorieën. Een bepaalde naamruimte kan meerdere resource-logcategorieën bevatten.

Verzameling: Resourcelogboeken worden niet verzameld en opgeslagen totdat u een diagnostische instelling maakt en de logboeken naar een of meer locaties doorgestuurd worden. Wanneer u een diagnostische instelling maakt, geeft u op welke categorieën logboeken moeten worden verzameld. Er zijn meerdere manieren om diagnostische instellingen te maken en te onderhouden, waaronder de Azure-portal, programmatisch en via Azure Policy.

Routering: de voorgestelde standaardinstelling is het routeren van resourcelogboeken naar Azure Monitor-logboeken, zodat u er query's op kunt uitvoeren met andere logboekgegevens. Andere locaties, zoals Azure Storage, Azure Event Hubs en bepaalde Microsoft-bewakingspartners, zijn ook beschikbaar. Voor meer informatie, zie Azure-resource-logboeken en Resource-logboek-bestemmingen.

Zie Diagnostische instellingen in Azure Monitor voor gedetailleerde informatie over het verzamelen, opslaan en routeren van resourcelogboeken.

Zie Ondersteunde resourcelogboeken in Azure Monitor voor een lijst met alle beschikbare resourcelogboekcategorieën in Azure Monitor.

Alle resourcelogboeken in Azure Monitor hebben dezelfde koptekstvelden, gevolgd door servicespecifieke velden. Het algemene schema wordt beschreven in het schema voor resourcelogboeken van Azure Monitor.

U kunt diagnostische logboeken bewaken vanuit uw Azure Cosmos DB-account en dashboards maken vanuit Azure Monitor. Gegevens zoals gebeurtenissen en traceringen die plaatsvinden bij een tweede granulariteit, worden opgeslagen als logboeken. Als de doorvoer van een container bijvoorbeeld verandert, worden de eigenschappen van een Azure Cosmos DB-account gewijzigd. In de logboeken worden deze gebeurtenissen vastgelegd. U kunt deze logboeken analyseren door query's uit te voeren op de verzamelde gegevens.

Zie de referentie voor bewakingsgegevens van Azure Cosmos DB voor de beschikbare resourcelogboekcategorieën, de bijbehorende Log Analytics-tabellen en de logboekschema's voor Azure Cosmos DB.

Azure-activiteitenlogboek

Het activiteitenlogboek bevat gebeurtenissen op abonnementsniveau waarmee bewerkingen voor elke Azure-resource worden bijgehouden, zoals van buiten die resource wordt gezien; Bijvoorbeeld het maken van een nieuwe resource of het starten van een virtuele machine.

Collectie: Gebeurtenissen in het activiteitenlogboek worden automatisch gegenereerd en verzameld in een afzonderlijk archief voor weergave in Azure Portal.

Routing: U kunt activiteitenlogboekgegevens verzenden naar Azure Monitor Logs, opdat u deze naast andere logboekgegevens kunt analyseren. Andere locaties, zoals Azure Storage, Azure Event Hubs en bepaalde Microsoft-bewakingspartners, zijn ook beschikbaar. Zie Overzicht van het Azure-activiteitenlogboek voor meer informatie over het routeren van het activiteitenlogboek.

Herstelacties voor doorlopende back-upmodus auditeren

Met behulp van activiteitenlogboeken kunt u alle herstelbewerkingen naar een bepaald tijdstip weergeven voor continue modus die is uitgevoerd op een Azure Cosmos DB-account. Zie De herstelactie voor een bepaald tijdstip controleren voor continue back-upmodus voor meer informatie over het weergeven van deze bewerkingen in Azure Portal.

Bewakingsgegevens analyseren

Er zijn veel hulpprogramma's voor het analyseren van bewakingsgegevens.

Azure Monitor-hulpprogramma's

Azure Monitor ondersteunt de volgende basishulpprogramma's:

Hulpprogramma's waarmee complexere visualisaties mogelijk zijn, zijn onder andere:

  • Dashboards waarmee u verschillende soorten gegevens kunt combineren in één deelvenster in Azure Portal.
  • Werkboeken, aanpasbare rapporten die u in de Azure-portal kunt maken. Werkmappen kunnen tekst, metrische gegevens en logboekquery's bevatten.
  • Grafana, een open platformhulpprogramma dat excelleert in operationele dashboards. U kunt Grafana gebruiken om dashboards te maken die gegevens uit meerdere andere bronnen dan Azure Monitor bevatten.
  • Power BI, een business analytics-service die interactieve visualisaties biedt in verschillende gegevensbronnen. U kunt Power BI zo configureren dat logboekgegevens automatisch vanuit Azure Monitor worden geïmporteerd om te profiteren van deze visualisaties.

Azure Monitor exporthulpmiddelen

U kunt gegevens uit Azure Monitor ophalen in andere hulpprogramma's met behulp van de volgende methoden:

Zie Azure monitoring REST API-handleiding om aan de slag te gaan met de REST API voor Azure Monitor.

Metrische gegevens van Azure Cosmos DB analyseren

U kunt Azure Monitor Metrics Explorer gebruiken om metrische gegevens voor Azure Cosmos DB te analyseren met metrische gegevens van andere Azure-services door metrische gegevens te selecteren onder Bewaking in de navigatie van uw Azure Cosmos DB-accountportal. Zie Metrische gegevens analyseren met Azure Monitor Metrics Explorer voor meer informatie over het gebruik van Metrics Explorer.

U kunt latentie aan de serverzijde, het gebruik van aanvraageenheden en het genormaliseerde gebruik van aanvraageenheden voor uw Azure Cosmos DB-resources bewaken. U kunt metrische gegevens selecteren die specifiek zijn voor het aanvragen van eenheden, opslag, latentie, beschikbaarheid, Cassandra en andere.

Aan de client-side kunt u problemen opsporen door metrische gegevens te verzamelen voor requestcharge, activiteits-ID, uitzonderingsinformatie en stacktraces, HTTP-status en substatuscode en diagnostische string.

Zie de volgende artikelen voor meer informatie en gedetailleerde instructies:

Zie Ondersteunde metrische gegevens van Azure Monitor voor een lijst met alle metrische resourcegegevens die worden ondersteund in Azure Monitor. Voor een lijst van platformmetrische gegevens die zijn verzameld voor Azure Cosmos DB, zie Monitoring Azure Cosmos DB data reference metrics.

Azure Cosmos DB programmatisch bewaken

De metrische gegevens op accountniveau die beschikbaar zijn in de portal, zoals het gebruik van accountopslag en het totale aantal aanvragen, zijn niet beschikbaar met behulp van de API voor NoSQL. U kunt echter gebruiksgegevens ophalen op verzamelingsniveau met behulp van de API voor NoSQL. Gebruik een van de volgende methoden om gegevens op verzamelingsniveau op te halen:

Gebruik de Azure Monitor SDK om toegang te krijgen tot meer metrische gegevens. Beschikbare metrische definities kunnen worden opgehaald met behulp van deze indeling:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

Gebruik de volgende indeling om afzonderlijke metrische gegevens op te halen:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

Zie Azure Monitoring REST API voor meer informatie.

Azure Cosmos DB-logboeken analyseren

Gegevens in Azure Monitor-logboeken worden opgeslagen in tabellen. Elke tabel heeft een eigen set unieke eigenschappen. Alle resourcelogboeken in Azure Monitor hebben dezelfde velden, gevolgd door servicespecifieke velden. Het algemene schema wordt beschreven in het schema voor resourcelogboeken van Azure Monitor.

Zie de naslaginformatie over bewakingsgegevens van Azure Cosmos DB voor de typen resourcelogboeken die voor Azure Cosmos DB zijn verzameld.

Zie de volgende artikelen voor meer informatie over het werken met Azure Monitor-logboeken voor Azure Cosmos DB:

Kusto-queries

U kunt bewakingsgegevens analyseren in de Azure Monitor Logs / Log Analytics-opslag met behulp van de Kusto-querytaal (KQL).

Important

Wanneer u Logs selecteert in het menu van de service in de portal, wordt Log Analytics geopend met het querybereik ingesteld op de huidige service. Dit bereik betekent dat logboekquery's alleen gegevens uit dat type resource bevatten. Als u een query wilt uitvoeren die gegevens uit andere Azure-services bevat, selecteert u Logs in het menu Azure Monitor. Zie Log-querybereik en tijdsbereik in Azure Monitor Log Analytics voor meer informatie.

Zie de interface voor Log Analytics-query's voor een lijst met algemene query's voor elke service.

Voordat u Log Analytics gebruikt om Kusto-query's uit te geven, moet u diagnostische logboeken inschakelen voor besturingsvlakbewerkingen. Wanneer u diagnostische logboeken inschakelt, selecteert u tussen het opslaan van uw gegevens in resourcespecifieke tabellen of de individuele AzureDiagnostics-tabel (verouderd). De exacte tekst van Kusto-query's is afhankelijk van de verzamelingsmodus die u selecteert.

Hier volgen enkele query's die u kunt invoeren in de zoekbalk voor logboeken om u te helpen uw Azure Cosmos DB-resources te bewaken.

Query's uitvoeren op alle logboeken van het besturingsvlak vanuit Azure Cosmos DB:

CDBControlPlaneRequests

Om te vragen naar alle logbestanden van het gegevensvlak vanuit Azure Cosmos DB:

CDBDataPlaneRequests

Als u een query wilt uitvoeren voor een gefilterde lijst met logboeken met gegevensvlakken, specifiek voor één resource:

CDBDataPlaneRequests
| where AccountName=="<account-name>"

Als u het aantal logboeken voor gegevensvlakken wilt ophalen, gegroepeerd op resource:

CDBDataPlaneRequests
| summarize count() by AccountName

Een grafiek genereren voor gegevensvlaklogboeken, gegroepeerd op het type bewerking:

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

Raadpleeg de volgende artikelen voor Kusto-query's die u kunt gebruiken om problemen met Azure Cosmos DB op te lossen:

Deze voorbeelden zijn slechts een kleine steekproef van de uitgebreide query's die u in Azure Monitor kunt uitvoeren met behulp van de Kusto-querytaal (KQL). Zie voorbeelden voor Kusto-query's voor meer voorbeelden.

Alerts

Azure Monitor-meldingen waarschuwen je proactief wanneer er specifieke voorwaarden in je bewakingsgegevens worden gevonden. Met waarschuwingen kunt u problemen in uw systeem identificeren en oplossen voordat uw klanten ze opmerken. Voor meer informatie, zie Azure Monitor-waarschuwingen.

Er zijn veel bronnen van algemene waarschuwingen voor Azure-resources. Zie Voorbeeld logboekwaarschuwingsquery's voor voorbeelden van veelvoorkomende waarschuwingen voor Azure-resources. De site Azure Monitor Baseline Alerts (AMBA) biedt een semi-geautomatiseerde methode voor het implementeren van belangrijke metrische platformwaarschuwingen, dashboards en richtlijnen. De site is van toepassing op een voortdurend uitbreidende subset van Azure-services, inclusief alle services die deel uitmaken van de Azure Landing Zone (ALZ).

Het algemene waarschuwingsschema standaardiseert het verbruik van Azure Monitor-waarschuwingsmeldingen. Zie Algemeen waarschuwingsschema voor meer informatie.

Typen waarschuwingen

U kunt een waarschuwing ontvangen voor elke metrische gegevensbron of logboekgegevensbron in het Azure Monitor-gegevensplatform. Er zijn veel verschillende typen waarschuwingen, afhankelijk van de services die u bewaakt en de bewakingsgegevens die u verzamelt. Verschillende typen waarschuwingen hebben verschillende voordelen en nadelen. Zie Het juiste waarschuwingstype voor bewaking kiezen voor meer informatie.

In de volgende lijst worden de typen Azure Monitor-waarschuwingen beschreven die u kunt maken:

  • Metrische waarschuwingen evalueren metrieken van resources met regelmatige tussenpozen. Metrieken kunnen platformmetrieken, aangepaste metrieken, logboeken die door Azure Monitor naar metrieken zijn omgezet, of metrieken van Application Insights zijn. Metrische waarschuwingen kunnen ook meerdere voorwaarden en dynamische drempelwaarden toepassen.
  • Met logboekwaarschuwingen kunnen gebruikers een Log Analytics-query gebruiken om resourcelogboeken met een vooraf gedefinieerde frequentie te evalueren.
  • Waarschuwingen voor activiteitenlogboeken worden geactiveerd wanneer een nieuwe gebeurtenis van het activiteitenlogboek plaatsvindt die overeenkomt met gedefinieerde voorwaarden. Resource Health-waarschuwingen en Service Health-waarschuwingen zijn activiteitslogboekwaarschuwingen die rapporteren over de gezondheid van uw service en resources.

Sommige Azure-services ondersteunen ook waarschuwingen voor slimme detectie, Prometheus-waarschuwingen of aanbevolen waarschuwingsregels.

Voor sommige services kunt u op schaal bewaken door dezelfde waarschuwingsregel voor metrische gegevens toe te passen op meerdere resources van hetzelfde type dat in dezelfde Azure-regio aanwezig is. Afzonderlijke meldingen worden verzonden voor elke bewaakte resource. Voor ondersteunde Azure-services en -clouds, zie Meerdere bronnen monitoren met één waarschuwingsregel.

Waarschuwingsregels voor Azure Cosmos DB

De volgende tabel bevat enkele algemene en aanbevolen waarschuwingsregels voor Azure Cosmos DB.

Waarschuwingstype Condition Description
Limitering van verzoeken per eenheid (metrische waarschuwing) Dimensienaam: StatusCode, Operator: Is gelijk aan, Dimensiewaarden: 429 Waarschuwingen als de container of een database de ingerichte doorvoerlimiet overschrijdt.
Failover van regio Operator: Groter dan, Aggregatietype: Aantal, Drempelwaarde: 1 Wanneer een failover van één regio is uitgevoerd. Deze waarschuwing is handig als u door de service beheerde failover niet hebt ingeschakeld.
Sleutels draaien (waarschuwing voor activiteitenlogboeken) Gebeurtenisniveau: Informatie, Status: gestart Waarschuwingen wanneer de accountsleutels worden gedraaid. U kunt uw toepassing bijwerken met de nieuwe sleutels.

Zie Waarschuwing maken voor metrische gegevens voor meer informatie en instructies over het maken van waarschuwingen voor Azure Cosmos DB. Als u een waarschuwing wilt maken om te controleren of opslag voor een logische partitiesleutel 20 GB nadert, raadpleegt u Waarschuwing maken over de grootte van de logische partitiesleutel.

Advisor-aanbevelingen

Voor sommige services, als er tijdens het beheer van resources kritieke omstandigheden of aanstaande wijzigingen optreden, wordt er een waarschuwing weergegeven op de overzichtspagina van de service in het portaal. Meer informatie en aanbevolen oplossingen voor de waarschuwing vindt u in Advisor-aanbevelingen onder Bewaking in het linkermenu. Tijdens normale bewerkingen worden er geen aanbevelingen van advisor weergegeven.

Zie het overzicht van Azure Advisor voor meer informatie over Azure Advisor.