Monitorowanie usługi Azure Cosmos DB

W tym artykule opisano:

  • Typy danych monitorowania, które można zbierać dla tej usługi.
  • Sposoby analizowania tych danych.

Uwaga

Jeśli znasz już tę usługę i/lub usługę Azure Monitor i chcesz wiedzieć, jak analizować dane monitorowania, zobacz sekcję Analizowanie pod koniec tego artykułu.

Jeśli masz krytyczne aplikacje i procesy biznesowe korzystające z zasobów platformy Azure, musisz monitorować i otrzymywać alerty dla systemu. Usługa Azure Monitor zbiera i agreguje metryki i dzienniki z każdego składnika systemu. Usługa Azure Monitor zapewnia wgląd w dostępność, wydajność i odporność oraz powiadamia o problemach. Do konfigurowania i wyświetlania danych monitorowania można użyć witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia platformy Azure, interfejsu API REST lub bibliotek klienckich.

Wyniki analiz

Niektóre usługi na platformie Azure mają wbudowany pulpit nawigacyjny monitorowania w witrynie Azure Portal, który zapewnia punkt wyjścia do monitorowania usługi. Te pulpity nawigacyjne są nazywane szczegółowymi informacjami i można je znaleźć w Szczegółowe informacje Hub of Azure Monitor w witrynie Azure Portal.

Szczegółowe informacje o usłudze Azure Cosmos DB

Szczegółowe informacje usługi Azure Cosmos DB to funkcja oparta na funkcji skoroszytów usługi Azure Monitor. Użyj szczegółowych informacji usługi Azure Cosmos DB, aby wyświetlić ogólną wydajność, awarie, pojemność i kondycję operacyjną wszystkich zasobów usługi Azure Cosmos DB w ujednoliconym interaktywnym środowisku.

Aby uzyskać więcej informacji na temat szczegółowych informacji o usłudze Azure Cosmos DB, zobacz następujące artykuły:

Typy zasobów

Platforma Azure używa koncepcji typów zasobów i identyfikatorów, aby zidentyfikować wszystko w subskrypcji. Usługa Azure Monitor podobnie organizuje podstawowe dane monitorowania w metryki i dzienniki na podstawie typów zasobów, nazywanych również przestrzeniami nazw. Różne metryki i dzienniki są dostępne dla różnych typów zasobów. Usługa może być skojarzona z więcej niż jednym typem zasobu.

Typy zasobów są również częścią identyfikatorów zasobów dla każdego zasobu uruchomionego na platformie Azure. Na przykład jeden typ zasobu dla maszyny wirtualnej to Microsoft.Compute/virtualMachines. Aby uzyskać listę usług i skojarzonych z nimi typów zasobów, zobacz Dostawcy zasobów.

Aby uzyskać więcej informacji na temat typów zasobów dla usługi Azure Cosmos DB, zobacz Dokumentacja danych monitorowania usługi Azure Cosmos DB.

Magazyn danych

W przypadku usługi Azure Monitor:

  • Dane metryk są przechowywane w bazie danych metryk usługi Azure Monitor.
  • Dane dziennika są przechowywane w magazynie dzienników usługi Azure Monitor. Log Analytics to narzędzie w witrynie Azure Portal, które może wykonywać zapytania dotyczące tego magazynu.
  • Dziennik aktywności platformy Azure to oddzielny magazyn z własnym interfejsem w witrynie Azure Portal.

Opcjonalnie możesz kierować dane metryki i dziennika aktywności do magazynu dzienników usługi Azure Monitor. Następnie możesz użyć usługi Log Analytics, aby wykonać zapytanie o dane i skorelować je z innymi danymi dziennika.

Wiele usług może używać ustawień diagnostycznych do wysyłania danych metryk i dzienników do innych lokalizacji przechowywania poza usługą Azure Monitor. Przykłady obejmują usługę Azure Storage, hostowane systemy partnerskie i systemy partnerskie spoza platformy Azure przy użyciu usługi Event Hubs.

Aby uzyskać szczegółowe informacje na temat sposobu przechowywania danych przez usługę Azure Monitor, zobacz Azure Monitor data platformy.

