Dokumentacja danych monitorowania usługi Azure Event Hubs
Aby uzyskać szczegółowe informacje na temat zbierania i analizowania danych monitorowania dla usługi Azure Event Hubs, zobacz Monitorowanie usługi Azure Event Hubs .
Uwaga
Usługa Azure Monitor nie uwzględnia wymiarów w wyeksportowanych danych metryk, które są wysyłane do miejsca docelowego, takiego jak Azure Storage, Azure Event Hubs, Log Analytics itp.
Metryki
Ta sekcja zawiera listę wszystkich automatycznie zebranych metryk platformy zebranych dla usługi Azure Event Hubs. Dostawca zasobów dla tych metryk to Microsoft.EventHub/clusters lub Microsoft.EventHub/namespaces.
Metryki żądań
Zlicza liczbę żądań operacji dotyczących danych i zarządzania.
Nazwa metryki | Możliwość eksportowania za pomocą ustawień diagnostycznych | Jednostka | Typ agregacji | opis | Wymiary |
---|---|---|---|---|---|
Żądania przychodzące | Tak | Liczba | Liczba | Liczba żądań wysyłanych do usługi Event Hubs w określonym okresie. Ta metryka zawiera wszystkie operacje płaszczyzny zarządzania i danych. | Nazwa podmiotu |
Żądania pomyślne | Nie. | Liczba | Liczba | Liczba pomyślnych żądań wysyłanych do usługi Event Hubs w określonym przedziale czasu. | Nazwa podmiotu Wynik operacji |
Żądania ograniczone | Nie. | Liczba | Liczba | Liczba żądań, które zostały ograniczone, ponieważ użycie zostało przekroczone. | Nazwa podmiotu Wynik operacji |
Następujące dwa typy błędów są klasyfikowane jako błędy użytkownika:
- Błędy po stronie klienta (w protokole HTTP, które byłyby błędami 400).
- Błędy występujące podczas przetwarzania komunikatów.
Metryki komunikatów
Nazwa metryki | Możliwość eksportowania za pomocą ustawień diagnostycznych | Jednostka | Typ agregacji | opis | Wymiary |
---|---|---|---|---|---|
Komunikaty przychodzące | Tak | Liczba | Liczba | Liczba zdarzeń lub komunikatów wysyłanych do usługi Event Hubs w określonym przedziale czasu. | Nazwa podmiotu |
Komunikaty wychodzące | Tak | Liczba | Liczba | Liczba zdarzeń lub komunikatów odebranych z usługi Event Hubs w określonym przedziale czasu. | Nazwa podmiotu |
Przechwycone komunikaty | Nie. | Liczba | Liczba | Liczba przechwyconych komunikatów. | Nazwa podmiotu |
Bajty przychodzące | Tak | Bajty | Count | Bajty przychodzące dla centrum zdarzeń w określonym przedziale czasu. | Nazwa podmiotu |
Bajty wychodzące | Tak | Bajty | Count | Bajty wychodzące dla centrum zdarzeń w określonym przedziale czasu. | Nazwa podmiotu |
Rozmiar | Nie. | Bajty | Średnia | Rozmiar centrum zdarzeń w bajtach. | Nazwa podmiotu |
Uwaga
- Te wartości są wartościami punkt-w czasie. Komunikaty przychodzące, które zostały zużyte natychmiast po tym punkcie w czasie, mogą nie być odzwierciedlane w tych metrykach.
- Metryka Żądania przychodzące zawiera wszystkie operacje na płaszczyźnie zarządzania i danych. Metryka Komunikaty przychodzące zawiera łączną liczbę zdarzeń wysyłanych do centrum zdarzeń. Jeśli na przykład wyślesz partię 100 zdarzeń do centrum zdarzeń, będzie ona liczyć jako 1 żądanie przychodzące i 100 przychodzących komunikatów.
Przechwytywanie metryk
Nazwa metryki | Możliwość eksportowania za pomocą ustawień diagnostycznych | Jednostka | Typ agregacji | opis | Wymiary |
---|---|---|---|---|---|
Przechwycone komunikaty | Nie. | Liczba | Liczba | Liczba przechwyconych komunikatów. | Nazwa podmiotu |
Przechwycone bajty | Nie. | Bajty | Count | Przechwycone bajty dla centrum zdarzeń | Nazwa podmiotu |
Lista prac przechwytywania | Nie. | Liczba | Liczba | Przechwytywanie listy prac dla centrum zdarzeń | Nazwa podmiotu |
Metryki Połączenie ion
Nazwa metryki | Możliwość eksportowania za pomocą ustawień diagnostycznych | Jednostka | Typ agregacji | opis | Wymiary |
---|---|---|---|---|---|
Aktywne połączenia | Nie. | Count | Średnia | Liczba aktywnych połączeń w przestrzeni nazw i w jednostce (centrum zdarzeń) w przestrzeni nazw. Wartość tej metryki jest wartością typu punkt w czasie. Połączenie, które były aktywne bezpośrednio po tym punkcie w czasie, mogą nie zostać odzwierciedlone w metryce. | Nazwa podmiotu |
otwarte Połączenie ions | Nie. | Count | Średnia | Liczba otwartych połączeń. | Nazwa podmiotu |
Zamknięte Połączenie iony | Nie. | Count | Średnia | Liczba zamkniętych połączeń. | Nazwa podmiotu |
Metryki błędów
Nazwa metryki | Możliwość eksportowania za pomocą ustawień diagnostycznych | Jednostka | Typ agregacji | opis | Wymiary |
---|---|---|---|---|---|
Błędy serwera | Nie. | Liczba | Liczba | Liczba żądań, które nie zostały przetworzone z powodu błędu w usłudze Event Hubs w określonym przedziale czasu. | Nazwa podmiotu Wynik operacji |
Błędy użytkownika | Nie. | Liczba | Liczba | Liczba żądań, które nie zostały przetworzone z powodu błędów użytkownika w określonym przedziale czasu. | Nazwa podmiotu Wynik operacji |
Błędy przekroczenia limitu przydziału | Nie. | Liczba | Liczba | Liczba błędów spowodowanych przekroczeniem limitów przydziału w określonym przedziale czasu. | Nazwa podmiotu Wynik operacji |
Uwaga
Usługa Logic Apps tworzy odbiorniki epoki i odbiorniki mogą być przenoszone z jednego węzła do innego w zależności od obciążenia usługi. Podczas tych ruchów ReceiverDisconnection
mogą wystąpić wyjątki. Są one liczone jako błędy użytkownika po stronie usługi Event Hubs. Usługa Logic Apps może zbierać błędy z klientów usługi Event Hubs, aby można było je wyświetlać w dziennikach użytkowników.
Wymiary metryk
Usługa Azure Event Hubs obsługuje następujące wymiary metryk w usłudze Azure Monitor. Dodawanie wymiarów do metryk jest opcjonalne. Jeśli nie dodasz wymiarów, metryki są określane na poziomie przestrzeni nazw.
Nazwa wymiaru | opis |
---|---|
Nazwa encji | Nazwa centrum zdarzeń. W przypadku metryki "Żądania przychodzące" wymiar Nazwa jednostki ma wartość "-NamespaceOnlyMetric-" oprócz wszystkich centrów zdarzeń. Reprezentuje żądania, które zostały wykonane na poziomie przestrzeni nazw. Przykłady obejmują żądanie wyświetlenia listy wszystkich centrów zdarzeń w przestrzeni nazw lub żądania do jednostek, które nie powiodły się uwierzytelnianie lub autoryzacja. |
Dzienniki zasobów
Usługa Azure Event Hubs ma teraz możliwość wysyłania dzienników do jednej z dwóch tabel docelowych — diagnostyki platformy Azure lub tabel specyficznych dla zasobów w usłudze Log Analytics. Aby wybrać tabele docelowe, możesz użyć przełącznika dostępnego w witrynie Azure Portal.
Usługa Event Hubs przechwytuje dzienniki diagnostyczne dla następujących kategorii:
Kategoria | opis |
---|---|
Archiwizowanie dzienników | Przechwytuje informacje o operacjach przechwytywania usługi Event Hubs, w szczególności dziennikach związanych z przechwytywaniem błędów. |
Dzienniki operacyjne | Przechwyć wszystkie operacje zarządzania wykonywane w przestrzeni nazw usługi Azure Event Hubs. Operacje na danych nie są przechwytywane ze względu na dużą liczbę operacji danych wykonywanych w usłudze Azure Event Hubs. |
Automatyczne skalowanie dzienników | Przechwytuje operacje automatycznego rozszerzania wykonywane w przestrzeni nazw usługi Event Hubs. |
Dzienniki koordynatora platformy Kafka | Przechwytuje operacje koordynatora platformy Kafka związane z usługą Event Hubs. |
Dzienniki błędów użytkownika platformy Kafka | Przechwytuje informacje o interfejsach API platformy Kafka wywoływanych w usłudze Event Hubs. |
Zdarzenie połączenia sieci wirtualnej usługi Event Hubs | Przechwytuje informacje o adresach IP i sieciach wirtualnych wysyłających ruch do usługi Event Hubs. |
Dzienniki użytkowników klucza zarządzanego przez klienta | Przechwytuje operacje związane z kluczem zarządzanym przez klienta. |
Dzienniki inspekcji środowiska uruchomieniowego | Przechwyć zagregowane informacje diagnostyczne dotyczące wszystkich operacji dostępu do płaszczyzny danych (takich jak wysyłanie lub odbieranie zdarzeń) w usłudze Event Hubs. |
Dzienniki metryk aplikacji | Przechwyć zagregowane informacje dotyczące niektórych metryk związanych z operacjami płaszczyzny danych. |
Wszystkie dzienniki są przechowywane w formacie JavaScript Object Notation (JSON). Każdy wpis zawiera pola ciągów, które używają formatu opisanego w poniższych sekcjach.
Archiwizowanie schematu dzienników
Ciągi JSON dziennika archiwum zawierają elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w dziennikach AZMSArchiveLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
TaskName |
Opis zadania, które nie powiodło się | Tak | Tak |
ActivityId |
Identyfikator wewnętrzny używany do śledzenia | Tak | Tak |
trackingId |
Identyfikator wewnętrzny używany do śledzenia | Tak | Tak |
resourceId |
Identyfikator zasobu usługi Azure Resource Manager | tak | Tak |
eventHub |
Pełna nazwa centrum zdarzeń (łącznie z nazwą przestrzeni nazw) | Tak | Nie. |
EventhubName |
Nazwa jednostki centrum zdarzeń | Nie. | Tak |
partitionId |
Partycja centrum zdarzeń zapisywana w | Tak | Tak |
archiveStep |
możliwe wartości: ArchiveFlushWriter, DestinationInit | Tak | Tak |
startTime |
Godzina rozpoczęcia błędu | Tak | Nie. |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
failures |
Liczba przypadków wystąpienia błędu | Tak | Tak |
durationInSeconds |
Czas trwania awarii | Tak | Tak |
message |
Komunikat o błędzie | Tak | Tak |
category |
Kategoria dziennika | Tak | Nie. |
Provider |
Nazwa usługi emitujące dzienniki, na przykład Event Hubs | Nie. | Tak |
Type |
Typ emitowanego dziennika | Nie. | Tak |
Poniższy kod jest przykładem ciągu JSON dziennika archiwum:
AzureDiagnostics:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"eventHub": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"startTime": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"category": "ArchiveLogs"
}
Wpis tabeli specyficznej dla zasobu:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"EventHubName": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"TimeGenerated(UTC)": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"Provider":"EVENTHUB",
"Type":"AZMSArchiveLogs"
}
Schemat dzienników operacyjnych
Ciągi JSON dziennika operacyjnego zawierają elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w usłudze AzureDiagnostics | Obsługiwane w AZMSOperationalLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
ActivityId |
Identyfikator wewnętrzny używany do celów śledzenia | Tak | Tak |
EventName |
nazwa operacji. Aby uzyskać listę wartości dla tego elementu, zobacz Nazwy zdarzeń | Tak | Tak |
resourceId |
Identyfikator zasobu usługi Azure Resource Manager | Tak | Tak |
SubscriptionId |
Identyfikator subskrypcji | Tak | Tak |
EventTimeString |
Czas operacji | Tak | Nie. |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
EventProperties |
Właściwości operacji. Ten element zawiera więcej informacji o zdarzeniu, jak pokazano w poniższym przykładzie. | Tak | Tak |
Status |
Stan operacji. Wartość może mieć wartość Powodzenie lub Niepowodzenie. | Tak | Tak |
Caller |
Obiekt wywołujący operację (witryna Azure Portal lub klient zarządzania) | Tak | Tak |
Category |
Kategoria dziennika | Tak | Nie. |
Provider |
Nazwa usługi emitujące dzienniki, na przykład Event Hubs | Nie. | Tak |
Type |
Typ emitowanych dzienników | Nie. | Tak |
Poniższy kod jest przykładem ciągu JSON dziennika operacyjnego:
AzureDiagnostics:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"EventTimeString": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"category": "OperationalLogs"
}
Wpis tabeli specyficznej dla zasobu:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"TimeGenerated (UTC)": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"Provider": "EVENTHUB",
"Type":"AZMSOperationalLogs"
}
Nazwy zdarzeń
Nazwa zdarzenia jest wypełniana jako typ operacji i typ zasobu z poniższych wyliczenia. Na przykład, Create Queue
, Retrieve Event Hub
lub Delete Rule
.
Typ operacji | Typ zasobu |
---|---|
- Utwórz -Aktualizacji - Usuń -Pobrać -Nieznany |
-Obszaru nazw -Kolejki -Temat -Subskrypcji — Event Hubs - SharedAccessPolicy - UsageCredit -Reguły - ConsumerGroup |
Schemat dzienników skalowania automatycznego
Plik JSON dziennika automatycznego skalowania zawiera elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w AZMSAutoscaleLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
TrackingId |
Identyfikator wewnętrzny, który jest używany do celów śledzenia | Tak | Tak |
ResourceId |
Identyfikator zasobu usługi Azure Resource Manager. | Tak | Tak |
Message |
Komunikat informacyjny, który zawiera szczegółowe informacje o akcji autoinflate. Komunikat zawiera poprzednią i bieżącą wartość jednostki przepływności dla danej przestrzeni nazw oraz to, co wyzwoliło nadmuchanie tu. | Tak | Tak |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
Provider |
Nazwa usługi emitująca dzienniki, na przykład Event Hubs | Nie. | Tak |
Type |
Typ emitowanych dzienników | Nie. | Tak |
Oto przykładowe zdarzenie skalowania automatycznego:
AzureDiagnostics:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name"
}
Wpis tabeli specyficznej dla zasobu:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"timeGenerated (UTC) : "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSAutoscaleLogs"
}
Schemat dzienników koordynatora platformy Kafka
Kod JSON dziennika koordynatora platformy Kafka zawiera elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w AZMSKafkaCoordinatorLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
RequestId |
Identyfikator żądania, który jest używany do celów śledzenia | Tak | Tak |
ResourceId |
Identyfikator zasobu usługi Azure Resource Manager | Tak | Tak |
Operation |
Nazwa operacji wykonanej podczas koordynacji grupy | Tak | Tak |
ClientId |
Client ID | Tak | Tak |
NamespaceName |
Nazwa przestrzeni nazw | Tak | Tak |
SubscriptionId |
Identyfikator subskrypcji Azure | Tak | Tak |
Message |
Komunikat informacyjny lub ostrzegawczy, który zawiera szczegółowe informacje o akcjach wykonywanych podczas koordynacji grupy. | Tak | Tak |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
Provider |
Nazwa usługi emitująca dzienniki, na przykład ServiceBus | Nie. | Tak |
Type |
Typ emitowanego dziennika | Nie. | Tak |
Przykład
AzureDiagnostics:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "KafkaCoordinatorLogs"
}
Wpis tabeli Specyficzne dla zasobu:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSKafkaCoordinatorLogs"
}
Schemat dzienników błędów użytkownika platformy Kafka
Plik JSON dziennika błędów użytkownika platformy Kafka zawiera elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w AZMSKafkaUserErrorLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
TrackingId |
Identyfikator śledzenia, który jest używany do celów śledzenia. | Tak | Tak |
NamespaceName |
Nazwa przestrzeni nazw | Tak | Tak |
Eventhub |
Nazwa centrum zdarzeń | Tak | Tak |
PartitionId |
Identyfikator partycji | Tak | Tak |
GroupId |
Identyfikator grupy | Tak | Tak |
ClientId |
Client ID | Tak | Tak |
ResourceId |
Identyfikator zasobu usługi Azure Resource Manager. | Tak | Tak |
Message |
Komunikat informacyjny zawierający szczegółowe informacje o błędzie | Tak | Tak |
TimeGenerated (UTC) |
Sygnatura czasowa dla wykonanej operacji | Nie. | Tak |
Provider |
Nazwa usługi emitujące dzienniki, na przykład Event Hubs | Nie. | Tak |
Type |
Typ emitowanego dziennika | NIE | Tak |
Schemat zdarzeń połączenia sieci wirtualnej usługi Event Hubs
Plik JSON zdarzenia połączenia sieci wirtualnej usługi Event Hubs (sieć wirtualna) zawiera elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w sieci AZMSVNet Połączenie ionevents (tabela specyficzna dla zasobów) |
---|---|---|---|
SubscriptionId |
Identyfikator subskrypcji Azure | Tak | Tak |
NamespaceName |
Nazwa przestrzeni nazw | Tak | Tak |
IPAddress |
Adres IP klienta nawiązującego połączenie z usługą Event Hubs | Tak | Tak |
Action |
Akcja wykonywana przez usługę Event Hubs podczas oceniania żądań połączenia. Obsługiwane akcje to Akceptuj Połączenie ion i Odmów Połączenie ion. | Tak | Tak |
Reason |
Zawiera powód, dla którego wykonano akcję | Tak | Nie. |
Message |
Zawiera powód, dla którego wykonano akcję | Nie. | Tak |
Count |
Liczba wystąpień dla danej akcji | Tak | Tak |
ResourceId |
Identyfikator zasobu usługi Azure Resource Manager. | Tak | Tak |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
Provider |
Nazwa usługi emitująca dzienniki, na przykład ServiceBus | Nie. | Tak |
Type |
AZMSVNet Połączenie ionevents | Nie. | Tak |
Dzienniki sieci wirtualnej są generowane tylko wtedy, gdy przestrzeń nazw zezwala na dostęp z wybranych sieci lub z określonych adresów IP (reguł filtrowania adresów IP). Jeśli nie chcesz ograniczać dostępu do przestrzeni nazw przy użyciu tych funkcji i nadal chcesz uzyskać dzienniki sieci wirtualnej w celu śledzenia adresów IP klientów łączących się z przestrzenią nazw usługi Event Hubs, możesz użyć następującego obejścia. Włącz filtrowanie adresów IP i dodaj łączny zakres adresowalny IPv4 (128.0.0.0/1
- 0.0.0.0/1
) i zakres IPv6 ().::/1
- 8000::/1
Filtrowanie adresów IP usługi Event Hubs nie obsługuje zakresów IPv6. W dzienniku mogą być widoczne prywatne adresy punktów końcowych w formacie IPv6.
Przykład
AzureDiagnostics:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Reason": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "EventHubVNetConnectionEvent"
}
Wpis tabeli specyficznej dla zasobu:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Message": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSKafkauserErrorlogs"
}
Schemat dzienników użytkowników klucza zarządzanego przez klienta
Plik JSON dziennika użytkownika zarządzanego przez klienta zawiera elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w AZMSCustomerManagedKeyUserLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
Category |
Typ kategorii komunikatu. Jest to jedna z następujących wartości: błąd i informacje. Jeśli na przykład klucz z magazynu kluczy jest wyłączony, będzie to kategoria informacji lub jeśli klucz nie może zostać rozpasany, może to być błąd. | Tak | Tak |
ResourceId |
Wewnętrzny identyfikator zasobu, który zawiera identyfikator subskrypcji platformy Azure i nazwę przestrzeni nazw | Tak | Tak |
KeyVault |
Nazwa zasobu usługi Key Vault | Tak | Tak |
Key |
Nazwa klucza usługi Key Vault używanego do szyfrowania przestrzeni nazw usługi Event Hubs. | Tak | Tak |
Version |
Wersja klucza usługi Key Vault. | Tak | Tak |
Operation |
Operacja wykonywana na kluczu w magazynie kluczy. Na przykład wyłącz/włącz klucz, zawijanie lub odpakowywanie. | Tak | Tak |
Code |
Kod skojarzony z operacją. Przykład: Kod błędu 404 oznacza, że klucz nie został znaleziony. | Tak | Tak |
Message |
Komunikat zawierający szczegółowe informacje o błędzie lub komunikacie informacyjnym | Tak | Tak |
Time Generated (UTC) |
Sygnatura czasowa operacji | Nie. | Tak |
Provider |
Nazwa usługi emitująca dzienniki, na przykład ServiceBus | Nie. | Tak |
Type |
Typ emitowanego dziennika | Nie. | Tak |
Oto przykład dziennika klucza zarządzanego przez klienta:
AzureDiagnostics:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": ""
}
Wpis tabeli specyficznej dla zasobu:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": "",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
Poniżej przedstawiono typowe kody błędów do wyszukania, gdy szyfrowanie BYOK jest włączone.
Akcja | Kod błędu | Wynikowy stan danych |
---|---|---|
Usuwanie uprawnień zawijania/odpakowywania z magazynu kluczy | 403 | Niedostępne |
Usuwanie członkostwa roli Identyfikator entra firmy Microsoft z podmiotu zabezpieczeń firmy Microsoft, które przyznało uprawnienie zawijania/odpakowywania | 403 | Niedostępne |
Usuwanie klucza szyfrowania z magazynu kluczy | 404 | Niedostępne |
Usuwanie magazynu kluczy | 404 | Niedostępne (zakłada się, że usuwanie nietrwałe jest włączone, co jest wymaganym ustawieniem). |
Zmiana okresu wygaśnięcia klucza szyfrowania, tak aby wygasła | 403 | Niedostępne |
Zmiana NBF (nie wcześniej), tak aby klucz szyfrowania klucza nie był aktywny | 403 | Niedostępne |
Wybranie opcji Zezwalaj na usługi MSFT dla zapory magazynu kluczy lub blokowanie dostępu sieciowego do magazynu kluczy z kluczem szyfrowania | 403 | Niedostępne |
Przenoszenie magazynu kluczy do innej dzierżawy | 404 | Niedostępne |
Sporadyczne problemy z siecią lub awaria usługi DNS/AAD/MSI | Dostępny przy użyciu buforowanego klucza szyfrowania danych |
Dzienniki inspekcji środowiska uruchomieniowego
Dzienniki inspekcji środowiska uruchomieniowego przechwytują zagregowane informacje diagnostyczne dla wszystkich operacji dostępu do płaszczyzny danych (takich jak wysyłanie lub odbieranie zdarzeń) w usłudze Event Hubs.
Uwaga
Dzienniki inspekcji środowiska uruchomieniowego są dostępne tylko w warstwach Premium i dedykowanych .
Dzienniki inspekcji środowiska uruchomieniowego zawierają elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w tabeli Specyficzne dla zasobów |
---|---|---|---|
ActivityId |
Wygenerowany losowo identyfikator UUID zapewniający unikatowość działania inspekcji. | Tak | Tak |
ActivityName |
Nazwa operacji środowiska uruchomieniowego. | Tak | Tak |
ResourceId |
Zasób skojarzony z działaniem. | Tak | Tak |
Timestamp |
Czas agregacji. | Tak | Nie. |
TimeGenerated [UTC] |
Czas wykonania operacji (w utc) | Nie. | Tak |
Status |
Stan działania (powodzenie lub niepowodzenie). | Tak | Tak |
Protocol |
Typ protokołu skojarzonego z operacją. | Tak | Tak |
AuthType |
Typ uwierzytelniania (usługa Azure Active Directory lub zasady sygnatury dostępu współdzielonego). | Tak | Tak |
AuthKey |
Identyfikator aplikacji usługi Azure Active Directory lub nazwa zasad sygnatury dostępu współdzielonego używana do uwierzytelniania w zasobie. | Tak | Tak |
NetworkType |
Typ dostępu do sieci: Public lub Private . |
Tak | Tak |
ClientIP |
Adres IP aplikacji klienckiej. | Tak | Tak |
Count |
Łączna liczba operacji wykonywanych w zagregowanym okresie 1 minuty. | Tak | Tak |
Properties |
Metadane specyficzne dla operacji płaszczyzny danych. | Tak | Tak |
Category |
Kategoria dziennika | Tak | NIE |
Provider |
Nazwa usługi emitująca dzienniki, np. Eventhub | Nie. | Tak |
Type |
Typ emitowanych dzienników | Nie. | Tak |
Oto przykład wpisu dziennika inspekcji środowiska uruchomieniowego:
AzureDiagnostics :
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"Time": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<AAD application name | SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Category": "RuntimeAuditLogs"
}
Wpis tabeli specyficznej dla zasobu:
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<AAD application name | SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Type": "AZMSRuntimeAUditLogs",
"Provider":"EVENTHUB"
}
Dzienniki metryk aplikacji
Dzienniki metryk aplikacji przechwytują zagregowane informacje dotyczące niektórych metryk związanych z operacjami płaszczyzny danych. Przechwycone informacje obejmują następujące metryki środowiska uruchomieniowego.
Uwaga
Dzienniki metryk aplikacji są dostępne tylko w warstwach Premium i dedykowanych .
Nazwa/nazwisko | opis |
---|---|
ConsumerLag |
Wskazuje opóźnienie między konsumentami a producentami. |
NamespaceActiveConnections |
Szczegóły aktywnych połączeń nawiązanych z klienta do centrum zdarzeń. |
GetRuntimeInfo |
Uzyskaj informacje o czasie wykonywania z usługi Event Hubs. |
GetPartitionRuntimeInfo |
Uzyskaj przybliżone informacje o środowisku uruchomieniowym dla partycji logicznej centrum zdarzeń. |
IncomingMessages |
Szczegóły liczby komunikatów opublikowanych w usłudze Event Hubs. |
IncomingBytes |
Szczegóły przepływności wydawcy wysyłanej do usługi Event Hubs |
OutgoinMessages |
Szczegóły liczby komunikatów używanych z usługi Event Hubs. |
OutgoingBytes |
Szczegóły przepływności odbiorcy z usługi Event Hubs. |
OffsetCommit |
Liczba wywołań zatwierdzenia przesunięcia wykonanych w centrum zdarzeń |
OffsetFetch |
Liczba wywołań pobierania przesunięcia wykonanych w centrum zdarzeń. |
Dzienniki błędów diagnostycznych
Dzienniki błędów diagnostycznych przechwytują komunikaty o błędach po stronie klienta, ograniczanie przepustowości i przekroczenie limitu przydziału. Zapewniają szczegółową diagnostykę identyfikacji błędów.
Dzienniki błędów diagnostycznych zawierają elementy wymienione w poniższej tabeli:
Nazwa/nazwisko | opis | Obsługiwane w Diagnostyka Azure | Obsługiwane w AZMSDiagnosticErrorLogs (tabela specyficzna dla zasobów) |
---|---|---|---|
ActivityId |
Wygenerowany losowo identyfikator UUID zapewniający unikatowość działania inspekcji. | Tak | Tak |
ActivityName |
Nazwa operacji | Tak | Tak |
NamespaceName |
Nazwa przestrzeni nazw | Tak | tak |
EntityType |
Typ jednostki | Tak | Tak |
EntityName |
Nazwa jednostki | Tak | Tak |
OperationResult |
Typ błędu w operacji (Błąd klienta lub Błąd serwera lub limit przydziałuexceeded) | Tak | Tak |
ErrorCount |
Liczba identycznych błędów w okresie agregacji 1 minuty. | Tak | Tak |
ErrorMessage |
Szczegółowy komunikat o błędzie | Tak | Tak |
ResourceProvider |
Nazwa usługi emitujące dzienniki. Możliwe wartości: Microsoft.Eventhub i Microsoft.Servicebus | Tak | Tak |
Time Generated (UTC) |
Czas operacji | Nie. | Tak |
EventTimestamp |
Czas operacji | Tak | Nie. |
Category |
Kategoria dziennika | Tak | Nie. |
Type |
Typ emitowanych dzienników | Nie. | Tak |
Oto przykład wpisu dziennika błędów diagnostycznych:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"SubscriptionId": "<Azure Subscription Id",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "EventHub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
"ErrorMessage": "the request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"category": "DiagnosticErrorLogs"
}
Wpis tabeli specyficznej dla zasobu:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "Event Hub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
"ErrorMessage": "The request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"Type": "AZMSDiagnosticErrorLogs"
}
Tabele dzienników usługi Azure Monitor
Usługa Azure Event Hubs używa tabel Kusto z dzienników usługi Azure Monitor. Te tabele można wykonywać za pomocą usługi Log Analytics. Aby uzyskać listę tabel Usługi Kusto używanych przez usługę, zobacz Dokumentacja tabeli dzienników usługi Azure Monitor.
Aby rozpocząć pracę z różnymi kategoriami dzienników, możesz wyświetlić nasze przykładowe zapytania.
Ważne
Wymiary nie są eksportowane do obszaru roboczego usługi Log Analytics.
Następne kroki
- Aby uzyskać szczegółowe informacje na temat monitorowania usługi Azure Event Hubs, zobacz Monitorowanie usługi Azure Event Hubs.
- Aby uzyskać szczegółowe informacje na temat monitorowania zasobów platformy Azure, zobacz Monitorowanie zasobów platformy Azure za pomocą usługi Azure Monitor.