Azure Cosmos DB monitorováníMonitoring Azure Cosmos DB

Pokud máte důležité aplikace a obchodní procesy spoléhající se na prostředky Azure, budete chtít tyto prostředky sledovat pro jejich dostupnost, výkon a provoz.When you have critical applications and business processes relying on Azure resources, you want to monitor those resources for their availability, performance, and operation. Tento článek popisuje data monitorování generovaná databázemi Azure Cosmos a o tom, jak můžete pomocí funkcí Azure Monitor analyzovat tato data a upozorňovat na ně.This article describes the monitoring data generated by Azure Cosmos databases and how you can use the features of Azure Monitor to analyze and alert on this data.

Data můžete monitorovat pomocí metrik na straně klienta a serveru.You can monitor your data with client-side and server-side metrics. Při použití metrik na straně serveru můžete monitorovat data uložená v Azure Cosmos DB pomocí následujících možností:When using server-side metrics, you can monitor the data stored in Azure Cosmos DB with the following options:

  • Monitorování z portálu Azure Cosmos DB: Můžete monitorovat metriky dostupné v rámci účtu Azure Cosmos na kartě metriky .Monitor from Azure Cosmos DB portal: You can monitor with the metrics available within the Metrics tab of the Azure Cosmos account. Metriky na této kartě zahrnují metriky propustnosti, úložiště, dostupnosti, latence, konzistence a úrovně systému.The metrics on this tab include throughput, storage, availability, latency, consistency, and system level metrics. Ve výchozím nastavení mají tyto metriky dobu uchovávání 7 dní.By default, these metrics have a retention period of 7 days. Další informace najdete v části monitorování dat shromážděných z Azure Cosmos DB v tomto článku.To learn more, see the Monitoring data collected from Azure Cosmos DB section of this article.

  • Monitorování pomocí metrik ve službě Azure monitor: Můžete monitorovat metriky svého účtu Azure Cosmos a vytvářet řídicí panely z Azure Monitor.Monitor with metrics in Azure monitor: You can monitor the metrics of your Azure Cosmos account and create dashboards from the Azure Monitor. Azure Monitor shromažďuje metriky Azure Cosmos DB ve výchozím nastavení, nemusíte nic konfigurovat explicitně.Azure Monitor collects the Azure Cosmos DB metrics by default, you don’t have configure anything explicitly. Tyto metriky se shromažďují s různou úrovní podrobností, členitost se může lišit v závislosti na zvolené metrikě.These metrics are collected with one-minute granularity, the granularity may vary based on the metric you choose. Ve výchozím nastavení mají tyto metriky dobu uchovávání 30 dnů.By default, these metrics have a retention period of 30 days. Většina metrik, které jsou k dispozici z předchozích možností, je také k dispozici v těchto metrikách.Most of the metrics that are available from the previous options are also available in these metrics. Další informace najdete v části Analýza dat metrik v tomto článku.To learn more, see the Analyze metric data section of this article.

  • Monitorování pomocí diagnostických protokolů v Azure monitor: Můžete monitorovat protokoly svého účtu Azure Cosmos a vytvářet řídicí panely z Azure Monitor.Monitor with diagnostic logs in Azure Monitor: You can monitor the logs of your Azure Cosmos account and create dashboards from the Azure Monitor. Telemetrie, jako jsou události a trasování, ke kterým dochází při druhé členitosti, se ukládají jako protokoly.Telemetry such as events and traces that occur at a second granularity are stored as logs. Například pokud se propustnost kontejneru změní, vlastnosti účtu Cosmos se změní tyto události jsou zachyceny v rámci protokolů.For example, if the throughput of a container is changes, the properties of a Cosmos account are changed these events are captures within the logs. Tyto protokoly můžete analyzovat spuštěním dotazů na shromážděná data.You can analyze these logs by running queries on the gathered data. Další informace najdete v části Analýza dat protokolu v tomto článku.To learn more, see the Analyze log data section of this article.

  • Monitorování prostřednictvím kódu programu pomocí sad SDK: Účet Azure Cosmos můžete sledovat programově pomocí rozhraní .NET, Java, Pythonu Node.js SDK a hlaviček v REST API.Monitor programmatically with SDKs: You can monitor your Azure Cosmos account programmatically by using the .NET, Java, Python, Node.js SDKs, and the headers in REST API. Další informace najdete v části monitorování Azure Cosmos DB programově v tomto článku.To learn more, see the Monitoring Azure Cosmos DB programmatically section of this article.