Metryki platformy usługi Azure Monitor

Usługa Azure Monitor udostępnia metryki platformy dla większości usług. Te metryki to:

  • Definiowane indywidualnie dla każdej przestrzeni nazw.
  • Przechowywane w bazie danych metryk szeregów czasowych usługi Azure Monitor.
  • Lekki i zdolny do obsługi alertów niemal w czasie rzeczywistym.
  • Służy do śledzenia wydajności zasobu w czasie.

Kolekcja: usługa Azure Monitor automatycznie zbiera metryki platformy. Nie jest wymagana żadna konfiguracja.

Routing: zazwyczaj można również kierować metryki platformy do dzienników usługi Azure Monitor/ usługi Log Analytics, aby móc wykonywać zapytania względem nich przy użyciu innych danych dziennika. Aby uzyskać więcej informacji, zobacz ustawienie diagnostyczne Metryki. Aby uzyskać informacje na temat konfigurowania ustawień diagnostycznych dla usługi, zobacz Tworzenie ustawień diagnostycznych w usłudze Azure Monitor.

Aby uzyskać listę wszystkich metryk, które można zebrać dla wszystkich zasobów w usłudze Azure Monitor, zobacz Obsługiwane metryki w usłudze Azure Monitor.

Usługa Azure Monitor domyślnie zbiera metryki usługi Azure Cosmos DB. Nie trzeba jawnie konfigurować żadnych elementów. Większość metryk jest dostępna na stronie portalu usługi Azure Cosmos DB lub na stronie usługi Azure Monitor. Domyślnie metryki są zbierane z jednominutowym szczegółowością. Stopień szczegółowości może się różnić w zależności od wybranej metryki. Domyślnie te metryki mają okres przechowywania 30 dni.

Metryki po stronie serwera usługi Azure Cosmos DB obejmują metryki przepływności, magazynu, dostępności, opóźnienia, spójności i poziomu systemu. Po stronie klienta można zbierać szczegółowe informacje dotyczące opłaty za żądanie, identyfikatora działania, wyjątku i śledzenia stosu, stanu HTTP i kodu podstatu oraz ciągu diagnostycznego. Domyślnie te metryki mają okres przechowywania siedmiu dni. Te dane umożliwiają debugowanie problemów lub kontaktowanie się z zespołem pomocy technicznej usługi Azure Cosmos DB.

Wartości wymiarów metryk, takie jak nazwa kontenera, są bez uwzględniania wielkości liter. Taka sytuacja może spowodować zamieszanie lub kolizję danych telemetrycznych i akcji dotyczących kontenerów o takich nazwach. Użyj porównania bez uwzględniania wielkości podczas porównywania ciągów dla tych wartości wymiarów.

Aby uzyskać listę dostępnych metryk dla usługi Azure Cosmos DB, zobacz Dokumentacja danych monitorowania usługi Azure Cosmos DB.

Metryki oparte na usłudze Azure Monitor

Ta usługa udostępnia inne metryki, które nie są uwzględnione w bazie danych metryk usługi Azure Monitor.

Dzienniki zasobów usługi Azure Monitor

Dzienniki zasobów zapewniają wgląd w operacje wykonywane przez zasób platformy Azure. Dzienniki są generowane automatycznie, ale należy skierować je do dzienników usługi Azure Monitor, aby je zapisać lub wysłać do nich zapytanie. Dzienniki są zorganizowane w kategoriach. Dana przestrzeń nazw może mieć wiele kategorii dziennika zasobów.

Kolekcja: dzienniki zasobów nie są zbierane i przechowywane do momentu utworzenia ustawienia diagnostycznego i kierowania dzienników do co najmniej jednej lokalizacji. Podczas tworzenia ustawienia diagnostycznego należy określić kategorie dzienników, które mają być zbierane. Istnieje wiele sposobów tworzenia i konserwacji ustawień diagnostycznych, w tym witryny Azure Portal, programowo i choć usługi Azure Policy.

