Monitorowanie informacji o danych usługi Azure Cosmos DB

DOTYCZY: Interfejs API SQL interfejs API Cassandra Interfejs API języka Gremlin interfejs API tabel Azure Cosmos DB API dla bazy danych MongoDB

W tym artykule zawarto dokumentację dotyczącą danych dziennika i metryk zebranych w celu analizy wydajności i dostępności usługi Azure Cosmos DB. Zobacz artykuł Monitor Azure Cosmos DB (Monitorowanie usługi Azure Cosmos DB), aby uzyskać szczegółowe informacje na temat zbierania i analizowania danych monitorowania dla usługi Azure Cosmos DB.

Metryki

Wszystkie metryki odpowiadające usłudze Azure Cosmos DB są przechowywane w przestrzeni nazw Cosmos db. Aby uzyskać listę wszystkich obsługiwanych metryk Azure Monitor (w tym usługi Azure Cosmos DB), zobacz Azure Monitor obsługiwanych metryk. W tej sekcji wymieniono wszystkie automatycznie zbierane metryki platformy zebrane dla usługi Azure Cosmos DB.

Metryki żądań

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Wymiary Szczegółowość czasu Mapowanie starszych metryk Użycie
TotalRequests (Łączna liczba żądań) Liczba (liczba) Liczba wykonanych żądań DatabaseName, CollectionName, Region, StatusCode Wszystko TotalRequests, Http 2xx, Http 3xx, Http 400, Http 401, Internal Server error, Service Unavailable, Throttled Requests, Average Requests per Second Służy do monitorowania żądań na kod stanu, kontener z minutowym poziomem szczegółowości. Aby uzyskać średnią liczbę żądań na sekundę, użyj agregacji Liczba w minutach i podziel ją przez 60.
MetadataRequests (Żądania metadanych) Liczba (liczba) Liczba żądań metadanych. Usługa Azure Cosmos DB utrzymuje kontener metadanych systemu dla każdego konta, który umożliwia bezpłatne wyliczanie kolekcji, baz danych itp. oraz ich konfiguracji. DatabaseName, CollectionName, Region, StatusCode Wszystko Służy do monitorowania ograniczeń spowodowanych żądaniami metadanych.
MongoRequests (żądania Mongo) Liczba (liczba) Liczba wykonanych żądań Mongo DatabaseName, CollectionName, Region, CommandName, ErrorCode Wszystko Szybkość żądań zapytań mongo, szybkość żądań aktualizacji mongo, szybkość żądań usuwania mongo, liczba żądań wstawiania Mongo, liczba żądań Mongo Służy do monitorowania błędów żądań Mongo, użycia na typ polecenia.

Metryki jednostki żądania

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Wymiary Szczegółowość czasu Mapowanie starszych metryk Użycie
MongoRequestCharge (opłata za żądanie Mongo) Liczba (łącznie) Zużyte jednostki żądań Mongo DatabaseName, CollectionName, Region, CommandName, ErrorCode Wszystko Mongo Query Request Charge, Mongo Update Request Charge, Mongo Delete Request Charge, Mongo Insert Request Charge, Mongo Count Request Charge Służy do monitorowania zasobów Mongo w ciągu minuty.
TotalRequestUnits (łączna liczba jednostek żądania) Liczba (łącznie) Zużyte jednostki żądań DatabaseName, CollectionName, Region, StatusCode Wszystko TotalRequestUnits Służy do monitorowania całkowitego użycia ru z minutowym poziomem szczegółowości. Aby uzyskać średnią liczbę zużytych ru na sekundę, użyj agregacji Total w minutach i podziel ją przez 60.
ProvisionedThroughput (aprowizowana przepływność) Liczba (maksymalna) Aprowizowana przepływność z poziomem szczegółowości kontenera DatabaseName, ContainerName 5 mln Służy do monitorowania aprowizowanej przepływności na kontener.