Následující obrázek ukazuje různé možnosti, které jsou k dispozici pro monitorování Azure Cosmos DB účtu prostřednictvím Azure Portal:The following image shows different options available to monitor Azure Cosmos DB account through Azure portal:

Možnosti monitorování dostupné v Azure Portal

Při použití Azure Cosmos DB můžete na straně klienta shromažďovat podrobnosti o požadavcích na požadavky, ID aktivity, informace o výjimce/zásobníku, stav HTTP/dílčí stavový kód, diagnostický řetězec pro ladění všech problémů, ke kterým může dojít.When using Azure Cosmos DB, at the client-side you can collect the details for request charge, activity ID, exception/stack trace information, HTTP status/sub-status code, diagnostic string to debug any issue that might occur. Tyto informace se vyžadují i v případě, že se potřebujete obrátit na tým podpory Azure Cosmos DB.This information is also required if you need to reach out to the Azure Cosmos DB support team.

Co je Azure Monitor?What is Azure Monitor?

Azure Cosmos DB vytváří data monitorování pomocí Azure monitor , což je plná služba monitorování zásobníku v Azure, která poskytuje kompletní sadu funkcí pro monitorování prostředků Azure kromě prostředků v jiných cloudech a místních prostředích.Azure Cosmos DB creates monitoring data using Azure Monitor which is a full stack monitoring service in Azure that provides a complete set of features to monitor your Azure resources in addition to resources in other clouds and on-premises.

Pokud ještě nejste obeznámeni s monitorováním služeb Azure, začněte s článkem monitorování prostředků Azure pomocí Azure monitor , který popisuje následující informace:If you're not already familiar with monitoring Azure services, start with the article Monitoring Azure resources with Azure Monitor which describes the following:

  • Co je Azure Monitor?What is Azure Monitor?
  • Náklady spojené s monitorovánímCosts associated with monitoring
  • Monitorování dat shromážděných v AzureMonitoring data collected in Azure
  • Konfigurace shromažďování datConfiguring data collection
  • Standardní nástroje v Azure pro analýzu a upozorňování na data monitorováníStandard tools in Azure for analyzing and alerting on monitoring data

Následující části jsou uvedené v tomto článku, které popisují konkrétní data získaná z Azure Cosmos DB a poskytují příklady pro konfiguraci shromažďování dat a analýzu těchto dat pomocí nástrojů Azure.The following sections build on this article by describing the specific data gathered from Azure Cosmos DB and providing examples for configuring data collection and analyzing this data with Azure tools.

Azure Monitor pro Azure Cosmos DBAzure Monitor for Azure Cosmos DB

Azure Monitor pro Azure Cosmos DB je založen na funkci sešitů Azure monitor a používá stejná data monitorování shromážděná pro Cosmos DB popsané v následujících částech.Azure Monitor for Azure Cosmos DB is based on the workbooks feature of Azure Monitor and uses the same monitoring data collected for Cosmos DB described in the sections below. Pomocí Azure Monitor můžete zobrazit celkový výkon, selhání, kapacitu a provozní stav všech vašich prostředků Azure Cosmos DB ve sjednoceném interaktivním prostředí a využít další funkce Azure Monitor pro účely podrobné analýzy a upozorňování.Use Azure Monitor for a view of the overall performance, failures, capacity, and operational health of all your Azure Cosmos DB resources in a unified interactive experience, and leverage the other features of Azure Monitor for detailed analysis and alerting. Další informace najdete v článku prozkoumání Azure Monitor Azure Cosmos DB .To learn more, see the Explore Azure Monitor for Azure Cosmos DB article.

