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:

  1. Błędy po stronie klienta (w protokole HTTP, które byłyby błędami 400).
  2. 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.

Zrzut ekranu przedstawiający okno dialogowe, aby ustawić tabelę docelową.

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