Routing: sugerowaną wartością domyślną jest kierowanie dzienników zasobów do dzienników usługi Azure Monitor, co umożliwia wykonywanie zapytań względem nich przy użyciu innych danych dziennika. Dostępne są również inne lokalizacje, takie jak Azure Storage, Azure Event Hubs i niektórzy partnerzy monitorowania firmy Microsoft. Aby uzyskać więcej informacji, zobacz Dzienniki zasobów platformy Azure i lokalizacje docelowe dziennika zasobów.

Aby uzyskać szczegółowe informacje na temat zbierania, przechowywania i routingu dzienników zasobów, zobacz Ustawienia diagnostyczne w usłudze Azure Monitor.

Aby uzyskać listę wszystkich dostępnych kategorii dzienników zasobów w usłudze Azure Monitor, zobacz Obsługiwane dzienniki zasobów w usłudze Azure Monitor.

Wszystkie dzienniki zasobów w usłudze Azure Monitor mają te same pola nagłówka, a następnie pola specyficzne dla usługi. Typowy schemat jest opisany w schemacie dziennika zasobów usługi Azure Monitor.

Dzienniki diagnostyczne można monitorować z poziomu konta usługi Azure Cosmos DB i tworzyć pulpity nawigacyjne z usługi Azure Monitor. Dane, takie jak zdarzenia i ślady występujące na drugim poziomie szczegółowości, są przechowywane jako dzienniki. Na przykład jeśli przepływność kontenera ulegnie zmianie, właściwości konta usługi Azure Cosmos DB zmienią się. Dzienniki przechwytują te zdarzenia. Te dzienniki można analizować, uruchamiając zapytania dotyczące zebranych danych.

Aby uzyskać dostępne kategorie dzienników zasobów, skojarzone z nimi tabele usługi Log Analytics i schematy dzienników dla usługi Azure Cosmos DB, zobacz Dokumentacja danych monitorowania usługi Azure Cosmos DB.

Dziennik aktywności platformy Azure

Dziennik aktywności zawiera zdarzenia na poziomie subskrypcji, które śledzą operacje dla każdego zasobu platformy Azure widoczne spoza tego zasobu; na przykład utworzenie nowego zasobu lub uruchomienie maszyny wirtualnej.

Kolekcja: zdarzenia dziennika aktywności są generowane automatycznie i zbierane w osobnym magazynie do wyświetlania w witrynie Azure Portal.

Routing: możesz wysyłać dane dziennika aktywności do dzienników usługi Azure Monitor, aby móc analizować je wraz z innymi danymi dziennika. Dostępne są również inne lokalizacje, takie jak Azure Storage, Azure Event Hubs i niektórzy partnerzy monitorowania firmy Microsoft. Aby uzyskać więcej informacji na temat kierowania dziennika aktywności, zobacz Omówienie dziennika aktywności platformy Azure.

Analizowanie danych monitorowania

Istnieje wiele narzędzi do analizowania danych monitorowania.

Narzędzia usługi Azure Monitor

Usługa Azure Monitor obsługuje następujące podstawowe narzędzia:

  • Eksplorator metryk — narzędzie w witrynie Azure Portal, które umożliwia wyświetlanie i analizowanie metryk dla zasobów platformy Azure. Aby uzyskać więcej informacji, zobacz Analizowanie metryk za pomocą Eksploratora metryk usługi Azure Monitor.

  • Log Analytics — narzędzie w witrynie Azure Portal, które umożliwia wykonywanie zapytań i analizowanie danych dzienników przy użyciu języka zapytań Kusto (KQL). Aby uzyskać więcej informacji, zobacz Rozpoczynanie pracy z zapytaniami dzienników w usłudze Azure Monitor.

  • Dziennik aktywności, który zawiera interfejs użytkownika w witrynie Azure Portal do wyświetlania i podstawowych wyszukiwań. Aby przeprowadzić bardziej szczegółową analizę, musisz kierować dane do dzienników usługi Azure Monitor i uruchamiać bardziej złożone zapytania w usłudze Log Analytics.

