Az Azure Cosmos DB monitorozása

A következőkre vonatkozik: SQL API CASSANDRA API Gremlin API Table API Azure Cosmos db API a MongoDB

Ha kritikus fontosságú alkalmazásokkal és üzleti folyamatokkal rendelkezik, amelyek Azure-erőforrásokra támaszkodnak, monitorozással szeretné figyelni az erőforrások rendelkezésre állását, teljesítményét és működését. Ez a cikk az Azure Cosmos-adatbázisok által létrehozott monitorozási adatokat ismerteti, valamint azt, hogyan elemezheti az adatokat és állíthat be hozzájuk riasztást az Azure Monitor funkcióinak használatával.

Az adatokat ügyféloldali és kiszolgálóoldali metrikák segítségével figyelheti. Kiszolgálóoldali metrikák használata esetén a következő beállításokkal figyelheti a Azure Cosmos DB tárolt adatokat:

  • Monitor az Azure Cosmos DB portálról: A monitorokat az Azure Cosmos-fiók Metrikák lapján elérhető metrikák használatával figyelheti. A lapon látható metrikák közé tartozik az átviteli sebesség, a tárterület, a rendelkezésre állás, a késés, a konzisztencia és a rendszerszintű metrikák. Alapértelmezés szerint ezeknek a metrikáknak a megőrzési időtartama 7 nap. További tudnivalókért tekintse meg a cikk Azure Cosmos DB monitorozási adatokról című szakaszát.

  • Monitor a metrikák használatával az Azure Monitorban: Az Azure Cosmos-fiók metrikák figyelése és irányítópultok létrehozása a Azure Monitor. Azure Monitor gyűjti Azure Cosmos DB metrikákat, nincs explicit módon konfigurálva semmi. Ezek a metrikák egyperces részletességgel vannak összegyűjtve, a részletesség a választott metrika alapján változhat. Alapértelmezés szerint ezeknek a metrikáknak a megőrzési időtartama 30 nap. Az előző lehetőségekből elérhető legtöbb metrika ezekben a metrikákban is elérhető. A metrikák dimenzióértékei, például a tároló neve, nem érzékenyek a kis- és a nagy Ezért a kis- és a nagy- és a kis- és nagy léptékű összehasonlítást is használnia kell. További tudnivalókat a cikk Metrikaadatok elemzése című szakaszában talál.

  • Figyelheti a diagnosztikai naplókat a Azure Monitor: Figyelheti Azure Cosmos-fiókjának naplóit, és irányítópultokat hozhat létre a Azure Monitor. A második részletességnél előforduló telemetriai adatokat, például eseményeket és nyomkövetéseket a rendszer naplókként tárolja. Ha például egy tároló átviteli sebességének megváltozik, a Cosmos-fiók tulajdonságai megváltoznak, ezek az események a naplókban vannak rögzítve. Ezeket a naplókat úgy elemezheti, hogy lekérdezéseket futtat a gyűjtött adatokon. További tudnivalókat a cikk Naplóadatok elemzése című szakaszában talál.

  • Programozott figyelés AZDK-okkal: Azure Cosmos-fiókját programozott módon monitorozhatja a .NET, Java, Python, Node.js SZOFTVERDK-k, valamint a REST API. További információt a cikk Azure Cosmos DB programozott módon című szakaszában talál.

Az alábbi képen a fiókon keresztül Azure Cosmos DB különböző Azure Portal:

A Azure Portal

Az Azure Cosmos DB használata esetén az ügyféloldalon összegyűjtheti az esetlegesen előforduló problémák hibakereséséhez szükséges kérelemdíj, tevékenységazonosító, kivétel/verem nyomkövetési adatait, a HTTP-állapot/alállapotkód és a diagnosztikai sztring adatait. Ezek az információk akkor is szükségesek, ha a támogatási Azure Cosmos DB kell.

Figyelés áttekintése

Az egyes Azure Cosmos DB-fiókok áttekintési Azure Portal oldala rövid áttekintést nyújt az erőforrás-használatról, például az összes kérésről, az adott HTTP-állapotkódot eredményező kérelmekről és az óránkénti számlázásról. Ez az információ hasznos, de csak kis mennyiségű figyelési adat érhető el ezen a panelen. Ezen adatok egy része automatikusan gyűjthető, és az erőforrás létrehozása után már elérhető elemzésre. Bizonyos konfigurációval további adatgyűjtési típusokat is engedélyezhet.