Storage metryki

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Wymiary Szczegółowość czasu Mapowanie starszych metryk Użycie
AvailableStorage (dostępne Storage) Bajty (łącznie) Łączny dostępny magazyn zgłoszony z 5-minutowym poziomem szczegółowości na region DatabaseName, CollectionName, Region 5 mln Dostępny magazyn Używane do monitorowania dostępnej pojemności magazynu (dotyczy tylko kolekcji magazynu stałego) Minimalna szczegółowość powinna być 5 minut.
DataUsage (użycie danych) Bajty (łącznie) Łączne użycie danych zgłoszone z 5-minutowym poziomem szczegółowości na region DatabaseName, CollectionName, Region 5 mln Rozmiar danych Aby monitorować łączne użycie danych w kontenerze i regionie, minimalny poziom szczegółowości powinien być 5 minut.
IndexUsage (Użycie indeksu) Bajty (łącznie) Łączne użycie indeksu zgłoszone z 5-minutowym poziomem szczegółowości na region DatabaseName, CollectionName, Region 5 mln Rozmiar indeksu Aby monitorować łączne użycie danych w kontenerze i regionie, minimalny poziom szczegółowości powinien być 5 minut.
DocumentQuota (limit przydziału dokumentu) Bajty (łącznie) Łączny limit przydziału magazynu jest zgłaszany z 5-minutowym poziomem szczegółowości na region. DatabaseName, CollectionName, Region 5 mln Pojemność magazynu Aby monitorować całkowity limit przydziału w kontenerze i regionie, minimalny poziom szczegółowości powinien być 5 minut.
DocumentCount (liczba dokumentów) Liczba (łącznie) Łączna liczba zgłoszonych dokumentów z 5-minutowym poziomem szczegółowości na region DatabaseName, CollectionName, Region 5 mln Liczba dokumentów Aby monitorować liczbę dokumentów w kontenerze i regionie, minimalny poziom szczegółowości powinien wyliczyć 5 minut.

Metryki opóźnienia

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Wymiary Szczegółowość czasu Użycie
ReplicationLatency (opóźnienie replikacji) Milisekundy (minimum, maksimum, średnia) Opóźnienie replikacji P99 w regionach źródłowym i docelowym dla konta z włączoną obsługą geograficzną SourceRegion, TargetRegion Wszystko Służy do monitorowania opóźnienia replikacji P99 między dowolnymi dwoma regionami dla konta replikowanego geograficznie.
Opóźnienie po stronie serwera MilliSeconds (średnia) Czas przetwarzania żądania przez serwer. CollectionName, ConnectionMode, DatabaseName, OperationType, PublicAPIType, Region Wszystko Służy do monitorowania opóźnienia żądań na serwerze usługi Azure Cosmos DB.

Metryki dostępności

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Szczegółowość czasu Mapowanie starszych metryk Użycie
ServiceAvailability (dostępność usługi) Procent (minimum, maksimum) Konto żąda dostępności z godzinnym poziomem szczegółowości 1 godz. Dostępność usługi Reprezentuje procent całkowitej liczby przekazanych żądań. Żądanie jest uznawane za nieudane z powodu błędu systemu, jeśli kod stanu to 410, 500 lub 503 Służy do monitorowania dostępności konta z godzinnym stopniem szczegółowości.

interfejs API Cassandra metryki

Metryka (nazwa wyświetlana metryki) Jednostka (typ agregacji) Opis Wymiary Szczegółowość czasu Użycie
CassandraRequests (żądania Cassandra) Liczba (liczba) Liczba interfejs API Cassandra żądań DatabaseName, CollectionName, ErrorCode, Region, OperationType, ResourceType Wszystko Służy do monitorowania żądań Cassandra z minutowym poziomem szczegółowości. Aby uzyskać średnią liczbę żądań na sekundę, użyj agregacji Liczba w minutach i podziel ją przez 60.
CassandraRequestCharges (opłaty za żądania Cassandra) Count (Suma, Minimalna, Maksymalna, Średnia) Jednostki żądania używane przez interfejs API Cassandra DatabaseName, CollectionName, Region, OperationType, ResourceType Wszystko Służy do monitorowania jednostki RU używanej na minutę przez interfejs API Cassandra konto.
CassandraConnectionClosures (Zamknięcia połączeń Cassandra) Liczba (liczba) Liczba zamkniętych połączeń Cassandra ClosureReason, Region Wszystko Służy do monitorowania łączności między klientami a usługą Azure Cosmos DB interfejs API Cassandra.