Poznámka

Při vytváření kontejnerů se ujistěte, že nevytvoříte dva kontejnery se stejným názvem, ale s různou velikostí písmen.When creating containers, make sure you don’t create two containers with the same name but different casing. Důvodem je to, že některé části platformy Azure nerozlišují velká a malá písmena a to může vést k nejasnostem/kolizi telemetrie a akcí na kontejnerech s takovými názvy.That’s because some parts of the Azure platform are not case-sensitive, and this can result in confusion/collision of telemetry and actions on containers with such names.

Monitorování dat shromážděných z portálu Azure Cosmos DBMonitor data collected from Azure Cosmos DB portal

Azure Cosmos DB shromažďuje stejné typy dat monitorování jako jiné prostředky Azure, které jsou popsány v tématu monitorování dat z prostředků Azure.Azure Cosmos DB collects the same kinds of monitoring data as other Azure resources which are described in Monitoring data from Azure resources. Podrobné informace o protokolech a metrikách vytvořených pomocí Azure Cosmos DB najdete v tématu referenční informace k datům monitorování Azure Cosmos DB .See Azure Cosmos DB monitoring data reference for a detailed reference of the logs and metrics created by Azure Cosmos DB.

Stránka Přehled v Azure Portal pro každou databázi Azure Cosmos obsahuje stručný přehled využití databáze, včetně jejich žádosti a hodinového využití fakturace.The Overview page in the Azure portal for each Azure Cosmos database includes a brief view of the database usage including its request and hourly billing usage. Tyto informace jsou užitečné, ale k dispozici je jen malé množství dat monitorování.This is useful information but only a small amount of the monitoring data available. Některá z těchto dat jsou shromažďována automaticky a k dispozici pro analýzu, jakmile vytvoříte databázi, zatímco můžete povolit další shromažďování dat s určitou konfigurací.Some of this data is collected automatically and available for analysis as soon as you create the database while you can enable additional data collection with some configuration.

Stránka Přehled

Analýza dat metrikyAnalyzing metric data

Azure Cosmos DB poskytuje vlastní prostředí pro práci s metrikami.Azure Cosmos DB provides a custom experience for working with metrics. Podrobnosti o používání tohoto prostředí a analýze různých Azure Cosmos DBch scénářů najdete v tématu monitorování a ladění Azure Cosmos DB metriky z Azure monitor .See Monitor and debug Azure Cosmos DB metrics from Azure Monitor for details on using this experience and for analyzing different Azure Cosmos DB scenarios.

Metriky pro Azure Cosmos DB můžete analyzovat pomocí metrik z jiných služeb Azure pomocí Průzkumníka metrik, a to tak, že v nabídce Azure monitor otevřete metriky .You can analyze metrics for Azure Cosmos DB with metrics from other Azure services using Metrics explorer by opening Metrics from the Azure Monitor menu. Podrobnosti o použití tohoto nástroje najdete v tématu Začínáme s Azure Průzkumník metrik .See Getting started with Azure Metrics Explorer for details on using this tool. Všechny metriky pro Azure Cosmos DB jsou v oboru názvů Cosmos DB Standardní metriky.All metrics for Azure Cosmos DB are in the namespace Cosmos DB standard metrics. Při přidávání filtru do grafu můžete použít následující dimenze s těmito metrikami:You can use the following dimensions with these metrics when adding a filter to a chart:

  • Název kolekceCollectionName
  • DatabaseNameDatabaseName
  • Typem operace OperationTypeOperationType
  • OblastRegion
  • StatusCodeStatusCode

