Övervaka Azure Cosmos DB

I den här artikeln beskrivs:

  • De typer av övervakningsdata som du kan samla in för den här tjänsten.
  • Sätt att analysera dessa data.

Kommentar

Om du redan är bekant med den här tjänsten och/eller Azure Monitor och bara vill veta hur du analyserar övervakningsdata kan du läsa avsnittet Analysera i slutet av den här artikeln.

När du har viktiga program och affärsprocesser som är beroende av Azure-resurser måste du övervaka och få aviseringar för systemet. Azure Monitor-tjänsten samlar in och aggregerar mått och loggar från varje komponent i systemet. Azure Monitor ger dig en översikt över tillgänglighet, prestanda och motståndskraft och meddelar dig om problem. Du kan använda Azure-portalen, PowerShell, Azure CLI, REST API eller klientbibliotek för att konfigurera och visa övervakningsdata.

Insikter

Vissa tjänster i Azure har en inbyggd instrumentpanel för övervakning i Azure-portalen som är en startpunkt för övervakning av din tjänst. Dessa instrumentpaneler kallas insikter och du hittar dem i Insights Hub i Azure Monitor i Azure-portalen.

Azure Cosmos DB-insikter

Azure Cosmos DB-insikter är en funktion som baseras på arbetsboksfunktionen i Azure Monitor. Använd Azure Cosmos DB-insikter för en vy över övergripande prestanda, fel, kapacitet och driftshälsa för alla dina Azure Cosmos DB-resurser i en enhetlig interaktiv upplevelse.

Mer information om Azure Cosmos DB-insikter finns i följande artiklar:

Resurstyper

Azure använder begreppet resurstyper och ID:t för att identifiera allt i en prenumeration. Azure Monitor organiserar på liknande sätt kärnövervakningsdata i mått och loggar baserat på resurstyper, även kallade namnområden. Olika mått och loggar är tillgängliga för olika resurstyper. Tjänsten kan vara associerad med mer än en resurstyp.

Resurstyper ingår också i resurs-ID:t för varje resurs som körs i Azure. En resurstyp för en virtuell dator är Microsoft.Compute/virtualMachinestill exempel . En lista över tjänster och deras associerade resurstyper finns i Resursprovidrar.

Mer information om resurstyperna för Azure Cosmos DB finns i Referens för Azure Cosmos DB-övervakningsdata.

Datalagring

För Azure Monitor:

  • Måttdata lagras i Azure Monitor-måttdatabasen.
  • Loggdata lagras i Azure Monitor-loggarkivet. Log Analytics är ett verktyg i Azure-portalen som kan köra frågor mot det här arkivet.
  • Azure-aktivitetsloggen är ett separat arkiv med ett eget gränssnitt i Azure-portalen.

Du kan också dirigera mått- och aktivitetsloggdata till Azure Monitor-loggarkivet. Du kan sedan använda Log Analytics för att fråga efter data och korrelera dem med andra loggdata.

Många tjänster kan använda diagnostikinställningar för att skicka mått- och loggdata till andra lagringsplatser utanför Azure Monitor. Exempel är Azure Storage, värdbaserade partnersystem och icke-Azure-partnersystem med hjälp av Event Hubs.

Detaljerad information om hur Azure Monitor lagrar data finns i Azure Monitor-dataplattformen.

Azure Monitor-plattformsmått

Azure Monitor tillhandahåller plattformsmått för de flesta tjänster. Dessa mått är:

  • Individuellt definierad för varje namnområde.
  • Lagras i azure monitor-databasen för tidsseriemått.
  • Lätt och kan stödja nästan realtidsaviseringar.
  • Används för att spåra prestanda för en resurs över tid.

Samling: Azure Monitor samlar in plattformsmått automatiskt. Ingen konfiguration krävs.

Routning: Du kan också vanligtvis dirigera plattformsmått till Azure Monitor-loggar/Log Analytics så att du kan köra frågor mot dem med andra loggdata. Mer information finns i diagnostikinställningen Mått. Information om hur du konfigurerar diagnostikinställningar för en tjänst finns i Skapa diagnostikinställningar i Azure Monitor.

En lista över alla mått som du kan samla in för alla resurser i Azure Monitor finns i Mått som stöds i Azure Monitor.

Azure Monitor samlar in Azure Cosmos DB-mått som standard. Du behöver inte uttryckligen konfigurera något. De flesta måtten är tillgängliga från Azure Cosmos DB-portalsidan eller från Azure Monitor-sidan. Som standard samlas måtten in med en minuts kornighet. Kornigheten kan variera beroende på vilket mått du väljer. Som standard har dessa mått en kvarhållningsperiod på 30 dagar.