Narzędzia, które umożliwiają bardziej złożoną wizualizację, obejmują:

  • Pulpity nawigacyjne, które umożliwiają łączenie różnych rodzajów danych w jednym okienku w witrynie Azure Portal.
  • Skoroszyty, dostosowywalne raporty, które można utworzyć w witrynie Azure Portal. Skoroszyty mogą zawierać tekst, metryki i zapytania dziennika.
  • Grafana to otwarte narzędzie platformy, które wyróżnia się na operacyjnych pulpitach nawigacyjnych. Za pomocą narzędzia Grafana można tworzyć pulpity nawigacyjne zawierające dane z wielu źródeł innych niż usługa Azure Monitor.
  • Power BI, usługa analizy biznesowej, która udostępnia interaktywne wizualizacje w różnych źródłach danych. Usługę Power BI można skonfigurować tak, aby automatycznie importować dane dziennika z usługi Azure Monitor, aby korzystać z tych wizualizacji.

Narzędzia eksportu usługi Azure Monitor

Dane z usługi Azure Monitor można pobrać do innych narzędzi przy użyciu następujących metod:

  • Metryki: użyj interfejsu API REST dla metryk , aby wyodrębnić dane metryk z bazy danych metryk usługi Azure Monitor. Interfejs API obsługuje wyrażenia filtrów w celu uściślinia pobranych danych. Aby uzyskać więcej informacji, zobacz Dokumentacja interfejsu API REST usługi Azure Monitor.

  • Dzienniki: użyj interfejsu API REST lub skojarzonych bibliotek klienckich.

  • Inną opcją jest eksportowanie danych obszaru roboczego.

Aby rozpocząć pracę z interfejsem API REST dla usługi Azure Monitor, zobacz Przewodnik po interfejsie API REST monitorowania platformy Azure.

Analizowanie metryk usługi Azure Cosmos DB

Eksplorator metryk usługi Azure Monitor umożliwia analizowanie metryk dla usługi Azure Cosmos DB za pomocą metryk z innych usług platformy Azure, wybierając pozycję Metryki w obszarze Monitorowanie w nawigacji portalu konta usługi Azure Cosmos DB. Aby uzyskać więcej informacji na temat korzystania z eksploratora metryk, zobacz Analizowanie metryk za pomocą Eksploratora metryk usługi Azure Monitor.

Możesz monitorować opóźnienie po stronie serwera, użycie jednostek żądania i znormalizowane użycie jednostek żądania dla zasobów usługi Azure Cosmos DB. Możesz wybrać metryki specyficzne dla jednostek żądania, magazynu, opóźnienia, dostępności, bazy danych Cassandra i innych.

Po stronie klienta można debugować problemy, zbierając metryki dotyczące opłaty za żądanie, identyfikatora działania, wyjątku i śledzenia stosu, stanu HTTP i kodu podstatu oraz ciągu diagnostycznego.

Aby uzyskać więcej informacji i szczegółowe instrukcje, zobacz następujące artykuły:

Aby uzyskać listę wszystkich metryk zasobów obsługiwanych w usłudze Azure Monitor, zobacz Obsługiwane metryki usługi Azure Monitor. Aby uzyskać listę metryk platformy zebranych dla usługi Azure Cosmos DB, zobacz Monitorowanie metryk referencyjnych danych usługi Azure Cosmos DB.

Programowe monitorowanie usługi Azure Cosmos DB

Metryki na poziomie konta dostępne w portalu, takie jak użycie magazynu konta i łączne żądania, nie są dostępne przy użyciu interfejsu API dla noSQL. Można jednak pobrać dane użycia na poziomie kolekcji przy użyciu interfejsu API dla noSQL. Aby pobrać dane na poziomie kolekcji, użyj jednej z następujących metod:

Aby uzyskać dostęp do większej liczby metryk, użyj zestawu SDK usługi Azure Monitor. Dostępne definicje metryk można pobrać przy użyciu następującego formatu:

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

Aby pobrać poszczególne metryki, użyj następującego formatu:

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

Aby dowiedzieć się więcej, zobacz Interfejs API REST monitorowania platformy Azure.

Analizowanie dzienników usługi Azure Cosmos DB

Dane w dziennikach usługi Azure Monitor są przechowywane w tabelach. Każda tabela ma własny zestaw unikatowych właściwości. Wszystkie dzienniki zasobów w usłudze Azure Monitor mają te same pola, a następnie pola specyficzne dla usługi. Typowy schemat jest opisany w schemacie dziennika zasobów usługi Azure Monitor.

