Azure Event Hubs–Überwachungsdatenverweis

Dieser Artikel enthält alle Referenzinformationen zur Überwachung dieses Dienstes.

Ausführliche Informationen zu den Daten, die Sie für Event Hubs sammeln können, und deren Verwendung finden Sie unter "Überwachen von Azure Event Hubs ".

Azure Event Hubs protokolliert Überwachungsdaten mit Azure Monitor, einem Azure-Dienst zur vollständigen Stapelüberwachung. Azure Monitor bietet einen vollständigen Satz von Funktionen zum Überwachen Ihrer Azure-Ressourcen. Mit Azure Monitor können außerdem Ressourcen in anderen Clouds und lokal überwacht werden.

Azure Event Hubs sammelt dieselben Arten von Überwachungsdaten wie andere Azure-Ressourcen, die in Überwachungsdaten von Azure-Ressourcen beschrieben werden.

Metriken

In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken für diesen Dienst aufgeführt. Diese Metriken sind auch Teil der globalen Liste aller in Azure Monitor unterstützten Plattformmetriken.

Informationen zur Aufbewahrung von Metriken finden Sie unter Überblick über Metriken in Azure Monitor.

Unterstützte Metriken für Microsoft.EventHub/Cluster

In der folgenden Tabelle sind die Metriken aufgeführt, die für den Ressourcentyp "Microsoft.EventHub/clusters" verfügbar sind.

• Möglicherweise sind nicht alle Spalten in jeder Tabelle vorhanden.
• Einige Spalten können über den Anzeigebereich der Seite hinausgehen. Wählen Sie Tabelle erweitern aus, um alle verfügbaren Spalten anzuzeigen.

Tabellenüberschriften

• Kategorie – Die Metrikgruppe oder -klassifizierung.
• Metrik – Der Anzeigename der Metrik, wie er im Azure-Portal angezeigt wird.
• Name in REST-API: Der Metrikname im REST-API
• Einheit – Abrechnungseinheit.
• Aggregation – Der Standard-Aggregationstyp. Gültige Werte: Mittelwert (Avg), Minimum (Min), Maximum (Max), Gesamt (Sum), Anzahl
• Dimensionen - Für die Metrik verfügbare Dimensionen.
• Aggregationsintervall - Intervalle, in denen die Metrik gesampelt wird. PT1M bedeutet zum Beispiel, dass die Metrik jede Minute abgerufen wird, PT30M alle 30 Minuten, PT1H jede Stunde usw.
• DS-Export – Gibt an, ob die Metrik über Diagnose-Einstellungen in Azure Monitor-Protokolle exportiert werden kann. Informationen zum Exportieren von Metriken finden Sie unter Diagnoseeinstellungen in Azure Monitor erstellen.

