Referenz zum Überwachen von Azure Event Hubs-Daten
Ausführliche Informationen zum Erfassen und Analysieren von Überwachungsdaten für Azure Event Hubs finden Sie unter Überwachen von Azure Event Hubs.
Hinweis
Azure Monitor schließt keine Dimensionen in die exportierten Metrikdaten ein, die an ein Ziel wie Azure Storage, Azure Event Hubs oder Log Analytics gesendet werden.
Metriken
In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken aufgeführt, die für Azure Event Hubs erfasst werden. Der Ressourcenanbieter für diese Metriken ist Microsoft.EventHub/clusters oder Microsoft.EventHub/namespaces.
Anforderungsmetriken
Zählt die Anzahl der Anforderungen von Daten und Verwaltungsvorgängen
| Metrikname | Über Diagnoseeinstellungen exportierbar | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| Eingehende Anforderungen | Ja | Anzahl | Anzahl | Die Anzahl von Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum. Diese Metrik umfasst alle Vorgänge auf der Daten- und Verwaltungsebene. | Name der Entität |
| Erfolgreiche Anforderungen | Nein | Anzahl | Anzahl | Die Anzahl erfolgreicher Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum. | Name der Entität Ergebnis des Vorgangs |
| Gedrosselte Anforderungen | Nein | Anzahl | Anzahl | Die Anzahl der Anforderungen, die aufgrund eines überschrittenen Verbrauchs gedrosselt wurden | Name der Entität Ergebnis des Vorgangs |
Die beiden folgenden Arten von Fehlern werden als Benutzerfehler klassifiziert:
- Clientseitige Fehler (in HTTP: Fehler vom Typ 400)
- Fehler, die bei der Verarbeitung von Nachrichten auftreten.
Nachrichtenmetriken
| Metrikname | Über Diagnoseeinstellungen exportierbar | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| Eingehende Nachrichten | Ja | Anzahl | Anzahl | Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum an Event Hubs gesendet wurden | Name der Entität |
| Ausgehende Nachrichten | Ja | Anzahl | Anzahl | Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum von Event Hubs empfangen wurden. | Name der Entität |
| Erfasste Nachrichten | Nein | Anzahl | Anzahl | Die Anzahl der erfassten Nachrichten. | Name der Entität |
| Eingehende Bytes | Ja | Byte | Anzahl | Eingehende Bytes für einen Event Hub in einem bestimmten Zeitraum. | Name der Entität |
| Ausgehende Bytes | Ja | Byte | Anzahl | Ausgehende Bytes für einen Event Hub in einem angegebenen Zeitraum. | Name der Entität |
| Size | Nein | Byte | Average | Größe eines Event Hub in Bytes. | Name der Entität |
Hinweis
- Bei diesen Werten handelt es sich um Zeitpunktwerte. Eingehende Nachrichten, die unmittelbar nach diesem Zeitpunkt verarbeitet wurden, werden in diesen Metriken möglicherweise nicht berücksichtigt.
- Die Metrik Eingehende Anforderungen umfasst alle Vorgänge auf der Daten- und Verwaltungsebene. Die Metrik Eingehende Nachrichten zeigt die Gesamtzahl der Ereignisse an, die an den Event Hub gesendet werden. Wenn Sie beispielsweise einen Batch von 100 Ereignissen an einen Event Hub senden, zählt dies als eine eingehende Anforderung und 100 eingehende Nachrichten.
Erfassen von Metriken
| Metrikname | Über Diagnoseeinstellungen exportierbar | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| Erfasste Nachrichten | Nein | Anzahl | Anzahl | Die Anzahl der erfassten Nachrichten. | Name der Entität |
| Erfasste Bytes | Nein | Byte | Anzahl | Erfasste Bytes für einen Event Hub | Name der Entität |
| Backlog erfassen | Nein | Anzahl | Anzahl | Erfasstes Backlog für einen Event Hub | Name der Entität |
Verbindungsmetriken
| Metrikname | Über Diagnoseeinstellungen exportierbar | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| Die aktiven Verbindungen. | Nein | Anzahl | Average | Die Anzahl der aktiven Verbindungen für einen Namespace sowie für eine Entität (Event Hub) im Namespace. Der Wert für diese Metrik ist ein Zeitpunktwert. Verbindungen, die unmittelbar nach diesem Zeitpunkt aktiv waren, werden in der Metrik möglicherweise nicht berücksichtigt. | Name der Entität |
| Geöffnete Verbindungen | Nein | Anzahl | Average | Die Anzahl der geöffneten Verbindungen | Name der Entität |
| Geschlossene Verbindungen | Nein | Anzahl | Average | Die Anzahl der geschlossenen Verbindungen | Name der Entität |
Fehlermetriken
| Metrikname | Über Diagnoseeinstellungen exportierbar | Einheit | Aggregationstyp | BESCHREIBUNG | Dimensionen |
|---|---|---|---|---|---|
| Serverfehler | Nein | Anzahl | Anzahl | Die Anzahl der aufgrund eines Fehlers nicht verarbeiteten Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum. | Name der Entität Ergebnis des Vorgangs |
| Benutzerfehler | Nein | Anzahl | Anzahl | Die Anzahl der aufgrund von Benutzerfehlern nicht verarbeiteten Anforderungen in einem bestimmten Zeitraum | Name der Entität Ergebnis des Vorgangs |
| Fehler aufgrund von Kontingentüberschreitung | Nein | Anzahl | Anzahl | Die Anzahl der Fehler, die durch das Überschreiten von Kontingenten in einem bestimmten Zeitraum verursacht werden. | Name der Entität Ergebnis des Vorgangs |
Hinweis
Von Logic Apps werden Empfänger mit epoch-Wert erstellt, und Empfänger können je nach Dienstauslastung zwischen Knoten verschoben werden. Während dieser Verschiebungen können Ausnahmen vom Typ ReceiverDisconnection auftreten. Sie werden aufseiten des Event Hubs-Diensts als Benutzerfehler gezählt. Von Logic Apps werden unter Umständen Fehler von Event Hubs-Clients erfasst, sodass Sie sie sich in Benutzerprotokollen ansehen können.
Metrikdimensionen
Azure Event Hubs unterstützt folgende Dimensionen für Metriken in Azure Monitor. Das Hinzufügen von Dimensionen zu Ihren Metriken ist optional. Wenn Sie keine Dimensionen hinzufügen, werden Metriken auf Namespaceebene angegeben.
| Dimensionsname | BESCHREIBUNG |
|---|---|
| Entitätsname | Name des Event Hubs. Mit der Metrik „Eingehende Anforderungen“ wird für die Dimension „Entitätsname“ zusätzlich zu Ihren Event Hubs der Wert „-NamespaceOnlyMetric-“ angegeben. Er stellt die Anforderungen dar, die auf Namespaceebene vorgenommen wurden. Beispiele hierfür sind eine Anforderung zum Auflisten aller Event Hubs im Namespace oder Anforderungen an Entitäten, bei denen bei der Authentifizierung oder Autorisierung ein Fehler aufgetreten ist. |
Ressourcenprotokolle
Azure Event Hubs verfügt jetzt über die Möglichkeit, Protokolle an eine von zwei Zieltabellen zu verteilen: Azure Diagnostic oder Ressourcenspezifische Tabellen in Log Analytics. Sie können den im Azure-Portal verfügbaren Umschalter verwenden, um Zieltabellen auszuwählen.
Event Hubs erfasst Diagnoseprotokolle für die folgenden Kategorien:
| Category | BESCHREIBUNG |
|---|---|
| Archivprotokolle | Erfasst Informationen zu Event Hubs Capture-Vorgängen, insbesondere Protokolle zu Erfassungsfehlern. |
| Betriebsprotokolle | Erfassen alle Verwaltungsvorgänge, die für den Azure Event Hubs-Namespace ausgeführt werden. Datenvorgänge werden aufgrund der großen Menge von Datenvorgängen, die für Azure Event Hubs durchgeführt werden, nicht erfasst. |
| Protokolle zur automatischen Skalierung | Erfasst autoinflate-Vorgänge, die in einem Event Hubs-Namespace ausgeführt werden. |
| Kafka-Koordinatorprotokolle | Erfassen Kafka-Koordinatorvorgänge, die sich auf Event Hubs beziehen. |
| Kafka-Benutzerfehlerprotokolle | Erfassen Informationen zu Kafka-APIs, die für Event Hubs aufgerufen werden. |
| Event Hubs virtual network connection event | Erfasst Informationen zu IP-Adressen und virtuellen Netzwerken, die Datenverkehr an Event Hubs senden. |
| Benutzerprotokolle für kundenseitig verwaltete Schlüssel | Erfassen Vorgänge in Verbindung mit Schlüsseln, die kundenseitig verwaltet werden. |
| Laufzeitüberwachungsprotokolle | Sie erfassen aggregierte Diagnoseinformationen für alle Zugriffsvorgänge der Datenebene (z. B. das Senden oder Empfangen von Ereignissen) in Event Hubs. |
| Anwendungsmetrikprotokolle | Sie erfassen die aggregierten Informationen zu bestimmten Metriken im Zusammenhang mit Vorgängen auf der Datenebene. |
Alle Protokolle werden im JavaScript Object Notation (JSON)-Format gespeichert. Jeder Eintrag enthält Zeichenfolgenfelder im nachfolgend beschriebenen Format.
Archivprotokollschema
JSON-Zeichenfolgen im Archivprotokoll enthalten Elemente, die in der folgenden Tabelle aufgeführt sind:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSArchiveLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
TaskName |
Beschreibung der fehlgeschlagenen Aufgabe | Ja | Ja |
ActivityId |
Interne ID zur Nachverfolgung | Ja | Ja |
trackingId |
Interne ID zur Nachverfolgung | Ja | Ja |
resourceId |
Azure Resource Manager-Ressourcen-ID | ja | Ja |
eventHub |
Vollständiger Event Hub-Name (mit Namespace-Name) | Ja | Nein |
EventhubName |
Name der Event Hub-Entität | Nein | Ja |
partitionId |
Die Partition des Ereignishubs, in die geschrieben wird | Ja | Ja |
archiveStep |
Mögliche Werte: ArchiveFlushWriter, DestinationInit | Ja | Ja |
startTime |
Fehlerstartzeit | Ja | Nein |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
failures |
Häufigkeit des Fehlers | Ja | Ja |
durationInSeconds |
Dauer des Fehlers | Ja | Ja |
message |
Fehlermeldung | Ja | Ja |
category |
Protokollkategorie | Ja | No |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. Event Hubs | No | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Es folgt ein Codebeispiel für eine JSON-Zeichenfolge im Archivierungsprotokoll:
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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Schema „Betriebsprotokolle“
JSON-Zeichenfolgen im Betriebsprotokoll enthalten Elemente, die in der folgenden Tabelle aufgeführt sind:
| Name | Beschreibung | Unterstützt in AzureDiagnostics | Unterstützt in AZMSOperationalLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
ActivityId |
Interne ID zur Nachverfolgung | Ja | Ja |
EventName |
Vorgangsname Eine Liste der Werte für dieses Element finden Sie unter den Ereignisnamen. | Ja | Ja |
resourceId |
Azure Resource Manager-Ressourcen-ID | Ja | Ja |
SubscriptionId |
Abonnement-ID | Ja | Ja |
EventTimeString |
Vorgangsdauer | Ja | Nein |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
EventProperties |
Eigenschaften für den Vorgang. Dieses Element stellt weitere Informationen zu dem Ereignis bereit, wie im folgenden Beispiel gezeigt. | Ja | Ja |
Status |
Vorgangsstatus Der Wert kann entweder Erfolgreich oder Fehler lauten. | Ja | Ja |
Caller |
Aufrufer des Vorgangs (Azure-Portal oder Verwaltungsclient) | Ja | Ja |
Category |
Protokollkategorie | Ja | No |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. Event Hubs | No | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Es folgt ein Codebeispiel für eine JSON-Zeichenfolge im Betriebsprotokoll:
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"
}
Ressourcenspezifischer Tabelleneintrag:
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"
}
Ereignisnamen
Der Ereignisname setzt sich aus Vorgangstyp und Ressourcentyp aus den folgenden Enumerationen zusammen. Beispiel: Create Queue, Retrieve Event Hub oder Delete Rule.
| Vorgangsart | Ressourcentyp |
|---|---|
| - Erstellen - Aktualisieren - Löschen - Abrufen - Unbekannt |
- Namespace - Warteschlange - Thema - Abonnement – Event Hubs - SharedAccessPolicy - UsageCredit - Regel - ConsumerGroup |
Schema der Protokolle für automatische Skalierung
Die JSON-Zeichenfolge im Protokoll für automatische Skalierung enthält Elemente, die in der folgenden Tabelle aufgeführt werden:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSAutoscaleLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
TrackingId |
Interne ID, die für Ablaufverfolgungszwecke verwendet wird. | Ja | Ja |
ResourceId |
Azure Resource Manager-Ressourcen-ID | Ja | Ja |
Message |
Informational message, which provides details about autoinflate action. Die Meldung enthält den vorherigen und den aktuellen Wert der Durchsatzeinheit für einen bestimmten Namespace und den Grund, warum die Vergrößerung der Durchsatzeinheit ausgelöst wurde. | Ja | Ja |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. Event Hubs | No | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Beispiel für ein Autoskalierungsereignis:
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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Schema der Kafka-Koordinatorprotokolle
Die JSON-Zeichenfolge im Kafka-Koordinatorprotokoll enthält Elemente, die in der folgenden Tabelle aufgeführt werden:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSKafkaCoordinatorLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
RequestId |
Anforderungs-ID, die zur Ablaufverfolgung verwendet wird | Ja | Ja |
ResourceId |
Azure Resource Manager-Ressourcen-ID | Ja | Ja |
Operation |
Name des Vorgangs, der während der Gruppenkoordination durchgeführt wurde | Ja | Ja |
ClientId |
Client-ID | Ja | Ja |
NamespaceName |
Namespacename | Ja | Ja |
SubscriptionId |
Azure-Abonnement-ID | Ja | Ja |
Message |
Informative Meldung oder Warnmeldung, die Details zu den Aktionen bereitstellt, die während der Gruppenkoordination ausgeführt wurden. | Ja | Ja |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. ServiceBus | No | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Beispiel
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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Schema der Kafka-Benutzerfehlerprotokolle
Die JSON-Zeichenfolge im Kafka-Benutzerfehlerprotokoll enthält Elemente, die in der folgenden Tabelle aufgeführt werden:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSKafkaUserErrorLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
TrackingId |
Nachverfolgungs-ID, die zur Ablaufverfolgung verwendet wird. | Ja | Ja |
NamespaceName |
Namespacename | Ja | Ja |
Eventhub |
Event Hub-Name | Ja | Ja |
PartitionId |
Partitions-ID | Ja | Ja |
GroupId |
Gruppen-ID | Ja | Ja |
ClientId |
Client-ID | Ja | Ja |
ResourceId |
Azure Resource Manager-Ressourcen-ID | Ja | Ja |
Message |
Informationsmeldung, die Details zu einem Fehler enthält. | Ja | Ja |
TimeGenerated (UTC) |
Zeitstempel für ausgeführten Vorgang | Nein | Ja |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. Event Hubs | No | Ja |
Type |
Typ der ausgegebenen Protokolle | NO | Ja |
Schema für Event Hubs-Verbindungsereignis mit virtuellem Netzwerk
Event Hubs Virtual Network (Virtual Network) Connection Event JSON enthält Elemente, die in der folgenden Tabelle aufgeführt sind:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSVNetConnectionevents (Ressourcenspezifische Tabelle) |
|---|---|---|---|
SubscriptionId |
Azure-Abonnement-ID | Ja | Ja |
NamespaceName |
Namespacename | Ja | Ja |
IPAddress |
IP-Adresse eines Clients, der eine Verbindung mit dem Event Hubs-Dienst herstellt. | Ja | Ja |
Action |
Aktion, die vom Event Hubs-Dienst beim Auswerten von Verbindungsanforderungen ausgeführt wird. Unterstützt werden die Aktionen zum Akzeptieren von Verbindungen und Ablehnen von Verbindungen. | Ja | Ja |
Reason |
Gibt einen Grund an, warum die Aktion durchgeführt wurde. | Ja | Nein |
Message |
Gibt einen Grund an, warum die Aktion durchgeführt wurde. | Nein | Ja |
Count |
Anzahl von Vorkommen für die angegebene Aktion. | Ja | Ja |
ResourceId |
Azure Resource Manager-Ressourcen-ID | Ja | Ja |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. ServiceBus | No | Ja |
Type |
AZMSVNetConnectionevents | Nein | Ja |
Protokolle virtueller Netzwerke werden nur dann generiert, wenn der Namespace Zugriff aus ausgewählten Netzwerken oder über spezifische IP-Adressen (IP-Filterregeln) erlaubt. Wenn Sie den Zugriff auf Ihren Namespace mit diesen Features nicht einschränken möchten und dennoch Protokolle virtueller Netzwerke erhalten möchten, um IP-Adressen von Clients zu verfolgen, die sich mit dem Namespace der Event Hubs verbinden, können Sie die folgende Umgehungslösung verwenden. Aktivieren Sie die IP-Filterung, und fügen Sie den gesamten adressierbaren IPv4-Bereich (128.0.0.0/1 - 0.0.0.0/1) und den IPv6-Bereich () hinzu.::/1 - 8000::/1 Die IP-Filterung von Event Hubs unterstützt keine IPv6-Adressbereiche. Möglicherweise werden private Endpunktadressen im IPv6-Format im Protokoll angezeigt.
Beispiel
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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Benutzerprotokollschema für kundenseitig verwaltete Schlüssel
Die JSON-Zeichenfolge im Benutzerprotokoll für kundenseitig verwaltete Schlüssel enthält Elemente, die in der folgenden Tabelle aufgeführt werden:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSCustomerManagedKeyUserLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
Category |
Typ der Kategorie für eine Meldung. Hierbei handelt es sich um einen der folgenden Werte: Fehler oder Info. Wenn beispielsweise der Schlüssel aus Ihrem Schlüsseltresor deaktiviert wird, dann handelt es sich hierbei um eine Informationskategorie. Wenn ein Schlüssel nicht entpackt werden kann, dann handelt es sich um einen Fehler. | Ja | Ja |
ResourceId |
Interne Ressourcen-ID, die die Azure-Abonnement-ID und den Namespacenamen umfasst. | Ja | Ja |
KeyVault |
Name der Key Vault-Ressource. | Ja | Ja |
Key |
Der Name des Key Vault-Schlüssels, der zum Verschlüsseln des Event Hubs-Namespace verwendet wird. | Ja | Ja |
Version |
Version des Key Vault-Schlüssels. | Ja | Ja |
Operation |
Der Vorgang, der für den Schlüssel in Ihrem Schlüsseltresor ausgeführt wird. Dazu zählen etwa das Deaktivieren/Aktvieren, das Packen und das Entpacken des Schlüssels. | Ja | Ja |
Code |
Der dem Vorgang zugeordnete Code. Beispiel: Der Fehlercode 404 bedeutet, dass der Schlüssel nicht gefunden wurde. | Ja | Ja |
Message |
Meldung, die Details zu einem Fehler oder einer Informationsmeldung enthält. | Ja | Ja |
Time Generated (UTC) |
Zeitstempel des Vorgangs | Nein | Ja |
Provider |
Name des Diensts, der die Protokolle aussendet, z. B. ServiceBus | No | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Nachfolgend finden Sie ein Beispiel für das Protokoll für einen kundenseitig verwalteten Schlüssel:
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": ""
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Im Folgenden finden Sie die allgemeinen Fehlercodes, nach denen Sie suchen müssen, wenn die BYOK-Verschlüsselung aktiviert ist.
| Aktion | Fehlercode | Resultierender Zustand der Daten |
|---|---|---|
| Widerrufen der Berechtigung zum Packen/Entpacken aus einem Schlüsseltresor | 403 | Inaccessible |
| Entfernen der Rollenmitgliedschaft "Microsoft Entra ID" aus einem Microsoft Entra-Prinzipal, der die Berechtigung "wrap/unwrap" erteilt hat | 403 | Inaccessible |
| Löschen eines Verschlüsselungsschlüssels aus dem Schlüsseltresor | 404 | Inaccessible |
| Löschen des Schlüsseltresors | 404 | Zugriff nicht möglich (unter der Annahme, dass vorläufiges Löschen aktiviert ist, da dies eine erforderliche Einstellung ist) |
| Ändern des Ablaufzeitraums für den Verschlüsselungsschlüssel, sodass er bereits abgelaufen ist | 403 | Inaccessible |
| Ändern des Werts für NBF (not before, nicht vor), sodass der Schlüsselverschlüsselungsschlüssel nicht aktiv ist | 403 | Inaccessible |
| Auswählen der Option Allow MSFT Services (MSFT-Dienste zulassen) für die Firewall des Schlüsseltresors oder anderweitiges Blockieren des Netzwerkzugriffs auf den Schlüsseltresor, der den Verschlüsselungsschlüssel enthält | 403 | Inaccessible |
| Verschieben des Schlüsseltresors in einen anderen Mandanten | 404 | Inaccessible |
| Zeitweilig auftretendes Netzwerkproblem oder DNS-/AAD-/MSI-Ausfall | Zugriff mithilfe des zwischengespeicherten Datenverschlüsselungsschlüssels |
Laufzeit-Überwachungsprotokolle
Laufzeitüberwachungsprotokolle erfassen aggregierte Diagnoseinformationen für alle Zugriffsvorgänge der Datenebene (z. B. das Senden oder Empfangen von Ereignissen) in Event Hubs.
Hinweis
Laufzeitüberwachungsprotokolle sind derzeit nur in den Tarifen Premium und Dedicated verfügbar.
Laufzeit-Überwachungsprotokolle enthalten die in der folgenden Tabelle aufgeführten Elemente:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in Ressourcenspezifischer Tabelle |
|---|---|---|---|
ActivityId |
Eine zufällig generierte UUID, die die Eindeutigkeit der Überwachungsaktivität gewährleistet. | Ja | Ja |
ActivityName |
Name des Laufzeitvorgangs. | Ja | Ja |
ResourceId |
Eine mit der Aktivität verknüpfte Ressource. | Ja | Ja |
Timestamp |
Aggregationszeit. | Ja | Nein |
TimeGenerated [UTC] |
Ausführungszeitpunkt (in UTC) | Nein | Ja |
Status |
Status der Aktivität (Erfolg oder Fehler). | Ja | Ja |
Protocol |
Dem Vorgang zugeordneter Protokolltyp. | Ja | Ja |
AuthType |
Authentifizierungstyp (Azure Active Directory SAS-Richtlinie). | Ja | Ja |
AuthKey |
Azure Active Directory Anwendungs-ID oder den Namen der SAS-Richtlinie, der für die Authentifizierung bei einer Ressource verwendet wird. | Ja | Ja |
NetworkType |
Typ des Netzwerkzugriffs: Public oder Private. |
Ja | Ja |
ClientIP |
IP-Adresse der Clientanwendung. | Ja | Ja |
Count |
Gesamtzahl der Vorgänge, die während des aggregierten Zeitraums von 1 Minute ausgeführt wurden. | Ja | Ja |
Properties |
Metadaten, die für den Datenebenenvorgang spezifisch sind. | Ja | Ja |
Category |
Protokollkategorie | Ja | NO |
Provider |
Name des Dienstes, der die Protokolle aussendet, z. B. Event Hubs | Nein | Ja |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Hier sehen Sie ein Beispiel für einen Laufzeitüberwachungsprotokolleintrag:
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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Anwendungsmetrikprotokolle
Anwendungsmetrikprotokolle erfassen die aggregierten Informationen zu bestimmten Metriken im Zusammenhang mit Vorgängen auf der Datenebene. Die erfassten Informationen umfassen die folgenden Laufzeitmetriken.
Hinweis
Anwendungsmetrikprotokolle sind derzeit nur in den Tarifen Premium und Dedicated verfügbar.
| Name | BESCHREIBUNG |
|---|---|
ConsumerLag |
Gibt den Abstand zwischen Consumern und Producern an. |
NamespaceActiveConnections |
Details zu aktiven Verbindungen, die von einem Client mit dem Event Hub eingerichtet wurden. |
GetRuntimeInfo |
Ruft Laufzeitinformationen aus Event Hubs ab. |
GetPartitionRuntimeInfo |
Ruft die ungefähren Laufzeitinformationen für eine logische Partition eines Event Hubs ab. |
IncomingMessages |
Details zur Anzahl der Nachrichten, die in Event Hubs veröffentlicht wurden. |
IncomingBytes |
Details zum Publisherdurchsatz an Event Hubs. |
OutgoinMessages |
Details zur Anzahl der von Event Hubs verarbeiteten Nachrichten. |
OutgoingBytes |
Details zum Consumerdurchsatz aus Event Hubs. |
OffsetCommit |
Anzahl der Offsetcommitaufrufe an den Event Hub |
OffsetFetch |
Anzahl der Offsetfetchaufrufe an den Event Hub |
Diagnosefehlerprotokolle
Diagnosefehlerprotokolle erfassen Fehlermeldungen für alle clientseitigen, Drosselungs- und Kontingentüberschreitungsfehler. Sie bieten detaillierte Diagnose zur Fehleridentifikation.
Diagnosefehlerprotokolle enthalten Elemente, die in der folgenden Tabelle aufgeführt sind:
| Name | Beschreibung | Unterstützt in Azure Diagnostics | Unterstützt in AZMSDiagnosticErrorLogs (Ressourcenspezifische Tabelle) |
|---|---|---|---|
ActivityId |
Eine zufällig generierte UUID, die die Eindeutigkeit der Überwachungsaktivität gewährleistet. | Ja | Ja |
ActivityName |
Name des Vorgangs | Ja | Ja |
NamespaceName |
Name des Namespace | Ja | ja |
EntityType |
Entitätstyp | Ja | Ja |
EntityName |
Name der Entität | Ja | Ja |
OperationResult |
Typ des Fehlers im Vorgang (Clientfehler oder Serverbusy oder Kontingentexceed) | Ja | Ja |
ErrorCount |
Anzahl identischer Fehler während des Aggregationszeitraums von 1 Minute. | Ja | Ja |
ErrorMessage |
Detaillierte Fehlermeldung | Ja | Ja |
ResourceProvider |
Name des Diensts, der die Protokolle aussendet. Mögliche Werte: Microsoft.Eventhub und Microsoft.Servicebus | Ja | Ja |
Time Generated (UTC) |
Vorgangsdauer | No | Ja |
EventTimestamp |
Vorgangsdauer | Ja | No |
Category |
Protokollkategorie | Ja | No |
Type |
Typ der ausgegebenen Protokolle | Nein | Ja |
Hier ist ein Beispiel für den Eintrag des Diagnosefehlerprotokolls:
{
"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"
}
Ressourcenspezifischer Tabelleneintrag:
{
"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"
}
Tabellen in Azure Monitor-Protokollen
Azure Event Hubs verwendet Kusto-Tabellen aus Azure Monitor-Protokollen. Sie können diese Tabellen mit Log Analytics abfragen. Eine Liste der Kusto-Tabellen, die der Dienst verwendet, finden Sie unter Referenz zur Azure Monitor-Protokolltabelle.
Sie können unsere Beispielabfragen anzeigen, um mit verschiedenen Protokollkategorien zu beginnen.
Wichtig
Dimensionen werden nicht in einen Log Analytics-Arbeitsbereich exportiert.
Nächste Schritte
- Weitere Informationen zum Überwachen von Azure Event Hubs finden Sie unter Überwachen von Azure Event Hubs.
- Ausführliche Informationen zur Überwachung von Azure-Ressourcen finden Sie unter Überwachen von Azure-Ressourcen mit Azure Monitor.