Aby uzyskać informacje o typach dzienników zasobów zebranych dla usługi Azure Cosmos DB, zobacz Dokumentacja danych monitorowania usługi Azure Cosmos DB.

Aby uzyskać więcej informacji na temat pracy z dziennikami usługi Azure Monitor dla usługi Azure Cosmos DB, zobacz następujące artykuły:

Zapytania usługi Kusto

Dane monitorowania można analizować w magazynie dzienników usługi Azure Monitor /Log Analytics przy użyciu języka zapytań Kusto (KQL).

Ważne

Po wybraniu pozycji Dzienniki z menu usługi w portalu usługa Log Analytics zostanie otwarta z zakresem zapytania ustawionym na bieżącą usługę. Ten zakres oznacza, że zapytania dziennika będą zawierać tylko dane z tego typu zasobu. Jeśli chcesz uruchomić zapytanie zawierające dane z innych usług platformy Azure, wybierz pozycję Dzienniki z menu usługi Azure Monitor . Aby uzyskać szczegółowe informacje, zobacz Zakres zapytań dzienników i zakres czasu w usłudze Azure Monitor Log Analytics .

Aby uzyskać listę typowych zapytań dotyczących dowolnej usługi, zobacz interfejs zapytań usługi Log Analytics.

Przed użyciem usługi Log Analytics do wysyłania zapytań Kusto należy włączyć dzienniki diagnostyczne dla operacji płaszczyzny sterowania. Po włączeniu dzienników diagnostycznych wybierasz między przechowywaniem danych w tabelach specyficznych dla zasobów lub pojedynczą tabelą AzureDiagnostics (starsza wersja). Dokładny tekst zapytań Kusto zależy od wybranego trybu kolekcji.

Poniżej przedstawiono kilka zapytań, które można wprowadzić na pasku wyszukiwania dzienników, aby ułatwić monitorowanie zasobów usługi Azure Cosmos DB.

Aby wykonywać zapytania dotyczące wszystkich dzienników płaszczyzny sterowania z usługi Azure Cosmos DB:

CDBControlPlaneRequests

Aby wykonywać zapytania dotyczące wszystkich dzienników płaszczyzny danych z usługi Azure Cosmos DB:

CDBDataPlaneRequests

Aby wysłać zapytanie dotyczące filtrowanej listy dzienników płaszczyzny danych, specyficzne dla pojedynczego zasobu:

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

Aby uzyskać liczbę dzienników płaszczyzny danych, pogrupowane według zasobu:

CDBDataPlaneRequests
| summarize count() by AccountName

Aby wygenerować wykres dzienników płaszczyzny danych, pogrupowane według typu operacji:

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

W przypadku zapytań Kusto można użyć do rozwiązywania problemów z usługą Azure Cosmos DB, zobacz następujące artykuły:

Te przykłady to tylko małe próbkowanie zaawansowanych zapytań, które można uruchomić w usłudze Azure Monitor przy użyciu język zapytań Kusto (KQL). Aby uzyskać więcej przykładów, zobacz przykłady zapytań Kusto.

Alerty

Alerty usługi Azure Monitor proaktywnie powiadamiają o znalezieniu określonych warunków w danych monitorowania. Alerty umożliwiają identyfikowanie i rozwiązywanie problemów w systemie przed ich zauważeniem przez klientów. Aby uzyskać więcej informacji, zobacz Alerty usługi Azure Monitor.

Istnieje wiele źródeł typowych alertów dotyczących zasobów platformy Azure. Przykłady typowych alertów dotyczących zasobów platformy Azure można znaleźć w temacie Przykładowe zapytania alertów dziennika. Witryna Alerty bazowe usługi Azure Monitor (AMBA) udostępnia częściowo zautomatyzowaną metodę implementowania ważnych alertów metryk platformy, pulpitów nawigacyjnych i wytycznych. Witryna ma zastosowanie do stale powiększającego się podzestawu usług platformy Azure, w tym wszystkich usług, które są częścią strefy docelowej platformy Azure (ALZ).