Metrik	Name in der REST-API	Einheit	Aggregation	Dimensionen	Aggregationsintervalle	DS-Export
ActiveConnections Aktive Verbindungen gesamt für Microsoft.EventHub.	ActiveConnections	Anzahl	Average	<none>	PT1M	No
Verfügbarer Arbeitsspeicher Verfügbarer Arbeitsspeicher für den Event Hub-Cluster als Prozentsatz des Gesamtarbeitsspeichers.	AvailableMemory	Percent	Maximum	Role	PT1M	No
Erfassen des Backlogs. Erfassen des Backlogs für Microsoft.EventHub.	CaptureBacklog	Anzahl	Gesamt	<none>	PT1M	No
Erfasste Bytes. Erfasste Bytes für Microsoft.EventHub.	CapturedBytes	Byte	Gesamt	<none>	PT1M	No
Erfasste Nachrichten. Erfasste Nachrichten für Microsoft.EventHub.	CapturedMessages	Anzahl	Gesamt	<none>	PT1M	No
Verbindungen geschlossen. Geschlossene Verbindungen für Microsoft.EventHub.	ConnectionsClosed	Anzahl	Average	<none>	PT1M	No
Verbindungen geöffnet. Geöffnete Verbindungen für Microsoft.EventHub.	ConnectionsOpened	Anzahl	Average	<none>	PT1M	No
CPU CPU-Auslastung für den Event Hub-Cluster in Prozent	CPU	Percent	Maximum	Role	PT1M	No
Eingehende Bytes. Eingehende Bytes für Microsoft.EventHub.	IncomingBytes	Byte	Gesamt	<none>	PT1M	Ja
Eingehende Nachrichten Eingehende Nachrichten für Microsoft.EventHub.	IncomingMessages	Anzahl	Gesamt	<none>	PT1M	Ja
Eingehende Anforderungen Eingehende Anforderungen für Microsoft.EventHub.	IncomingRequests	Anzahl	Gesamt	<none>	PT1M	Ja
Ausgehende Bytes. Ausgehende Bytes für Microsoft.EventHub.	OutgoingBytes	Byte	Gesamt	<none>	PT1M	Ja
Ausgehende Nachrichten Ausgehende Nachrichten für Microsoft.EventHub.	OutgoingMessages	Anzahl	Gesamt	<none>	PT1M	Ja
Kontingent überschrittene Fehler. Fehler aufgrund von Kontingentüberschreitung für Microsoft.EventHub.	QuotaExceededErrors	Anzahl	Gesamt	OperationResult	PT1M	No
Serverfehler. Serverfehler für Microsoft.EventHub.	ServerErrors	Anzahl	Gesamt	OperationResult	PT1M	No
Größe Größe eines EventHub in Bytes.	Size	Byte	Mittelwert, Minimum, Maximum	Role	PT1M	No
Erfolgreiche Anforderungen Erfolgreiche Anforderungen für Microsoft.EventHub.	SuccessfulRequests	Anzahl	Gesamt	OperationResult	PT1M	No
Eingeschränkte Anforderungen. Gedrosselte Anforderungen für Microsoft.EventHub.	ThrottledRequests	Anzahl	Gesamt	OperationResult	PT1M	No
Benutzerfehler. Benutzerfehler für Microsoft.EventHub.	UserErrors	Anzahl	Gesamt	OperationResult	PT1M	No

Unterstützte Metriken für Microsoft.EventHub/Namespaces

In der folgenden Tabelle sind die Metriken aufgeführt, die für den Ressourcentyp "Microsoft.EventHub/Namespaces" verfügbar sind.

• Möglicherweise sind nicht alle Spalten in jeder Tabelle vorhanden.
• Einige Spalten können über den Anzeigebereich der Seite hinausgehen. Wählen Sie Tabelle erweitern aus, um alle verfügbaren Spalten anzuzeigen.

Tabellenüberschriften

• Kategorie – Die Metrikgruppe oder -klassifizierung.
• Metrik – Der Anzeigename der Metrik, wie er im Azure-Portal angezeigt wird.
• Name in REST-API: Der Metrikname im REST-API
• Einheit – Abrechnungseinheit.
• Aggregation – Der Standard-Aggregationstyp. Gültige Werte: Mittelwert (Avg), Minimum (Min), Maximum (Max), Gesamt (Sum), Anzahl
• Dimensionen - Für die Metrik verfügbare Dimensionen.
• Aggregationsintervall - Intervalle, in denen die Metrik gesampelt wird. PT1M bedeutet zum Beispiel, dass die Metrik jede Minute abgerufen wird, PT30M alle 30 Minuten, PT1H jede Stunde usw.
• DS-Export – Gibt an, ob die Metrik über Diagnose-Einstellungen in Azure Monitor-Protokolle exportiert werden kann. Informationen zum Exportieren von Metriken finden Sie unter Diagnoseeinstellungen in Azure Monitor erstellen.