Azure Cosmos DB-mått på serversidan omfattar dataflöde, lagring, tillgänglighet, svarstid, konsekvens och mått på systemnivå. På klientsidan kan du samla in information om avgifter för begäran, aktivitets-ID, spårningsinformation för undantag och stack, HTTP-status och kod för understatus samt diagnostiksträng. Som standard har dessa mått en kvarhållningsperiod på sju dagar. Du kan använda dessa data för att felsöka problem eller om du behöver kontakta Azure Cosmos DB-supportteamet.

Dimensionsvärdena för måtten, till exempel containernamn, är skiftlägesokänsliga. Den här situationen kan leda till förvirring eller kollision av telemetri och åtgärder på containrar med sådana namn. Använd skiftlägesokänslig jämförelse när du gör strängjämförelser på dessa dimensionsvärden.

En lista över tillgängliga mått för Azure Cosmos DB finns i Referens för Azure Cosmos DB-övervakningsdata.

Icke-Azure Monitor-baserade mått

Den här tjänsten tillhandahåller andra mått som inte ingår i Azure Monitor-måttdatabasen.

Azure Monitor-resursloggar

Resursloggar ger insikter om åtgärder som har utförts av en Azure-resurs. Loggar genereras automatiskt, men du måste dirigera dem till Azure Monitor-loggar för att spara eller köra frågor mot dem. Loggar ordnas i kategorier. Ett givet namnområde kan ha flera resursloggkategorier.

Samling: Resursloggar samlas inte in och lagras förrän du skapar en diagnostikinställning och dirigerar loggarna till en eller flera platser. När du skapar en diagnostikinställning anger du vilka kategorier av loggar som ska samlas in. Det finns flera sätt att skapa och underhålla diagnostikinställningar, inklusive Azure-portalen, programmatiskt och via Azure Policy.

Routning: Det föreslagna standardvärdet är att dirigera resursloggar till Azure Monitor-loggar så att du kan köra frågor mot dem med andra loggdata. Andra platser som Azure Storage, Azure Event Hubs och vissa Microsoft-övervakningspartner är också tillgängliga. Mer information finns i Azure-resursloggar och Resursloggmål.

Detaljerad information om hur du samlar in, lagrar och dirigerar resursloggar finns i Diagnostikinställningar i Azure Monitor.

En lista över alla tillgängliga resursloggkategorier i Azure Monitor finns i Resursloggar som stöds i Azure Monitor.

Alla resursloggar i Azure Monitor har samma rubrikfält följt av tjänstspecifika fält. Det vanliga schemat beskrivs i Azure Monitor-resursloggschemat.

Du kan övervaka diagnostikloggar från ditt Azure Cosmos DB-konto och skapa instrumentpaneler från Azure Monitor. Data som händelser och spårningar som inträffar vid en andra kornighet lagras som loggar. Om dataflödet för en container till exempel ändras ändras egenskaperna för ett Azure Cosmos DB-konto. Loggarna avbildar dessa händelser. Du kan analysera dessa loggar genom att köra frågor på insamlade data.

Information om tillgängliga resursloggkategorier, deras associerade Log Analytics-tabeller och loggscheman för Azure Cosmos DB finns i Referens för Övervakningsdata för Azure Cosmos DB.

Azure-aktivitetslogg

Aktivitetsloggen innehåller händelser på prenumerationsnivå som spårar åtgärder för varje Azure-resurs som visas utanför resursen. till exempel att skapa en ny resurs eller starta en virtuell dator.

Samling: Aktivitetslogghändelser genereras automatiskt och samlas in i ett separat arkiv för visning i Azure-portalen.

Routning: Du kan skicka aktivitetsloggdata till Azure Monitor-loggar så att du kan analysera dem tillsammans med andra loggdata. Andra platser som Azure Storage, Azure Event Hubs och vissa Microsoft-övervakningspartner är också tillgängliga. Mer information om hur du dirigerar aktivitetsloggen finns i Översikt över Azure-aktivitetsloggen.

Analysera övervakningsdata

Det finns många verktyg för att analysera övervakningsdata.

Azure Monitor-verktyg

Azure Monitor har stöd för följande grundläggande verktyg:

Verktyg som möjliggör mer komplex visualisering är:

  • Instrumentpaneler som gör att du kan kombinera olika typer av data i ett enda fönster i Azure-portalen.
  • Arbetsböcker, anpassningsbara rapporter som du kan skapa i Azure-portalen. Arbetsböcker kan innehålla text-, mått- och loggfrågor.
  • Grafana, ett öppet plattformsverktyg som utmärker sig i operativa instrumentpaneler. Du kan använda Grafana för att skapa instrumentpaneler som innehåller data från flera andra källor än Azure Monitor.
  • Power BI, en tjänst för affärsanalys som tillhandahåller interaktiva visualiseringar mellan olika datakällor. Du kan konfigurera Power BI för att automatiskt importera loggdata från Azure Monitor för att dra nytta av dessa visualiseringar.