Zobrazit metriky na úrovni operace pro Azure Cosmos DBView operation level metrics for Azure Cosmos DB

  1. Přihlaste se k portálu Azure Portal.Sign in to the Azure portal.

  2. V levém navigačním panelu vyberte monitor a vyberte metriky.Select Monitor from the left-hand navigation bar, and select Metrics.

    Podokno metrik v Azure Monitor

  3. V podokně metriky > Vyberte prostředek > zvolte požadované předplatnéa skupinu prostředků.From the Metrics pane > Select a resource > choose the required subscription, and resource group. Jako typ prostředkuvyberte Azure Cosmos DB účty, zvolte jeden ze stávajících účtů Azure Cosmos a pak vyberte použít.For the Resource type, select Azure Cosmos DB accounts, choose one of your existing Azure Cosmos accounts, and select Apply.

    Vyberte účet Cosmos DB, pro který chcete zobrazit metriky.

  4. Dále můžete vybrat metriku ze seznamu dostupných metrik.Next you can select a metric from the list of available metrics. Můžete vybrat metriky specifické pro jednotky žádosti, úložiště, latenci, dostupnost, Cassandra a další.You can select metrics specific to request units, storage, latency, availability, Cassandra, and others. Podrobné informace o všech dostupných metrikách v tomto seznamu najdete v článku metriky podle kategorií .To learn in detail about all the available metrics in this list, see the Metrics by category article. V tomto příkladu vybereme jednotky žádosti a jako hodnotu agregace určíte průměr .In this example, let's select Request units and Avg as the aggregation value.

    Kromě těchto podrobností můžete také vybrat časový rozsah a časovou členitost metrik.In addition to these details, you can also select the Time range and Time granularity of the metrics. V poli Max (maximum) si můžete zobrazit metriky za posledních 30 dní.At max, you can view metrics for the past 30 days. Po použití filtru se v závislosti na vašem filtru zobrazí graf.After you apply the filter, a chart is displayed based on your filter. Pro vybrané období můžete zobrazit průměrný počet spotřebovaných jednotek žádostí za minutu.You can see the average number of request units consumed per minute for the selected period.

    Vyberte metriku z Azure Portal

Přidání filtrů do metrikAdd filters to metrics

Můžete také filtrovat metriky a graf zobrazený podle konkrétního typu CollectionName, DatabaseName, typem operace OperationType, regiona StatusCode.You can also filter metrics and the chart displayed by a specific CollectionName, DatabaseName, OperationType, Region, and StatusCode. Chcete-li filtrovat metriky, vyberte možnost Přidat filtr a zvolte požadovanou vlastnost, například typem operace OperationType , a vyberte hodnotu, jako je například dotaz.To filter the metrics, select Add filter and choose the required property such as OperationType and select a value such as Query. V grafu se pak zobrazí jednotky žádosti spotřebované pro operaci dotazování pro vybrané období.The graph then displays the request units consumed for the query operation for the selected period. Operace provedené prostřednictvím uložené procedury nejsou protokolovány, takže nejsou k dispozici v rámci metriky typem operace OperationType.The operations executed via Stored procedure are not logged so they are not available under the OperationType metric.

Přidejte filtr pro výběr členitosti metriky.

Metriky můžete seskupit pomocí možnosti použít rozdělení .You can group metrics by using the Apply splitting option. Například můžete seskupit jednotky žádostí na typ operace a zobrazit graf pro všechny operace najednou, jak je znázorněno na následujícím obrázku:For example, you can group the request units per operation type and view the graph for all the operations at once as shown in the following image:

Přidat použít dělicí filtr

Analýza dat protokoluAnalyzing log data

Data v Azure Monitor protokoly se ukládají v tabulkách, ve kterých každá tabulka má vlastní sadu jedinečných vlastností.Data in Azure Monitor Logs is stored in tables which each table having its own set of unique properties. Azure Cosmos DB ukládá data v následujících tabulkách.Azure Cosmos DB stores data in the following tables.