Metrik	Name in der REST-API	Einheit	Aggregation	Dimensionen	Aggregationsintervalle	DS-Export
ActiveConnections Aktive Verbindungen gesamt für Microsoft.EventHub.	ActiveConnections	Anzahl	Maximum, Minimum, Average	<none>	PT1M	No
Erfassen des Backlogs. Erfassen des Backlogs für Microsoft.EventHub.	CaptureBacklog	Anzahl	Gesamt	EntityName	PT1M	No
Erfasste Bytes. Erfasste Bytes für Microsoft.EventHub.	CapturedBytes	Byte	Gesamt	EntityName	PT1M	No
Erfasste Nachrichten. Erfasste Nachrichten für Microsoft.EventHub.	CapturedMessages	Anzahl	Gesamt	EntityName	PT1M	No
Verbindungen geschlossen. Geschlossene Verbindungen für Microsoft.EventHub.	ConnectionsClosed	Anzahl	Maximum	EntityName	PT1M	No
Verbindungen geöffnet. Geöffnete Verbindungen für Microsoft.EventHub.	ConnectionsOpened	Anzahl	Maximum	EntityName	PT1M	No
Archivieren von Backlognachrichten (veraltet) Event Hub-Archivnachrichten im Backlog für einen Namespace (veraltet)	EHABL	Anzahl	Gesamt	<none>	PT1M	Ja
Archivnachrichtendurchsatz (veraltet) Event Hub-Durchsatz archivierter Nachrichten in einem Namespace (veraltet)	EHAMBS	Byte	Gesamt	<none>	PT1M	Ja
Archivieren von Nachrichten (veraltet) Event Hub-Archivnachrichten in einem Namespace (veraltet)	EHAMSGS	Anzahl	Gesamt	<none>	PT1M	Ja
Eingehende Bytes (veraltet) Event Hub-Durchsatz eingehender Nachrichten für einen Namespace (veraltet)	EHINBYTES	Byte	Gesamt	<none>	PT1M	Ja
Eingehende Bytes (veraltet) (veraltet) Event Hub-Durchsatz eingehender Nachrichten für einen Namespace Diese Metrik ist veraltet. Verwenden Sie stattdessen die Metrik für eingehende Bytes. (veraltet)	EHINMBS	Byte	Gesamt	<none>	PT1M	Ja
Eingehende Nachrichten (veraltet) Gesamtzahl von eingehenden Nachrichten für einen Namespace (veraltet)	EHINMSGS	Anzahl	Gesamt	<none>	PT1M	Ja
Ausgehende Bytes (veraltet) Event Hub-Durchsatz ausgehender Nachrichten für einen Namespace (veraltet)	EHOUTBYTES	Byte	Gesamt	<none>	PT1M	Ja
Ausgehende Bytes (veraltet) (veraltet) Event Hub-Durchsatz ausgehender Nachrichten für einen Namespace Diese Metrik ist veraltet. Verwenden Sie stattdessen die Metrik für ausgehende Bytes. (veraltet)	EHOUTMBS	Byte	Gesamt	<none>	PT1M	Ja
Ausgehende Nachrichten (veraltet) Gesamtzahl von ausgehenden Nachrichten für einen Namespace (veraltet)	EHOUTMSGS	Anzahl	Gesamt	<none>	PT1M	Ja
Fehlgeschlagene Anforderungen (veraltet) Gesamtzahl fehlerhafter Anforderungen für einen Namespace (veraltet)	FAILREQ	Anzahl	Gesamt	<none>	PT1M	Ja
Eingehende Bytes. Eingehende Bytes für Microsoft.EventHub.	IncomingBytes	Byte	Gesamt	EntityName	PT1M	Ja
Eingehende Nachrichten Eingehende Nachrichten für Microsoft.EventHub.	IncomingMessages	Anzahl	Gesamt	EntityName	PT1M	Ja
Eingehende Anforderungen Eingehende Anforderungen für Microsoft.EventHub.	IncomingRequests	Anzahl	Gesamt	EntityName	PT1M	Ja
Eingehende Nachrichten (veraltet) (veraltet) Gesamtzahl von eingehenden Nachrichten für einen Namespace Diese Metrik ist veraltet. Verwenden Sie stattdessen die Metrik für eingehende Nachrichten. (veraltet)	INMSGS	Anzahl	Gesamt	<none>	PT1M	Ja
Eingehende Anforderungen (veraltet) Gesamtzahl eingehender Sendeanforderungen für einen Namespace (veraltet)	INREQS	Anzahl	Gesamt	<none>	PT1M	Ja
Interne Serverfehler (veraltet) Gesamtzahl interner Serverfehler für einen Namespace (veraltet)	INTERR	Anzahl	Gesamt	<none>	PT1M	Ja
Andere Fehler (veraltet) Gesamtzahl fehlerhafter Anforderungen für einen Namespace (veraltet)	MISCERR	Anzahl	Gesamt	<none>	PT1M	Ja
CPU CPU-Auslastungsmetrik für Premium-SKU-Namespaces.	NamespaceCpuUsage	Percent	Maximum, Minimum, Average	Replica	PT1M	No
Speicherauslastung Speicherauslastungsmetrik für Premium-SKU-Namespaces.	NamespaceMemoryUsage	Percent	Maximum, Minimum, Average	Replica	PT1M	No
Ausgehende Bytes. Ausgehende Bytes für Microsoft.EventHub.	OutgoingBytes	Byte	Gesamt	EntityName	PT1M	Ja
Ausgehende Nachrichten Ausgehende Nachrichten für Microsoft.EventHub.	OutgoingMessages	Anzahl	Gesamt	EntityName	PT1M	Ja
Ausgehende Nachrichten (veraltet) (veraltet) Gesamtzahl von ausgehenden Nachrichten für einen Namespace Diese Metrik ist veraltet. Verwenden Sie stattdessen die Metrik für ausgehende Nachrichten. (veraltet)	OUTMSGS	Anzahl	Gesamt	<none>	PT1M	Ja
Kontingent überschrittene Fehler. Fehler aufgrund von Kontingentüberschreitung für Microsoft.EventHub.	QuotaExceededErrors	Anzahl	Gesamt	EntityName, OperationResult	PT1M	No
ReplicationLagCount Replikationsverzögerung nach Nachrichtenanzahl	ReplicationLagCount	Anzahl	Maximum, Minimum, Average	EntityName	PT1M	No
ReplicationLagDuration Replikationsverzögerung nach Zeitdauer	ReplicationLagDuration	Sekunden	Maximum, Minimum, Average	EntityName	PT1M	Ja
Serverfehler. Serverfehler für Microsoft.EventHub.	ServerErrors	Anzahl	Gesamt	EntityName, OperationResult	PT1M	No
Größe Größe eines EventHub in Bytes.	Size	Byte	Mittelwert, Minimum, Maximum	EntityName	PT1M	No
Erfolgreiche Anforderungen Erfolgreiche Anforderungen für Microsoft.EventHub.	SuccessfulRequests	Anzahl	Gesamt	EntityName, OperationResult	PT1M	No
Erfolgreiche Anforderungen (veraltet) Gesamtzahl erfolgreicher Anforderungen für einen Namespace (veraltet)	SUCCREQ	Anzahl	Gesamt	<none>	PT1M	Ja
Server-Beschäftigt-Fehler (veraltet) Gesamtzahl der Fehler durch ausgelasteten Server für einen Namespace (veraltet)	SVRBSY	Anzahl	Gesamt	<none>	PT1M	Ja
Eingeschränkte Anforderungen. Gedrosselte Anforderungen für Microsoft.EventHub.	ThrottledRequests	Anzahl	Gesamt	EntityName, OperationResult	PT1M	No
Benutzerfehler. Benutzerfehler für Microsoft.EventHub.	UserErrors	Anzahl	Gesamt	EntityName, OperationResult	PT1M	No