Exportverktyg för Azure Monitor

Du kan hämta data från Azure Monitor till andra verktyg med hjälp av följande metoder:

  • Mått: Använd REST-API:et för mått för att extrahera måttdata från Azure Monitor-måttdatabasen. API:et stöder filteruttryck för att förfina de data som hämtas. Mer information finns i Azure Monitor REST API-referens.

  • Loggar: Använd REST-API:et eller de associerade klientbiblioteken.

  • Ett annat alternativ är dataexporten för arbetsytan.

Information om hur du kommer igång med REST-API:et för Azure Monitor finns i Genomgång av REST API för Azure-övervakning.

Analysera Azure Cosmos DB-mått

Du kan använda Azure Monitor Metrics Explorer för att analysera mått för Azure Cosmos DB med mått från andra Azure-tjänster genom att välja Mått under Övervakning i azure Cosmos DB-kontoportalens navigering. Mer information om hur du använder Metrics Explorer finns i Analysera mått med Azure Monitor Metrics Explorer.

Du kan övervaka svarstid på serversidan, enhetsanvändning för begäranden och normaliserad användning av begärandeenheter för dina Azure Cosmos DB-resurser. Du kan välja mått som är specifika för enheter för begäranden, lagring, svarstid, tillgänglighet, Cassandra och andra.

På klientsidan kan du felsöka problem genom att samla in mått för avgift för begäran, aktivitets-ID, spårningsinformation för undantag och stack, HTTP-status och understatuskod samt diagnostiksträng.

Mer information och detaljerade instruktioner finns i följande artiklar:

En lista över alla resursmått som stöds i Azure Monitor finns i Azure Monitor-mått som stöds. En lista över de plattformsmått som samlats in för Azure Cosmos DB finns i Övervaka datareferensmått för Azure Cosmos DB.

Övervaka Azure Cosmos DB programmatiskt

De mått på kontonivå som är tillgängliga i portalen, till exempel användning av kontolagring och totalt antal begäranden, är inte tillgängliga med hjälp av API:et för NoSQL. Du kan dock hämta användningsdata på insamlingsnivå med hjälp av API:et för NoSQL. Om du vill hämta data på insamlingsnivå använder du någon av följande metoder:

Om du vill få åtkomst till fler mått använder du Azure Monitor SDK. Tillgängliga måttdefinitioner kan hämtas med det här formatet:

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

Använd följande format för att hämta enskilda mått:

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

Mer information finns i Azure monitoring REST API (Azure Monitoring REST API).

Analysera Azure Cosmos DB-loggar

Data i Azure Monitor-loggar lagras i tabeller. Varje tabell har en egen uppsättning unika egenskaper. Alla resursloggar i Azure Monitor har samma fält följt av tjänstspecifika fält. Det vanliga schemat beskrivs i Azure Monitor-resursloggschemat.

De typer av resursloggar som samlas in för Azure Cosmos DB finns i Referens för Azure Cosmos DB-övervakningsdata.

Mer information om hur du arbetar med Azure Monitor-loggar för Azure Cosmos DB finns i följande artiklar:

Kusto-frågor

Du kan analysera övervakningsdata i Azure Monitor-loggar/Log Analytics-arkivet med hjälp av Kusto-frågespråket (KQL).

Viktigt!

När du väljer Loggar på tjänstens meny i portalen öppnas Log Analytics med frågeomfånget inställt på den aktuella tjänsten. Det här omfånget innebär att loggfrågor endast innehåller data från den typen av resurs. Om du vill köra en fråga som innehåller data från andra Azure-tjänster väljer du LoggarAzure Monitor-menyn . Mer information finns i Log query scope and time range in Azure Monitor Log Analytics (Loggfrågeomfång och tidsintervall i Azure Monitor Log Analytics ).

En lista över vanliga frågor för alla tjänster finns i Log Analytics-frågegränssnittet.

Innan du använder Log Analytics för att utfärda Kusto-frågor måste du aktivera diagnostikloggar för kontrollplansåtgärder. När du aktiverar diagnostikloggar väljer du mellan att lagra dina data i resursspecifika tabeller eller den enda AzureDiagnostics-tabellen (äldre). Den exakta texten i Kusto-frågor beror på det samlingsläge du väljer.

Här följer några frågor som du kan ange i sökfältet för loggsökning som hjälper dig att övervaka dina Azure Cosmos DB-resurser.

Så här frågar du efter alla kontrollplansloggar från Azure Cosmos DB:

CDBControlPlaneRequests

Så här frågar du efter alla dataplansloggar från Azure Cosmos DB:

CDBDataPlaneRequests

Så här frågar du efter en filtrerad lista över dataplansloggar som är specifika för en enskild resurs:

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

