Azure Cosmos DB controleren

  • Artikel

In dit artikel wordt het volgende beschreven:

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

Notitie

Als u al bekend bent met deze service en/of Azure Monitor en alleen wilt weten hoe u bewakingsgegevens analyseert, raadpleegt u de sectie Analyseren 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 een overzicht van beschikbaarheid, prestaties en tolerantie, en geeft u een overzicht van problemen. U kunt de Azure-portal, PowerShell, Azure CLI, REST API of clientbibliotheken gebruiken om bewakingsgegevens in te stellen en weer te geven.

Inzichten

Sommige services in Azure hebben een ingebouwd bewakingsdashboard in Azure Portal dat een beginpunt biedt voor het bewaken van uw service. Deze dashboards worden inzichten genoemd en u kunt ze vinden in de Insights Hub van Azure Monitor in 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. Azure Monitor organiseert op dezelfde manier kernbewakingsgegevens in metrische gegevens en logboeken op basis van resourcetypen, ook wel naamruimten genoemd. Er zijn verschillende metrische gegevens en logboeken beschikbaar voor verschillende resourcetypen. Uw service is mogelijk gekoppeld aan meer dan één resourcetype.

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 Microsoft.Compute/virtualMachinesbijvoorbeeld . Zie Resourceproviders voor een lijst met services en de bijbehorende resourcetypen.

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 het logboekarchief van Azure Monitor. Log Analytics is een hulpprogramma in Azure Portal waarmee een query kan worden uitgevoerd op dit archief.
  • 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 het 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 metrische gegevensdatabase van Azure Monitor.
  • Lichtgewicht en in staat om bijna realtime waarschuwingen te ondersteunen.
  • 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 ook meestal metrische platformgegevens routeren naar Azure Monitor-logboeken/Log Analytics, zodat u er query's op kunt uitvoeren met andere logboekgegevens. Zie de diagnostische instelling voor metrische gegevens voor meer informatie. Zie Diagnostische instellingen maken in Azure Monitor voor informatie over het configureren van diagnostische instellingen voor een service.

Zie Ondersteunde metrische gegevens in Azure Monitor voor een lijst met alle metrische gegevens die kunnen worden verzameld voor alle resources 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. Deze metrische gegevens hebben standaard een bewaarperiode van 30 dagen.

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. Use case ongevoelig vergelijken bij het uitvoeren van tekenreeksvergelijkingen 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.

Azure Monitor-resourcelogboeken

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 resourcelogboekcategorieën hebben.

Verzameling: Resourcelogboeken worden pas verzameld en opgeslagen als u een diagnostische instelling maakt en de logboeken doorsturen naar een of meer locaties. 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 Azure Portal, programmatisch en hoewel 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. Zie Azure-resourcelogboeken en resourcelogboekbestemmingen voor meer informatie.

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.

Voor de beschikbare resourcelogboekcategorieën, de bijbehorende Log Analytics-tabellen en de logboekschema's voor Azure Cosmos DB raadpleegt u de referentie voor bewakingsgegevens van 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.

Verzameling: gebeurtenissen in activiteitenlogboeken worden automatisch gegenereerd en verzameld in een afzonderlijk archief voor weergave in Azure Portal.

Routering: U kunt activiteitenlogboekgegevens verzenden naar Azure Monitor-logboeken, zodat 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.

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.
  • Werkmappen, aanpasbare rapporten die u kunt maken in Azure Portal. 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-exporthulpprogramma's

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

Als u aan de slag wilt gaan met de REST API voor Azure Monitor, raadpleegt u de stapsgewijze instructies voor Azure Monitoring REST API.

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 clientzijde kunt u problemen opsporen door metrische gegevens te verzamelen voor aanvraagkosten, activiteits-id, uitzonderings- en stacktraceringsgegevens, HTTP-status en substatuscode en diagnostische tekenreeks.

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. Zie Metrische gegevens van Azure Cosmos DB bewaken voor een lijst met metrische platformgegevens die zijn verzameld voor Azure Cosmos DB.

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-query's

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

Belangrijk

Wanneer u Logboeken 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 Logboeken 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

Een query uitvoeren op alle logboeken 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.

Waarschuwingen

Azure Monitor-waarschuwingen melden u proactief wanneer er specifieke voorwaarden worden gevonden in uw bewakingsgegevens. Met waarschuwingen kunt u problemen in uw systeem identificeren en oplossen voordat uw klanten ze opmerken. Zie Azure Monitor-waarschuwingen voor meer informatie.

Er zijn veel bronnen van algemene waarschuwingen voor Azure-resources. Zie Voorbeeldquery's voor logboekwaarschuwingen 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 met regelmatige tussenpozen resourcegegevens. Metrische gegevens kunnen metrische platformgegevens, aangepaste metrische gegevens, logboeken van Azure Monitor zijn geconverteerd naar metrische gegevens of metrische Gegevens van Application Insights. 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 waarschuwingen voor activiteitenlogboeken die rapporteren over uw service en resourcestatus.

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. Zie Meerdere resources bewaken met één waarschuwingsregel voor ondersteunde Azure-services en -clouds.

Waarschuwingsregels voor Azure Cosmos DB

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

Waarschuwingstype Voorwaarde Beschrijving
Snelheidsbeperking voor aanvraageenheden (metrische waarschuwing) Dimensienaam: StatusCode, Operator: Is gelijk aan, Dimensiewaarden: 429 Waarschuwingen als de container of een database de ingerichte doorvoerlimiet heeft overschreden.
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 kritieke omstandigheden of aanstaande wijzigingen optreden tijdens resourcebewerkingen, wordt een waarschuwing weergegeven op de pagina Serviceoverzicht in de portal. 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.

Gerelateerde inhoud