In den folgenden Tabellen sind alle automatisch gesammelten Plattformmetriken aufgeführt, die für Azure Event Hubs gesammelt werden. Der Ressourcenanbieter für diese Metriken lautet Microsoft.EventHub/clusters oder Microsoft.EventHub/namespaces.

Anforderungsmetriken zählen die Anzahl der Daten- und Verwaltungsvorgängeanforderungen. Diese Tabelle enthält weitere Informationen zu Werten aus den vorherigen Tabellen.

Metrikname	BESCHREIBUNG
Eingehende Anforderungen	Die Anzahl von Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum. Diese Metrik umfasst alle Vorgänge auf der Daten- und Verwaltungsebene.
Erfolgreiche Anforderungen	Die Anzahl erfolgreicher Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum.
Gedrosselte Anforderungen	Die Anzahl der Anforderungen, die aufgrund eines überschrittenen Verbrauchs gedrosselt wurden

Diese Tabelle enthält weitere Informationen zu Nachrichtenmetriken aus den vorherigen Tabellen.

Metrikname	BESCHREIBUNG
Eingehende Nachrichten	Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum an Event Hubs gesendet wurden
Ausgehende Nachrichten	Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum von Event Hubs empfangen wurden.
Erfasste Nachrichten	Die Anzahl der erfassten Nachrichten.
Eingehende Bytes	Eingehende Bytes für einen Event Hub in einem bestimmten Zeitraum.
Ausgehende Bytes	Ausgehende Bytes für einen Event Hub in einem angegebenen Zeitraum.
Size	Größe eines Event Hub in Bytes.