Mi az Azure Monitor?

Azure Cosmos DB a Azure Monitor használatával hoz létre monitorozási adatokat, amely egy teljes körű monitorozási szolgáltatás az Azure-ban, amely a más felhőkben és a helyszínen található erőforrások mellett az Azure-erőforrások monitorozására is teljes körű funkciókat biztosít.

Ha még nem ismeri az Azure-szolgáltatások monitorozását, kezdje az Azure-erőforrások monitorozása a Azure Monitor alábbi fogalmakat leíró cikkel:

  • Mi az Azure Monitor?
  • A monitorozással kapcsolatos költségek
  • Az Azure-ban gyűjtött monitorozási adatok
  • Adatgyűjtés konfigurálása
  • Standard eszközök az Azure-ban az adatok monitorozásának elemzéséhez és riasztáshoz

A következő szakaszok erre a cikkre épülnek, és ismertetik a Azure Cosmos DB gyűjtött adatokat, és példákat mutatnak be az adatgyűjtés konfigurálásához és az adatok Azure-eszközökkel való elemzéséhez.

Cosmos DB elemzések

Cosmos DB elemzés a munkafüzetek funkción Azure Monitor alapul, és az alábbi szakaszokban ismertetett Azure Cosmos DB gyűjtött monitorozási adatokat használja. Az Azure Monitor segítségével megtekintheti az összes Azure Cosmos DB-erőforrás általános teljesítményét, meghibásodását, kapacitását és működési állapotát egy egységes interaktív felhasználói élményben, a Azure Monitor egyéb funkcióit pedig részletes elemzésre és riasztásra használhatja. További tudnivalókért tekintse meg a További Cosmos DB elemzések megtekintése cikket.

Megjegyzés

A tárolók létrehozásakor ügyeljen arra, hogy ne két tárolót hozzon létre ugyanazokkal a névvel, hanem eltérő kis- és nagy méretű tárolókat. Ennek az az oka, hogy az Azure platform egyes részei nem érzékenyek a kis- és nagybetűkre, és ez félreértéseket/ütközéseket okozhat a telemetriákban és az ilyen nevekkel a tárolókon.

Adatok figyelése

Azure Cosmos DB gyűjti a monitorozási adatokat, mint a többi Azure-erőforrás, amelyeket az Adatok monitorozása Azure-erőforrásokból leírásban ismertet. A Azure Cosmos DB által létrehozott naplók és metrikák részletes referencia-Azure Cosmos DB.

Az egyes Azure Cosmos Azure Portal adatbázisok áttekintési oldalán rövid áttekintést kap az adatbázis használatáról, beleértve a kérést és az óránkénti számlázást. Ez hasznos információ, de csak kis mennyiségű monitorozási adat áll rendelkezésre. Ezen adatok egy része automatikusan gyűjthető és elemzésre elérhető az adatbázis létrehozása után, miközben bizonyos konfigurációk esetén további adatgyűjtést is engedélyezhet.

Áttekintő oldal

Gyűjtés és útválasztás

A rendszer gyűjti és tárolja a platformmetrikákat és a tevékenységnaplót, de diagnosztikai beállítással más helyekre is irányítható.

A rendszer addig nem gyűjti és tárolja az erőforrásnaplókat, amíg nem hoz létre diagnosztikai beállítást, és nem irányít át egy vagy több helyre.

A Diagnosztikai beállítás létrehozása platformnaplók és metrikák gyűjtéséhez az Azure-ban szakasz részletesen beosztja a diagnosztikai beállítások létrehozását a Azure Portal és néhány diagnosztikai lekérdezési példával. Diagnosztikai beállítás létrehozásakor meg kell adnia, hogy a naplók mely kategóriáit gyűjtse össze.

A begyűjthető metrikákat és naplókat a következő szakaszok ismertetik.

Metrikák elemzése

Azure Cosmos DB egyéni felhasználói élményt biztosít a metrikákhoz. A metrikák metrikák elemzéséhez Azure Cosmos DB Azure-szolgáltatások metrikákat a Metrikák explorer használatával, ha megnyitja a Metrikákat a Azure Monitor menüből. Az eszköz használatával kapcsolatos Metrikaböngésző az Azure Metrikaböngésző első lépések. Azt is ellenőrizheti, hogyan figyelheti a kiszolgálóoldali késést,a kérelemegység-használatot és a kérelemegység-használat normalizált használatát a Azure Cosmos DB erőforrásaihoz.