Aby uzyskać więcej informacji, zobacz listę wszystkich metryk platformy obsługiwanych wAzure Monitor .

Dzienniki zasobów

W poniższej tabeli wymieniono właściwości dzienników zasobów w usłudze Azure Cosmos DB. Dzienniki zasobów są zbierane w dziennikach Azure Monitor lub azure Storage. W Azure Monitor dzienniki są zbierane w tabeli AzureDiagnostics pod nazwą dostawcy MICROSOFT.DOCUMENTDB zasobów**.

Pole Storage lub właściwość usługi Azure Storage Azure Monitor Logs Opis
Czas TimeGenerated Data i godzina (UTC) rozpoczęcia operacji.
resourceId Zasób Konto usługi Azure Cosmos DB, dla którego są włączone dzienniki.
Kategorii Kategoria Dostępne typy dzienników to azure Cosmos DB, DataPlaneRequests, MongoRequests, QueryRuntimeStatistics, PartitionKeyStatistics, PartitionKeyRUConsumption, ControlPlaneRequests, CassandraRequests, GremlinRequests.
operationName Operationname Nazwa operacji. Nazwa operacji może być Create , , , , , , , , Update , , , Read , lub ReadFeed Delete Replace Execute SqlQuery Query JSQuery Head HeadFeed Upsert .
Właściwości n/d Zawartość tego pola jest opisana w wierszach, które należy wykonać.
Activityid activityId_g Unikatowy identyfikator GUID dla zarejestrowanej operacji.
Useragent userAgent_s Ciąg określający agenta użytkownika klienta, z którego wysłano żądanie. Format agenta użytkownika to {user agent name}/{version} .
requestResourceType requestResourceType_s Typ zasobu, do którego uzyskano dostęp. Ta wartość może być bazą danych, kontenerem, dokumentem, załącznikiem, użytkownikiem, uprawnieniem, procedurą składowaną, wyzwalaczem, funkcją zdefiniowaną przez użytkownika lub ofertą.
statusCode statusCode_s Stan odpowiedzi operacji.
requestResourceId Resourceid ResourceId, który odnosi się do żądania. W zależności od wykonanej operacji ta wartość może wskazać databaseRid wartość collectionRid , lub documentRid .
clientIpAddress clientIpAddress_s Adres IP klienta.
requestCharge requestCharge_s Liczba ru/s używanych przez operację
collectionRid collectionId_s Unikatowy identyfikator kolekcji.
Długość duration_d Czas trwania operacji, w milisekundach.
requestLength requestLength_s Długość żądania w bajtach.
responseLength responseLength_s Długość odpowiedzi w bajtach.
resourceTokenPermissionId resourceTokenPermissionId_s Ta właściwość wskazuje określony identyfikator uprawnień tokenu zasobu. Aby dowiedzieć się więcej na temat uprawnień, zobacz artykuł Bezpieczny dostęp do danych.
resourceTokenPermissionMode resourceTokenPermissionMode_s Ta właściwość wskazuje tryb uprawnień ustawiony podczas tworzenia tokenu zasobu. Tryb uprawnień może mieć wartości takie jak "wszystkie" lub "odczyt". Aby dowiedzieć się więcej na temat uprawnień, zobacz artykuł Bezpieczny dostęp do danych.
resourceTokenUserRid resourceTokenUserRid_s Ta wartość nie jest pusta, gdy tokeny zasobów są używane do uwierzytelniania. Wartość wskazuje identyfikator zasobu użytkownika.
responseLength responseLength_s Długość odpowiedzi w bajtach.

Aby uzyskać listę wszystkich kategorii dzienników Azure Monitor i linki do skojarzonych schematów, zobacz Azure Monitor Kategorie i schematy dzienników.

Azure Monitor logs

Usługa Azure Cosmos DB używa tabel kusto z Azure Monitor dzienników. Zapytania dotyczące tych tabel można rejestrować za pomocą usługi Log Analytics. Aby uzyskać listę tabel Usługi Kusto Cosmos DB, zobacz artykuł Azure Monitor Logs table reference (Informacje o tabeli usługi Azure Monitor Logs).

Zobacz też