Hinweis

• Bei diesen Werten handelt es sich um Zeitpunktwerte. Eingehende Nachrichten, die unmittelbar nach diesem Zeitpunkt verbraucht werden, werden möglicherweise nicht in diesen Metriken widergespiegelt.
• Die Metrik "Eingehende Anforderungen" enthält alle Daten- und Verwaltungsebenenvorgänge. Die Metrik "Eingehende Nachrichten" gibt Ihnen die Gesamtanzahl der Ereignisse, die an den Event Hub gesendet werden. Wenn Sie beispielsweise einen Batch von 100 Ereignissen an einen Event Hub senden, zählt er als 1 eingehende Anforderung und 100 eingehende Nachrichten.

Diese Tabelle enthält weitere Informationen zur Erfassung von Metriken aus den vorherigen Tabellen.

Metrikname	Beschreibung
Erfasste Nachrichten	Die Anzahl der erfassten Nachrichten.
Erfasste Bytes	Erfasste Bytes für einen Event Hub.
Backlog erfassen	Erfassen sie den Backlog für einen Event Hub.

Diese Tabelle enthält weitere Informationen zu Verbindungsmetriken aus den vorherigen Tabellen.

Metrikname	BESCHREIBUNG
Die aktiven Verbindungen.	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.
Geöffnete Verbindungen	Die Anzahl der geöffneten Verbindungen
Geschlossene Verbindungen	Die Anzahl der geschlossenen Verbindungen

Diese Tabelle enthält weitere Informationen zu Fehlermetriken aus den vorherigen Tabellen.

Metrikname	Beschreibung
Serverfehler	Die Anzahl der aufgrund eines Fehlers nicht verarbeiteten Anforderungen an den Event Hubs-Dienst in einem bestimmten Zeitraum.
Benutzerfehler	Die Anzahl der aufgrund von Benutzerfehlern nicht verarbeiteten Anforderungen in einem bestimmten Zeitraum
Fehler aufgrund von Kontingentüberschreitung	Die Anzahl der Fehler, die durch das Überschreiten von Kontingenten in einem bestimmten Zeitraum verursacht werden.

Die beiden folgenden Arten von Fehlern werden als Benutzerfehler klassifiziert:

1. Clientseitige Fehler (in HTTP: Fehler vom Typ 400)
2. Fehler, die bei der Verarbeitung von Nachrichten auftreten.

Hinweis

