Freigeben über


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 (Summe) <none> PT1M No
Erfasste Bytes.

Erfasste Bytes für Microsoft.EventHub.
CapturedBytes Byte Gesamt (Summe) <none> PT1M No
Erfasste Nachrichten.

Erfasste Nachrichten für Microsoft.EventHub.
CapturedMessages Anzahl Gesamt (Summe) <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 (Summe) <none> PT1M Ja
Eingehende Nachrichten

Eingehende Nachrichten für Microsoft.EventHub.
IncomingMessages Anzahl Gesamt (Summe) <none> PT1M Ja
Eingehende Anforderungen

Eingehende Anforderungen für Microsoft.EventHub.
IncomingRequests Anzahl Gesamt (Summe) <none> PT1M Ja
Ausgehende Bytes.

Ausgehende Bytes für Microsoft.EventHub.
OutgoingBytes Byte Gesamt (Summe) <none> PT1M Ja
Ausgehende Nachrichten

Ausgehende Nachrichten für Microsoft.EventHub.
OutgoingMessages Anzahl Gesamt (Summe) <none> PT1M Ja
Kontingent überschrittene Fehler.

Fehler aufgrund von Kontingentüberschreitung für Microsoft.EventHub.
QuotaExceededErrors Anzahl Gesamt (Summe) OperationResult PT1M No
Serverfehler.

Serverfehler für Microsoft.EventHub.
ServerErrors Anzahl Gesamt (Summe) 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 (Summe) OperationResult PT1M No
Eingeschränkte Anforderungen.

Gedrosselte Anforderungen für Microsoft.EventHub.
ThrottledRequests Anzahl Gesamt (Summe) OperationResult PT1M No
Benutzerfehler.

Benutzerfehler für Microsoft.EventHub.
UserErrors Anzahl Gesamt (Summe) 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 (Summe) EntityName PT1M No
Erfasste Bytes.

Erfasste Bytes für Microsoft.EventHub.
CapturedBytes Byte Gesamt (Summe) EntityName PT1M No
Erfasste Nachrichten.

Erfasste Nachrichten für Microsoft.EventHub.
CapturedMessages Anzahl Gesamt (Summe) 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 (Summe) <none> PT1M Ja
Archivnachrichtendurchsatz (veraltet)

Event Hub-Durchsatz archivierter Nachrichten in einem Namespace (veraltet)
EHAMBS Byte Gesamt (Summe) <none> PT1M Ja
Archivieren von Nachrichten (veraltet)

Event Hub-Archivnachrichten in einem Namespace (veraltet)
EHAMSGS Anzahl Gesamt (Summe) <none> PT1M Ja
Eingehende Bytes (veraltet)

Event Hub-Durchsatz eingehender Nachrichten für einen Namespace (veraltet)
EHINBYTES Byte Gesamt (Summe) <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 (Summe) <none> PT1M Ja
Eingehende Nachrichten (veraltet)

Gesamtzahl von eingehenden Nachrichten für einen Namespace (veraltet)
EHINMSGS Anzahl Gesamt (Summe) <none> PT1M Ja
Ausgehende Bytes (veraltet)

Event Hub-Durchsatz ausgehender Nachrichten für einen Namespace (veraltet)
EHOUTBYTES Byte Gesamt (Summe) <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 (Summe) <none> PT1M Ja
Ausgehende Nachrichten (veraltet)

Gesamtzahl von ausgehenden Nachrichten für einen Namespace (veraltet)
EHOUTMSGS Anzahl Gesamt (Summe) <none> PT1M Ja
Fehlgeschlagene Anforderungen (veraltet)

Gesamtzahl fehlerhafter Anforderungen für einen Namespace (veraltet)
FAILREQ Anzahl Gesamt (Summe) <none> PT1M Ja
Eingehende Bytes.

Eingehende Bytes für Microsoft.EventHub.
IncomingBytes Byte Gesamt (Summe) EntityName PT1M Ja
Eingehende Nachrichten

Eingehende Nachrichten für Microsoft.EventHub.
IncomingMessages Anzahl Gesamt (Summe) EntityName PT1M Ja
Eingehende Anforderungen

Eingehende Anforderungen für Microsoft.EventHub.
IncomingRequests Anzahl Gesamt (Summe) 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 (Summe) <none> PT1M Ja
Eingehende Anforderungen (veraltet)

Gesamtzahl eingehender Sendeanforderungen für einen Namespace (veraltet)
INREQS Anzahl Gesamt (Summe) <none> PT1M Ja
Interne Serverfehler (veraltet)

Gesamtzahl interner Serverfehler für einen Namespace (veraltet)
INTERR Anzahl Gesamt (Summe) <none> PT1M Ja
Andere Fehler (veraltet)

Gesamtzahl fehlerhafter Anforderungen für einen Namespace (veraltet)
MISCERR Anzahl Gesamt (Summe) <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 (Summe) EntityName PT1M Ja
Ausgehende Nachrichten

Ausgehende Nachrichten für Microsoft.EventHub.
OutgoingMessages Anzahl Gesamt (Summe) 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 (Summe) <none> PT1M Ja
Kontingent überschrittene Fehler.

Fehler aufgrund von Kontingentüberschreitung für Microsoft.EventHub.
QuotaExceededErrors Anzahl Gesamt (Summe) 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 (Summe) 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 (Summe) EntityName, OperationResult PT1M No
Erfolgreiche Anforderungen (veraltet)

Gesamtzahl erfolgreicher Anforderungen für einen Namespace (veraltet)
SUCCREQ Anzahl Gesamt (Summe) <none> PT1M Ja
Server-Beschäftigt-Fehler (veraltet)

Gesamtzahl der Fehler durch ausgelasteten Server für einen Namespace (veraltet)
SVRBSY Anzahl Gesamt (Summe) <none> PT1M Ja
Eingeschränkte Anforderungen.

Gedrosselte Anforderungen für Microsoft.EventHub.
ThrottledRequests Anzahl Gesamt (Summe) EntityName, OperationResult PT1M No
Benutzerfehler.

Benutzerfehler für Microsoft.EventHub.
UserErrors Anzahl Gesamt (Summe) 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.
Größe 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.

Bei diesem Dienst gelten die folgenden Dimensionen für die zugehörigen Metriken.

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 AzureDiagnostics

Protokolle aus mehreren Azure-Ressourcen.

No No Abfragen 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

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.

Screenshot: Dialogfeld zum Festlegen der Zieltabelle

Azure Event Hubs verwendet Kusto-Tabellen aus Azure Monitor-Protokollen. Sie können diese Tabellen mit Log Analytics abfragen.

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.