För att få ett antal dataplansloggar grupperade efter resurs:

CDBDataPlaneRequests
| summarize count() by AccountName

Så här genererar du ett diagram för dataplansloggar, grupperat efter typ av åtgärd:

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

Information om Kusto-frågor som du kan använda för att felsöka problem med Azure Cosmos DB finns i följande artiklar:

De här exemplen är bara ett litet urval av de omfattande frågor som du kan köra i Azure Monitor med hjälp av Kusto-frågespråk (KQL). Fler exempel finns i exempel för Kusto-frågor.

Aviseringar

Azure Monitor-aviseringar meddelar dig proaktivt när specifika villkor finns i dina övervakningsdata. Med aviseringar kan du identifiera och åtgärda problem i systemet innan kunderna märker dem. Mer information finns i Azure Monitor-aviseringar.

Det finns många källor till vanliga aviseringar för Azure-resurser. Exempel på vanliga aviseringar för Azure-resurser finns i Exempelloggaviseringsfrågor. Webbplatsen Azure Monitor Baseline Alerts (AMBA) innehåller en halvautomatiserad metod för att implementera viktiga plattformsmåttaviseringar, instrumentpaneler och riktlinjer. Webbplatsen gäller för en kontinuerligt expanderande delmängd av Azure-tjänster, inklusive alla tjänster som ingår i Azure Landing Zone (ALZ).

Det gemensamma aviseringsschemat standardiserar förbrukningen av Azure Monitor-aviseringsmeddelanden. Mer information finns i Vanliga aviseringsscheman.

Typer av aviseringar

Du kan avisera om valfritt mått eller loggdatakälla på Azure Monitor-dataplattformen. Det finns många olika typer av aviseringar beroende på vilka tjänster du övervakar och de övervakningsdata som du samlar in. Olika typer av aviseringar har olika fördelar och nackdelar. Mer information finns i Välj rätt övervakningsaviseringstyp.

I följande lista beskrivs de typer av Azure Monitor-aviseringar som du kan skapa:

  • Måttaviseringar utvärderar resursmått med jämna mellanrum. Mått kan vara plattformsmått, anpassade mått, loggar från Azure Monitor som konverterats till mått eller Application Insights-mått. Måttaviseringar kan också tillämpa flera villkor och dynamiska tröskelvärden.
  • Med loggaviseringar kan användare använda en Log Analytics-fråga för att utvärdera resursloggar med en fördefinierad frekvens.
  • Aktivitetsloggaviseringar utlöses när en ny aktivitetslogghändelse inträffar som matchar definierade villkor. Resource Health-aviseringar och Service Health-aviseringar är aktivitetsloggaviseringar som rapporterar om tjänstens och resurshälsan.

Vissa Azure-tjänster stöder även aviseringar om smart identifiering, Prometheus-aviseringar eller rekommenderade aviseringsregler.

För vissa tjänster kan du övervaka i stor skala genom att tillämpa samma måttaviseringsregel på flera resurser av samma typ som finns i samma Azure-region. Enskilda meddelanden skickas för varje övervakad resurs. Information om Azure-tjänster och moln som stöds finns i Övervaka flera resurser med en aviseringsregel.

Azure Cosmos DB-aviseringsregler

I följande tabell visas några vanliga och rekommenderade aviseringsregler för Azure Cosmos DB.

Aviseringstyp Villkor beskrivning
Hastighetsbegränsning för enheter för begäranden (måttavisering) Dimensionsnamn: StatusCode, Operator: Lika med, Dimensionsvärden: 429 Aviseringar om containern eller en databas har överskridit gränsen för etablerat dataflöde.
Region rederover Operator: Större än, sammansättningstyp: Antal, Tröskelvärde: 1 När en enskild region redväxeleras. Den här aviseringen är användbar om du inte har aktiverat tjänsthanterad redundansväxling.
Rotera nycklar (aktivitetsloggavisering) Händelsenivå: Information, Status: startad Aviseringar när kontonycklarna roteras. Du kan uppdatera programmet med de nya nycklarna.

Mer information och instruktioner om hur du skapar aviseringar för Azure Cosmos DB finns i Skapa avisering om mått. Information om hur du skapar en avisering för att övervaka om lagringen för en logisk partitionsnyckel närmar sig 20 GB finns i Skapa avisering om nyckelstorlek för logisk partition.

Advisor-rekommendationer

För vissa tjänster, om kritiska villkor eller överhängande ändringar inträffar under resursåtgärder, visas en avisering på sidan Tjänstöversikt i portalen. Du hittar mer information och rekommenderade korrigeringar för aviseringen i Advisor-rekommendationer under Övervakning i den vänstra menyn. Under normal drift visas inga advisor-rekommendationer.

Mer information om Azure Advisor finns i Översikt över Azure Advisor.