Logik-Apps erstellen Epochenempfänger. Empfänger können je nach Dienstladevorgang von einem Knoten in einen anderen verschoben werden. Während dieser Verschiebungen ReceiverDisconnection können Ausnahmen auftreten. Sie werden aufseiten des Event Hubs-Diensts als Benutzerfehler gezählt. Logik-Apps können Fehler von Event Hubs-Clients sammeln, sodass Sie sie in Benutzerprotokollen anzeigen können.

Metrikdimensionen

Informationen darüber, was metrische Dimensionen sind, finden Sie unter Mehrdimensionale Metriken.

Dieser Dienst weist die folgenden Dimensionen auf, die seinen Metriken zugeordnet sind.

Dimensionsname	Beschreibung
EntityName	Name des Event Hubs. Mit der Metrik "Eingehende Anforderungen" weist die Entitätsnamedimension zusätzlich zu allen Ereignishubs einen Wert -NamespaceOnlyMetric- auf. 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.
OperationResult	Entweder gibt success den entsprechenden Fehlerstatus an, z serverbusy. B. oder clienterror quotaexceeded.

Das Hinzufügen von Dimensionen zu Ihren Metriken ist optional. Wenn Sie keine Dimensionen hinzufügen, werden Metriken auf Namespaceebene angegeben.

Hinweis

Wenn Sie Metriken in einer Diagnoseeinstellung aktivieren, werden Dimensionsinformationen derzeit nicht als Teil der Informationen einbezogen, die an ein Speicherkonto, einen Event Hub oder eine Protokollanalyse gesendet werden.

Ressourcenprotokolle

In diesem Abschnitt werden die Ressourcenprotokolltypen aufgeführt, die für diesen Service erfasst werden können. Der Abschnitt wird aus der Liste aller in Azure Monitor unterstützten Kategorietypen für Ressourcenprotokolle gezogen.

Unterstützte Ressourcenprotokolle für Microsoft.EventHub/Namespaces

Kategorie	Anzeigename der Kategorie	Protokolltabelle	Unterstützt grundlegenden Protokollplan	Unterstützt die Erfassungszeittransformation	Beispielabfragen	Exportkosten
ApplicationMetricsLogs	Anwendungsmetrikprotokolle	AZMSApplicationMetricLogs Erfasst Anwendungsmetriken (eingehende/ausgehende, erfolgreiche/fehlgeschlagene usw.) für Azure Event Hubs und Azure Service Bus.	Ja	Keine		Ja
ArchiveLogs	Archivprotokolle	AZMSArchiveLogs Erfasst Informationen zu Ereignishubs-Erfassungsvorgängen, insbesondere Protokollen im Zusammenhang mit der Erfassung von Fehlern.	Ja	Nr.		No
AutoScaleLogs	Protokolle zur automatischen Skalierung	AZMSAutoscaleLogs Erfassen automatische Vergrößerungsvorgänge, die für einen Event Hubs-Namespace ausgeführt wurden.	Ja	Nr.		No
CustomerManagedKeyUserLogs	Protokolle für kundenseitig verwalteten Schlüssel		No	Nr.		No
DataDRLogs	DataDR-Protokolle		No	Nein		Ja
DiagnosticErrorLogs	Diagnose-Fehlerprotokolle	AZMSDiagnosticErrorLogs Erfasst aggregierte Diagnoseinformationen wie Clientfehler, Server-Beschäftigt-Fehler und Kontingent überschrittene Fehler für verschiedene Datenebenenzugriffsvorgänge (z. B. Senden oder Empfangen von Nachrichten) in Azure Event Hubs und Azure Service Bus.	Ja	No	Abfragen	Ja
EventHubVNetConnectionEvent	VNet/IP-Filterung-Verbindungsprotokolle	AZMSVnetConnectionEvents Erfasst alle protokolle für virtuelle Netzwerke und IP-Filterprotokolle für Azure Event Hubs und Azure Service Bus. Diese werden nur ausgegeben, wenn der Namespace den Zugriff von ausgewählten Netzwerken oder von einer bestimmten IP-Adresse (IP-Filterregeln) zulässt.	Ja	No	Abfragen	No
KafkaCoordinatorLogs	Kafka-Koordinatorprotokolle	AZMSKafkaCoordinatorLogs Erfasst kafka coordinator operations related to Event Hubs.	Ja	Nr.		No
KafkaUserErrorLogs	Kafka-Benutzerfehlerprotokolle	AZMSKafkaUserErrorLogs Erfasst Informationen zu kafka-APIs, die für Event Hubs aufgerufen werden.	Ja	Nr.		No
OperationalLogs	Betriebsprotokolle	AZMSOperationalLogs Erfasst alle Verwaltungsvorgänge, die im Azure Event Hubs/Azure Service Bus-Namespace und seinen Entitäten ausgeführt werden.	Ja	No	Abfragen	No
RuntimeAuditLogs	Laufzeitüberwachungsprotokolle	AZMSRunTimeAuditLogs Erfasst aggregierte Diagnoseinformationen für verschiedene Datenebenenzugriffsvorgänge (z. B. Senden oder Empfangen von Nachrichten) in Azure Event Hubs und Azure Service Bus. Laufzeitüberwachungsprotokolle sind derzeit nur in Premium-Stufe verfügbar.	Ja	No	Abfragen	Ja