Az adatokhoz gyűjtött platformmetrikák listájáért lásd a Azure Cosmos DB adatokra vonatkozó Azure Cosmos DB metrikák figyelése cikket.

Az összes Azure Cosmos DB standard metrikák névterében Cosmos DB vannak. A következő dimenziókat használhatja ezekkel a metrikákkal, amikor szűrőt ad hozzá egy diagramhoz:

  • CollectionName
  • DatabaseName
  • OperationType
  • Region
  • StatusCode (Állapotkód)

Referenciaként a következőben támogatott összes erőforrás-metrikát Azure Monitor.

Műveletszintű metrikák megtekintése Azure Cosmos DB

  1. Jelentkezzen be az Azure Portalra.

  2. A bal oldali navigációs sávon válassza a Monitor, majd a Metrikák lehetőséget.

    Metrikák panel a Azure Monitor

  3. A Metrikák panelen > Válasszon ki egy erőforráscsoportot> válassza ki a szükséges előfizetést és erőforráscsoportot. Az Erőforrástípus mezőben válassza a Azure Cosmos DB lehetőséget, válasszon ki egy meglévő Azure Cosmos-fiókot, majd válassza az Alkalmaz lehetőséget.

    Válasszon ki egy Cosmos DB-fiókot a metrikák megtekintéséhez

  4. Ezután kiválaszthat egy metrikát az elérhető metrikák listájából. Kiválaszthatja a kérelemegységekre, a tárterületre, a késésre, a rendelkezésre állásra, a Cassandrára és egyebekre vonatkozó metrikákat. A listában elérhető összes metrikával kapcsolatos részletes információkért tekintse meg a Metrikák kategória szerint cikket. Ebben a példában válassza a Kérelemegységek és az Átlag lehetőséget összesítési értékként.

    Ezen adatok mellett a metrikák Időtartomány és Idő részletessége is kiválasztható. Az elmúlt 30 nap metrikai legfeljebb megtekinthetők. A szűrő alkalmazása után egy diagram jelenik meg a szűrő alapján. A kiválasztott időszakban percenként felhasznált kérelemegységek átlagos számát láthatja.

    Válasszon metrikát a Azure Portal

Szűrők hozzáadása metrikákhoz

A metrikákat és a megadott CollectionName, DatabaseName, OperationType, Region és StatusCode paraméterekkel megjelenített diagramot is szűrheti. A metrikák szűréséhez válassza a Szűrő hozzáadása lehetőséget, válassza ki a kötelező tulajdonságot, például az OperationType tulajdonságot, és válasszon egy értéket, például a Lekérdezés lehetőséget. A diagram ezután megjeleníti a lekérdezési művelethez felhasznált kérelemegységeket a kiválasztott időszakra vonatkozóan. A tárolt eljárással végrehajtott műveleteket a rendszer nem naplózza, ezért nem érhetők el az OperationType metrika alatt.

Szűrő hozzáadása a metrika részletességének kiválasztásához

A metrikákat a Felosztás alkalmazása lehetőséggel csoportosíthatja. Csoportosíthatja például a kérelemegységeket művelettípusonként, és megtekintheti az összes művelet grafikonját az alábbi képen látható módon:

Felosztási szűrő alkalmazása

Naplók elemzése

A naplók Azure Monitor a naplók olyan táblákban vannak tárolva, ahol minden tábla saját egyedi tulajdonságokkal rendelkezik.

Az erőforrásnaplókban Azure Monitor ugyanazokkal a mezőkkel, majd a szolgáltatásspecifikus mezőkkel. A közös sémát az erőforrásnapló Azure Monitor ismertetve. A naplókhoz gyűjtött erőforrásnaplók típusainak listájáért tekintse meg a Azure Cosmos DB adatok figyelése Azure Cosmos DB referenciáját.

A tevékenységnapló egy azure-beli platformra való bejelentkezés, amely betekintést nyújt az előfizetés-szintű eseményekbe. A naplókat külön is megtekintheti, vagy a Azure Monitor naplókba irányíthatja, ahol sokkal összetettebb lekérdezéseket is el lehet látni a Log Analytics használatával.

Azure Cosmos DB a következő táblákban tárolja az adatokat.

Táblázat Leírás
AzureDiagnostics Több szolgáltatás által az erőforrásnaplók tárolására használt közös tábla. Az erőforrásnaplók Azure Cosmos DB a következővel azonosíthatók: MICROSOFT.DOCUMENTDB .
AzureActivity Közös tábla, amely a tevékenységnapló összes rekordját tárolja.