Typowy schemat alertu standandaryzuje użycie powiadomień o alertach usługi Azure Monitor. Aby uzyskać więcej informacji, zobacz Wspólny schemat alertów.

Typy alertów

Możesz otrzymywać alerty dotyczące dowolnej metryki lub źródła danych dziennika na platformie danych usługi Azure Monitor. Istnieje wiele różnych typów alertów w zależności od usług, które monitorujesz i zbieranych danych monitorowania. Różne typy alertów mają różne zalety i wady. Aby uzyskać więcej informacji, zobacz Wybieranie odpowiedniego typu alertu monitorowania.

Poniższa lista zawiera opis typów alertów usługi Azure Monitor, które można utworzyć:

  • Alerty metryk oceniają metryki zasobów w regularnych odstępach czasu. Metryki mogą być metrykami platformy, metrykami niestandardowymi, dziennikami z usługi Azure Monitor przekonwertowanym na metryki lub metrykami usługi Application Szczegółowe informacje. Alerty metryk mogą również stosować wiele warunków i progów dynamicznych.
  • Alerty dzienników umożliwiają użytkownikom używanie zapytania usługi Log Analytics do oceny dzienników zasobów z wstępnie zdefiniowaną częstotliwością.
  • Alerty dziennika aktywności są wyzwalane, gdy wystąpi nowe zdarzenie dziennika aktywności zgodne ze zdefiniowanymi warunkami. Alerty usługi Resource Health i alerty usługi Service Health to alerty dziennika aktywności, które zgłaszają kondycję usługi i zasobów.

Niektóre usługi platformy Azure obsługują również alerty wykrywania inteligentnego, alerty Prometheus lub zalecane reguły alertów.

W przypadku niektórych usług można monitorować na dużą skalę, stosując tę samą regułę alertu metryki do wielu zasobów tego samego typu, które istnieją w tym samym regionie świadczenia usługi Azure. Poszczególne powiadomienia są wysyłane dla każdego monitorowanego zasobu. Aby uzyskać informacje o obsługiwanych usługach i chmurach platformy Azure, zobacz Monitorowanie wielu zasobów przy użyciu jednej reguły alertu.

Reguły alertów usługi Azure Cosmos DB

W poniższej tabeli wymieniono niektóre typowe i zalecane reguły alertów dla usługi Azure Cosmos DB.

Typ alertu Warunek opis
Ograniczanie szybkości jednostek żądania (alert metryki) Nazwa wymiaru: StatusCode, Operator: Równa się, Wartości wymiarów: 429 Alerty, jeśli kontener lub baza danych przekroczyła aprowizowany limit przepływności.
Przełączony region w tryb failover Operator: Większe niż, Typ agregacji: Liczba, Wartość progowa: 1 Gdy jeden region zostanie przełączony w tryb failover. Ten alert jest przydatny, jeśli nie włączono trybu failover zarządzanego przez usługę.
Obracanie kluczy (alert dziennika aktywności) Poziom zdarzenia: Informacyjny, Stan: rozpoczęto Alerty po obróceniu kluczy konta. Aplikację można zaktualizować przy użyciu nowych kluczy.

Aby uzyskać więcej informacji i instrukcji dotyczących tworzenia alertów dla usługi Azure Cosmos DB, zobacz Tworzenie alertu dotyczącego metryk. Aby utworzyć alert do monitorowania, czy magazyn klucza partycji logicznej zbliża się do 20 GB, zobacz Tworzenie alertu dotyczącego rozmiaru klucza partycji logicznej.

Zalecenia doradcy

W przypadku niektórych usług, jeśli podczas operacji zasobów wystąpią krytyczne warunki lub nieuchronne zmiany, na stronie Przegląd usługi w portalu zostanie wyświetlony alert. Więcej informacji i zalecanych poprawek alertu można znaleźć w temacie Zalecenia usługi Advisor w obszarze Monitorowanie w menu po lewej stronie. Podczas normalnych operacji nie są wyświetlane żadne zalecenia doradcy.

Aby uzyskać więcej informacji na temat usługi Azure Advisor, zobacz Omówienie usługi Azure Advisor.