Ö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 Portal, PowerShell, Azure CLI, REST API eller klientbibliotek för att konfigurera och visa övervakningsdata.
- Mer information om Azure Monitor finns i Översikt över Azure Monitor.
- Mer information om hur du övervakar Azure-resurser i allmänhet finns i Övervaka Azure-resurser med Azure Monitor.
Insikter
Vissa tjänster i Azure har en inbyggd instrumentpanel för övervakning i Azure Portal som ger 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 Portal.
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. 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/virtualMachines
till exempel . En lista över tjänster och deras associerade resurstyper finns i Resursprovidrar.
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.
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 Portal som kan köra frågor mot det här arkivet.
- Azure-aktivitetsloggen är ett separat arkiv med ett eget gränssnitt i Azure Portal.
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å dirigera vissa plattformsmått till Azure Monitor-loggar/Log Analytics så att du kan köra frågor mot dem med andra loggdata. Kontrollera DS-exportinställningen för varje mått för att se om du kan använda en diagnostikinställning för att dirigera måttet till Azure Monitor-loggar/Log Analytics.
- 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. Mer information om standardkvarhållningsperioden finns i Kvarhållning av Azure Monitor-mått
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.
- Information om partnerlösningar och verktyg som kan hjälpa dig att övervaka Azure Cosmos DB finns i Övervaka Azure Cosmos DB med hjälp av lösningar från tredje part.
- Information om hur du implementerar mikrometermått i Java SDK för Azure Cosmos DB genom att använda Prometheus-mått finns i Använda Mikrometer-klientmått för Java.
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 Portal, 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 Portal.
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.
Granska återställningsåtgärder för läget för kontinuerlig säkerhetskopiering
Genom att använda aktivitetsloggar kan du lista alla återställningar till tidpunkt för kontinuerligt läge som utfördes på ett Azure Cosmos DB-konto. Mer information om hur du visar dessa åtgärder i Azure Portal finns i Granska återställningsåtgärden för tidpunkt för kontinuerligt säkerhetskopieringsläge.
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:
Metrics Explorer, ett verktyg i Azure Portal som gör att du kan visa och analysera mått för Azure-resurser. Mer information finns i Analysera mått med Azure Monitor Metrics Explorer.
Log Analytics, ett verktyg i Azure Portal som gör att du kan köra frågor mot och analysera loggdata med hjälp av Kusto-frågespråket (KQL). Mer information finns i Kom igång med loggfrågor i Azure Monitor.
Aktivitetsloggen, som har ett användargränssnitt i Azure Portal för visning och grundläggande sökningar. Om du vill göra mer djupgående analys måste du dirigera data till Azure Monitor-loggar och köra mer komplexa frågor i Log Analytics.
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 Portal.
- Arbetsböcker, anpassningsbara rapporter som du kan skapa i Azure Portal. 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:
- Övervaka svarstid på serversidan
- Övervaka enhetsanvändning för begäranden
- Övervaka normaliserad enhetsanvändning för begäranden
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 använda REST-API: et utför du en GET på samlingen. Kvot- och användningsinformationen för samlingen returneras i
x-ms-resource-quota
huvudena ochx-ms-resource-usage
i svaret.Om du vill använda .NET SDK använder du metoden DocumentClient.ReadDocumentCollectionAsync , som returnerar en ResourceResponse som innehåller många användningsegenskaper som CollectionSizeUsage, DatabaseUsage och DocumentUsage.
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:
- Övervaka data med hjälp av Azure Diagnostic-inställningar
- Granska kontrollplansloggar
- Lägga till en transformering för arbetsytedata
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 Loggar på Azure 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.
- Se Felsöka problem med diagnostikfrågor för enkla frågor som hjälper dig att felsöka problem med din Azure Cosmos DB.
- Mer avancerade frågor finns i Felsöka problem med avancerade diagnostikfrågor med Azure Cosmos DB för NoSQL för mer avancerade frågor som hjälper dig att felsöka problem med ditt Azure Cosmos DB-konto med hjälp av diagnostikloggar som skickas till azure-diagnostiktabeller (äldre) och resursspecifika tabeller (förhandsversion).
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:
- Felsöka problem med hjälp av grundläggande frågor
- Felsöka problem med hjälp av avancerade diagnostikfrågor
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.
Relaterat innehåll
- Se Referens för Azure Cosmos DB-övervakningsdata för en referens till mått, loggar och andra viktiga värden som skapats för Azure Cosmos DB.
- Mer information om övervakning av Azure-resurser finns i Övervaka Azure-resurser med Azure Monitor .