Tabellen in Azure Monitor-Protokollen

Dieser Abschnitt bezieht sich die für diesen Service relevanten Azure-Monitor-Protokolltabellen, die für die Abfrage durch Protokollanalyse mit Kusto-Abfragen zur Verfügung stehen. Diese Tabellen enthalten Ressourcenprotokolldaten und möglicherweise mehr, je nachdem, was erfasst und an sie weitergeleitet wird.

Event Hubs Microsoft.EventHub/namespaces

• AzureActivity
• AzureMetrics
• AzureDiagnostics
• AZMSApplicationMetricLogs
• AZMSOperationalLogs
• AZMSRunTimeAuditLogs
• AZMSDiagnosticErrorLogs
• AZMSVnetConnectionEvents
• AZMSArchiveLogs
• AZMSAutoscaleLogs
• AZMSKafkaCoordinatorLogs
• AZMSKafkaUserErrorLogs
• AZMSCustomerManagedKeyUserLogs

Event Hubs-Ressourcenprotokolle

Azure Event Hubs bietet jetzt die Möglichkeit, Protokolle an eine der beiden 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.

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.

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 (Microsoft Entra ID oder SAS-Richtlinie).	Ja	Ja
AuthKey	Microsoft Entra ID-Anwendungs-ID oder SAS-Richtlinienname, 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 Diensts, der die Protokolle aussendet, z. B. EventHubs	No	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.
OutgoingMessages	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

Diagnose-Fehlerprotokolle

Diagnosefehlerprotokolle erfassen Fehlermeldungen für alle clientseitigen, Drosselungs- und Kontingentüberschreitungsfehler. Sie liefern detaillierte Diagnosen 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 in Operation (clienterror oder quotaexceededserverbusy )	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"
 }

Aktivitätsprotokoll

In der verknüpften Tabelle sind die Vorgänge aufgeführt, die im Aktivitätsprotokoll für diesen Dienst aufgezeichnet werden können. Diese Operationen sind eine Teilmenge aller möglichen Ressourcenanbietervorgänge im Aktivitätsprotokoll.

Weitere Informationen zum Schema von Aktivitätsprotokolleinträgen finden Sie unter Ereignisschema des Azure-Aktivitätsprotokolls.

• Microsoft.EventHub-Ressourcenanbietervorgänge

Zugehöriger Inhalt

• Eine Beschreibung der Überwachung von Event Hubs finden Sie unter Überwachen von Azure Event Hubs.
• Weitere Informationen zur Überwachung von Azure-Ressourcen finden Sie unter Überwachen von Azure-Ressourcen mit Azure Monitor.