Monitoruj Azure Cosmos DB

  • Dotyczy: ✅ NoSQL

W tym artykule opisano:

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

Uwaga / Notatka

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ć portalu Azure, programu PowerShell, Azure CLI, interfejsu API REST lub bibliotek klienckich.

Insights

Niektóre usługi w Azure mają wbudowany pulpit nawigacyjny monitorowania w portalu Azure, który zapewnia punkt wyjścia do monitorowania usługi. Te panele są nazywane Insights i można je znaleźć w Insights Hub usługi Azure Monitor w portalu Azure.

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

Analizy 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. 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.

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.

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 portalu Azure, które może wykonywać zapytania dotyczące tego magazynu.
  • Dziennik aktywności platformy Azure to oddzielny sklep z własnym interfejsem w portalu Azure.

Możesz opcjonalnie kierować dane dotyczące metryk i dzienników 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ą Azure Storage, hostowane systemy partnerskie oraz systemy partnerskie spoza Azure, z wykorzystaniem Event Hubs.

Aby uzyskać szczegółowe informacje na temat sposobu przechowywania danych w Azure Monitor, zobacz platformę danych Azure Monitor.

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.

Zbieranie danych: usługa Azure Monitor automatycznie gromadzi metryki platformy. Nie jest wymagana żadna konfiguracja.

Routing: Możesz również kierować niektóre metryki platformy do Azure Monitor Logs /Log Analytics, aby można było wykonywać zapytania o nie przy użyciu innych danych dziennika. Sprawdź ustawienie eksportu DS dla każdej metryki, aby określić, czy możesz użyć ustawienia diagnostycznego do kierowania metryki do usługi Azure Monitor Logs / Log Analytics.

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 jednominutową szczegółowością. Stopień szczegółowości może się różnić w zależności od wybranej metryki. Aby uzyskać więcej informacji na temat domyślnego okresu przechowywania, zobacz Przechowywanie metryk usługi Azure Monitor

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 aktywności, wyjątku i śledzenia stosu, statusu i kodu podstatusu HTTP 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, nie są czułe na wielkość 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 niezwiązane z 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.

<С0>Zbieranie: Dzienniki zasobów nie są zbierane i przechowywane do momentu utworzenia ustawienia diagnostycznego i przesyłania dzienników do co najmniej jednej lokalizacji. Kiedy tworzysz ustawienie diagnostyczne, określasz, które kategorie logów chcesz zbierać. Istnieje wiele sposobów tworzenia i utrzymania ustawień diagnostycznych, w tym za pomocą portalu Azure, programistycznie oraz za pomocą Azure Policy.

Routing: Sugerowana wartość domyślna polega na kierowaniu dzienników zasobów do Azure Monitor Logs, aby można było je przeszukiwać razem 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, 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 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 monitorują operacje każdego zasobu Azure z perspektywy zewnętrznej; na przykład utworzenie nowego zasobu lub uruchomienie maszyny wirtualnej.

Kolekcja: Zdarzenia dziennika aktywności są generowane automatycznie i zbierane w osobnym repozytorium do wyświetlania w portalu Azure.

Routing: Dane dziennika aktywności można wysyłać do Azure Monitor Logs, aby móc je analizować 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.

Kontrola akcji przywracania dla trybu ciągłej kopii zapasowej

Korzystając z dzienników aktywności, można wyświetlić listę wszystkich przywróceń do punktu w czasie w trybie ciągłym, które zostały wykonane na koncie usługi Azure Cosmos DB. Aby dowiedzieć się, jak wyświetlać te operacje w portalu Azure, zobacz Przeprowadź inspekcję działania przywracania do punktu w czasie dla trybu ciągłej kopii zapasowej.

Analizowanie danych monitorowania

Istnieje wiele narzędzi do analizowania danych monitorowania.

narzędzia Azure Monitor

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

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

  • Panele, które umożliwiają łączenie różnych rodzajów danych w jednym okienku w portalu Azure.
  • Workbooks, dostosowywalne raporty, które można tworzyć w portalu Azure. Skoroszyty mogą zawierać tekst, metryki danych i zapytania dziennika.
  • Grafana to otwarte narzędzie platformowe, które wyróżnia się w tworzeniu dashboardów operacyjnych. 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 Azure Monitor można pobrać do innych narzędzi, korzystając z następujących metod:

Aby rozpocząć pracę z interfejsem API REST dla Azure Monitor, zobacz przewodnik Azure Monitor - Przewodnik po interfejsach API REST.

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 wykorzystanie przestrzeni dyskowej konta i całkowita liczba żądań, 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 REST API monitorowania 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 repozytorium dzienników Azure Monitor / Log Analytics przy użyciu języka zapytań Kusto (KQL).

Ważna

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 Azure, wybierz Logs z menu Azure Monitor. Aby uzyskać szczegółowe informacje, zobacz Zakres zapytań 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 logów płaszczyzny danych, specyficznej dla pojedynczego zasobu:

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

Aby uzyskać liczbę dzienników w płaszczyźnie danych, pogrupowanych według zasobów:

CDBDataPlaneRequests
| summarize count() by AccountName

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

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

** Aby dowiedzieć się więcej o zapytaniach Kusto, które 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.

Alerts

Alerty Azure Monitor powiadamiają Cię, gdy określone warunki zostaną znalezione w Twoich 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 sekcji Przykładowe zapytania dziennika alertów. Strona Azure Monitor Baseline Alerts (AMBA) udostępnia częściowo zautomatyzowaną metodę implementowania ważnych alertów metryk platformowych, paneli kontrolnych i wskazówek. 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).

Wspólny schemat alertu standaryzuje przyjmowanie 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 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 metryczne oceniają wskaźniki 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 Insights. Alerty metryczne 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 kondycji zasobów oraz alerty kondycji usług to alerty dziennika aktywności, które raportują na temat stanu zdrowia usług 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 metrycznego do wielu zasobów tego samego typu w tym samym regionie 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 artykuł Monitorowanie wielu zasobów za pomocą 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 Condition Description
Limitowanie szybkości jednostek zapytań (alert metryki) Nazwa wymiaru: StatusCode, Operator: Równa się, Wartości wymiarów: 429 Alerty, jeśli kontener lub baza danych przekracza aprowizowany limit przepływności.
Region przeszedł w tryb awaryjny 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 Powiadomienia podczas rotacji kluczy dostępu do 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 przestrzeń magazynowa dla 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.

Treści powiązane

  • Last updated on