Mintákat tartalmazó Kusto-lekérdezések

Fontos

Amikor a Naplók lehetőséget választja a Azure Cosmos DB menüben, a Log Analytics megnyílik, és a lekérdezési hatókör az aktuális Azure Cosmos DB van beállítva. Ez azt jelenti, hogy a naplólekérdezések csak az adott erőforrásból származó adatokat tartalmazzák. Ha olyan lekérdezést szeretne futtatni, amely más fiókokból vagy más Azure-szolgáltatásokból származó adatokat is tartalmaz, válassza a Naplók lehetőséget a Azure Monitor menüben. A részleteket a Log Analytics Azure Monitor log query scope and time range (Naplólekérdezés hatóköre és időtartománya) oldalon talál.

Az azure cosmos-erőforrások figyelése érdekében az íme néhány lekérdezés, amelyek a naplók keresősávjában adhatja meg őket. Ezek a lekérdezések az új nyelvvel működnek.

  • Az összes diagnosztikai napló lekérdezése Azure Cosmos DB megadott időszakra vonatkozóan:

    AzureDiagnostics 
    | where ResourceProvider=="Microsoft.DocumentDb" and Category=="DataPlaneRequests"
    
    
  • Az összes művelet lekérdezése erőforrás szerint csoportosítva:

    AzureActivity 
    | where ResourceProvider=="Microsoft.DocumentDb" and Category=="DataPlaneRequests" 
    | summarize count() by Resource
    
    
  • Az összes felhasználói tevékenység lekérdezése erőforrás szerint csoportosítva:

    AzureActivity 
    | where Caller == "test@company.com" and ResourceProvider=="Microsoft.DocumentDb" and Category=="DataPlaneRequests" 
    | summarize count() by Resource
    

Riasztások

Azure Monitor riasztások proaktívan értesítik, ha fontos feltételek találhatók a monitorozási adatokban. Lehetővé teszik a rendszer problémáinak azonosítását és megoldását, mielőtt az ügyfelek észrevené azokat. Riasztásokat állíthat be a metrikákhoz, a naplókhozés a tevékenységnaplóhoz. A riasztások különböző típusainak vannak előnyei és hátrányai

Az alábbi táblázat például az erőforrásokra vonatkozó néhány riasztási szabályt sorol fel. A riasztási szabályok részletes listáját a következő Azure Portal. További tudnivalókért tekintse meg a riasztások konfiguráló cikkét.

Riasztástípus Feltétel Description
Kérelemegységek sebességkorlátozása (metrikariasztás) Dimenzió neve: StatusCode, Operátor: Egyenlő, Dimenzióértékek: 429 Riasztást küld, ha a tároló vagy egy adatbázis túllépte a kiépített átviteli sebességkorlátot.
Régió átveszi a rel Operátor: Nagyobb, mint, Összesítés típusa: Darabszám, Küszöbérték: 1 Egyetlen régió átveszi a rel. Ez a riasztás akkor hasznos, ha nem engedélyezték az automatikus feladatátvételt.
Kulcsok elforgatása (tevékenységnapló-riasztás) Eseményszint: Tájékoztató, Állapot: elindítva Riasztások a fiókkulcsok váltogatásakor. Az új kulcsokkal frissítheti az alkalmazást.

Monitorozás Azure Cosmos DB programozott módon

A portálon elérhető fiókszintű metrikák, például a fiók tárterület-használata és az összes kérés, nem érhetők el az SQL API-kon keresztül. A használati adatokat azonban gyűjteményszinten is lekérheti az SQL API-k használatával. Gyűjteményszintű adatok lekéréséhez tegye a következőket:

További metrikák eléréséhez használja a Azure Monitor SDK-t. Az elérhető metrikadefiníciók a következő hívással olvashatók be:

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

Az egyes metrikák lekérésének formátuma a következő:

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

További tudnivalókért tekintse meg az Azure monitorozási REST API cikket.

Következő lépések

  • A Azure Cosmos DB által létrehozott naplókra és metrikákra vonatkozó referenciaért tekintse meg a Azure Cosmos DB.
  • Az Azure-erőforrások monitorozásával Azure Monitor Azure-erőforrások monitorozásával kapcsolatos további információkért lásd: Azure-erőforrások monitorozása a monitorozási szolgáltatásokkal.