TabulkaTable PopisDescription
AzureDiagnosticsAzureDiagnostics Společná tabulka používaná více službami k ukládání protokolů prostředků.Common table used by multiple services to store Resource logs. Protokoly prostředků z Azure Cosmos DB lze identifikovat pomocí MICROSOFT.DOCUMENTDB .Resource logs from Azure Cosmos DB can be identified with MICROSOFT.DOCUMENTDB.
AzureActivityAzureActivity Společná tabulka, která ukládá všechny záznamy z protokolu aktivit.Common table that stores all records from the Activity log.

Důležité

Když v nabídce Azure Cosmos DB vyberete protokoly , Log Analytics se otevře s oborem dotazu nastaveným na aktuální databázi Azure Cosmos.When you select Logs from the Azure Cosmos DB menu, Log Analytics is opened with the query scope set to the current Azure Cosmos database. To znamená, že dotazy protokolu budou zahrnovat pouze data z tohoto prostředku.This means that log queries will only include data from that resource. Pokud chcete spustit dotaz, který zahrnuje data z jiných databází nebo dat z jiných služeb Azure, vyberte z nabídky Azure monitor protokoly .If you want to run a query that includes data from other databases or data from other Azure services, select Logs from the Azure Monitor menu. Podrobnosti najdete v tématu Rozsah dotazů protokolu a časový rozsah v Azure Monitor Log Analytics .See Log query scope and time range in Azure Monitor Log Analytics for details.

Azure Cosmos DB Log Analytics dotazy v Azure MonitorAzure Cosmos DB Log Analytics queries in Azure Monitor

Tady jsou některé dotazy, které můžete zadat do panelu hledání v protokolu , abyste mohli monitorovat kontejnery Cosmos Azure.Here are some queries that you can enter into the Log search search bar to help you monitor your Azure Cosmos containers. Tyto dotazy fungují s novým jazykem.These queries work with the new language.

Níže jsou uvedené dotazy, které vám pomůžou monitorovat databáze Azure Cosmos.Following are queries that you can use to help you monitor your Azure Cosmos databases.

  • Dotaz na všechny diagnostické protokoly z Azure Cosmos DB v zadaném časovém období:To query for all of the diagnostic logs from Azure Cosmos DB for a specified time period:

    AzureDiagnostics 
    | where ResourceProvider=="Microsoft.DocumentDb" and Category=="DataPlaneRequests"
    
    
  • Dotaz na všechny operace seskupené podle prostředků:To query for all operations, grouped by resource:

    AzureActivity 
    | where ResourceProvider=="Microsoft.DocumentDb" and Category=="DataPlaneRequests" 
    | summarize count() by Resource
    
    
  • Dotaz na všechny aktivity uživatelů seskupené podle prostředků:To query for all user activity, grouped by resource:

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

Monitorování Azure Cosmos DB programověMonitor Azure Cosmos DB programmatically

Metriky na úrovni účtu dostupné na portálu, jako je například využití úložiště účtů a celkový počet požadavků, nejsou k dispozici prostřednictvím rozhraní SQL API.The account level metrics available in the portal, such as account storage usage and total requests, are not available via the SQL APIs. Data o využití na úrovni kolekce ale můžete načíst pomocí rozhraní SQL API.However, you can retrieve usage data at the collection level by using the SQL APIs. Chcete-li načíst data na úrovni kolekce, postupujte následovně:To retrieve collection level data, do the following:

Pro přístup k dalším metrikám použijte sadu Azure monitor SDK.To access additional metrics, use the Azure Monitor SDK. Dostupné definice metriky lze načíst voláním:Available metric definitions can be retrieved by calling:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/metricDefinitions?api-version=2015-04-08

Dotazy k načtení jednotlivých metrik používají následující formát:Queries to retrieve individual metrics use the following format:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/metrics?api-version=2015-04-08&$filter=%28name.value%20eq%20%27Total%20Requests%27%29%20and%20timeGrain%20eq%20duration%27PT5M%27%20and%20startTime%20eq%202016-06-03T03%3A26%3A00.0000000Z%20and%20endTime%20eq%202016-06-10T03%3A26%3A00.0000000Z

Další krokyNext steps