Referenz zum Überwachen von Azure Service Bus-Daten

Ausführliche Informationen zum Erfassen und Analysieren von Überwachungsdaten für Azure Service Bus finden Sie unter Überwachen von Azure Service Bus.

Hinweis

Azure Monitor schließt keine Dimensionen in die exportierten Metrikdaten ein, die an ein Ziel wie Azure Storage, Azure Event Hubs oder Log Analytics gesendet werden.

Metriken

In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken aufgeführt, die für Azure Service Bus erfasst werden. Der Ressourcenanbieter für diese Metriken ist Microsoft.ServiceBus/namespaces.

Anforderungsmetriken

Zählt die Anzahl der Anforderungen von Daten und Verwaltungsvorgängen

Metrikname Über Diagnoseeinstellungen exportierbar Einheit Aggregationstyp BESCHREIBUNG Dimensionen
Eingehende Anforderungen Ja Anzahl Gesamt Die Anzahl der Anforderungen an den Service Bus-Dienst in einem bestimmten Zeitraum EntityName
Erfolgreiche Anforderungen Nein Anzahl Gesamt Die Anzahl der erfolgreichen Anforderungen an den Service Bus-Dienst in einem bestimmten Zeitraum Name der Entität
OperationResult
Serverfehler Nein Anzahl Gesamt Die Anzahl der aufgrund eines Fehlers nicht verarbeiteten Anforderungen an den Service Bus-Dienst in einem bestimmten Zeitraum Name der Entität
OperationResult
User Errors Nein Anzahl Gesamt Die Anzahl der aufgrund von Benutzerfehlern nicht verarbeiteten Anforderungen in einem bestimmten Zeitraum Name der Entität
Gedrosselte Anforderungen Nein Anzahl Gesamt

Die Anzahl der Anforderungen, die aufgrund eines überschrittenen Verbrauchs gedrosselt wurden

Die MessagingErrorSubCode-Dimension weist die folgenden möglichen Werte auf:

  • CPU: CPU-Drosselung
  • Speicher: Gibt eine Drosselung aufgrund ausstehender Prüfpunktvorgänge an.
  • Namespace:Drosselung von Namespacevorgängen.
  • Unbekannt: Andere Ressourcendrosselung.
Name der Entität
MessagingErrorSubCode
Anzahl ausstehender Prüfpunktvorgänge Nein count Average Die Anzahl ausstehender Prüfpunktvorgänge für den Namespace. Der Dienst beginnt mit der Drosselung, wenn die Anzahl ausstehender Prüfpunkte das Limit von Vorgängen (500.000 + (500.000 * Messagingeinheiten)) überschreitet. Diese Metrik gilt nur für Namespaces, die den Premium-Tarif verwenden. MessagingErrorSubCode
Serversendelatenz Nein Millisekunden Average Die Zeit, die der Service Bus-Dienst zum Abschließen der Anforderung in Anspruch nimmt. Name der Entität

Die beiden folgenden Arten von Fehlern werden als Benutzerfehler klassifiziert:

  1. Clientseitige Fehler (in HTTP: Fehler vom Typ 400)
  2. Fehler bei der Nachrichtenverarbeitung (beispielsweise MessageLockLostException)

Nachrichtenmetriken

Metrikname Über Diagnoseeinstellungen exportierbar Einheit Aggregationstyp BESCHREIBUNG Dimensionen
Eingehende Nachrichten Ja Anzahl Gesamt Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum an Service Bus gesendet wurden Für die Tarife „Basic“ und „Standard“ sind eingehende automatisch weitergeleitete Nachrichten in dieser Metrik enthalten. Für den Premium-Tarif sind sie nicht enthalten. Name der Entität
Ausgehende Nachrichten Ja Anzahl Gesamt Die Anzahl von Ereignissen oder Nachrichten, die in einem bestimmten Zeitraum von Service Bus empfangen wurden Die ausgehenden automatisch weitergeleiteten Nachrichten sind in dieser Metrik nicht enthalten. Name der Entität
Meldungen Nein Anzahl Average Anzahl von Nachrichten in einer Warteschlange/einem Thema Diese Metrik enthält Nachrichten in allen verschiedenen Zuständen wie aktiv, unzustellbar, geplant usw. Name der Entität
Aktive Nachrichten Nein Anzahl Average Anzahl von aktiven Nachrichten in einer Warteschlange/einem Thema Aktive Nachrichten sind die Nachrichten in der Warteschlange oder im Abonnement, die sich im aktiven Zustand befinden und zustellbereit sind. Die Nachrichten können empfangen werden. Name der Entität
Unzustellbare Nachrichten Nein Anzahl Average Anzahl von unzustellbaren Nachrichten in einer Warteschlange/einem Thema. Name der Entität
Geplante Nachrichten Nein Anzahl Average Anzahl von geplanten Nachrichten in einer Warteschlange/einem Thema. Name der Entität
Abgeschlossene Nachrichten Ja Anzahl Gesamt Die Anzahl von Nachrichten, die über einen bestimmten Zeitraum abgeschlossen wurden. Name der Entität
Abgebrochene Nachrichten Ja Anzahl Gesamt Die Anzahl von Nachrichten, die über einen bestimmten Zeitraum abgebrochen wurden. Name der Entität
Size Nein Byte Average Größe einer Entität (Warteschlange oder Thema) in Byte Name der Entität

Wichtig

Werte für Nachrichten, aktive Nachrichten, unzustellbare Nachrichten, geplante Nachrichten, abgeschlossene Nachrichten und abgebrochene Nachrichten sind Zeitpunktwerte. Eingehende Nachrichten, die unmittelbar nach diesem Zeitpunkt verarbeitet wurden, werden in diesen Metriken möglicherweise nicht berücksichtigt.

Hinweis

Wenn ein Client versucht, Informationen zu einer Warteschlange oder einem Thema abzurufen, gibt der Service Bus-Dienst einige statische Informationen (z. B. Name, Zeitpunkt der letzten Aktualisierung, Erstellungszeit, ob eine Sitzung erforderlich ist usw.) sowie einige dynamische Informationen wie die Nachrichtenanzahl zurück. Wenn die Anforderung gedrosselt wird, gibt der Dienst die statischen Informationen und leere dynamische Informationen zurück. Aus diesem Grund wird als Nachrichtenanzahl 0 (null) angezeigt, wenn der Namespace gedrosselt wird. Dieses Verhalten ist beabsichtigt.

Verbindungsmetriken

Metrikname Über Diagnoseeinstellungen exportierbar Einheit Aggregationstyp BESCHREIBUNG Dimensionen
Die aktiven Verbindungen. Nein Anzahl Gesamt Die Anzahl der aktiven Verbindungen für einen Namespace sowie für eine Entität 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 Nein Anzahl Average Die Anzahl der geöffneten Verbindungen. Der Wert für diese Metrik ist eine Aggregation und enthält alle Verbindungen, die im Zeitfenster der Aggregration geöffnet wurden. Name der Entität
Geschlossene Verbindungen Nein Anzahl Average Die Anzahl der geschlossenen Verbindungen. Der Wert für diese Metrik ist eine Aggregation und enthält alle Verbindungen, die im Zeitfenster der Aggregration geöffnet wurden. Name der Entität

Metriken zur Ressourcennutzung

Hinweis

Die folgenden Metriken sind nur mit dem Premium-Tarif verfügbar.

Wichtige Metriken, die bei Ausfällen für einen Namespace im Premium-Tarif überwacht werden müssen: CPU-Auslastung pro Namespace und Arbeitsspeichergröße pro Namespace. Richten Sie mit Azure Monitor Warnungen für diese Metriken ein.

Die andere Metrik, die Sie überwachen können, ist Gedrosselt Anforderungen. Es sollte jedoch kein Problem vorliegen, solange der Namespace innerhalb der Grenzwerte für Arbeitsspeicher, CPU und vermittelte Verbindungen bleibt. Weitere Informationen finden Sie unter Drosselung im Tarif „Premium“ von Azure Service Bus

Metrikname Über Diagnoseeinstellungen exportierbar Einheit Aggregationstyp BESCHREIBUNG Dimensionen
CPU-Auslastung pro Namespace Nein CPU Percent Der Prozentsatz der CPU-Auslastung des Namespace Replikat
Auslastung der Arbeitsspeichergröße pro Namespace Nein Speicherauslastung Percent Der Prozentsatz der Arbeitsspeichernutzung des Namespace Replikat

Fehlermetriken

Metrikname Über Diagnoseeinstellungen exportierbar Einheit Aggregationstyp BESCHREIBUNG Dimensionen
Serverfehler Nein Anzahl Gesamt Die Anzahl der aufgrund eines Fehlers nicht verarbeiteten Anforderungen an den Service Bus-Dienst in einem bestimmten Zeitraum Name der Entität

Ergebnis des Vorgangs
Benutzerfehler Nein Anzahl Gesamt Die Anzahl der aufgrund von Benutzerfehlern nicht verarbeiteten Anforderungen in einem bestimmten Zeitraum Name der Entität

Ergebnis des Vorgangs

Metrikdimensionen

Azure Service Bus unterstützt folgende Dimensionen für Metriken in Azure Monitor. Das Hinzufügen von Dimensionen zu Ihren Metriken ist optional. Wenn Sie keine Dimensionen hinzufügen, werden Metriken auf Namespaceebene angegeben.

Dimensionsname BESCHREIBUNG
Entitätsname Service Bus unterstützt Messagingentitäten unter dem Namespace. Mit der Metrik „Eingehende Anforderungen“ wird für die Dimension „Entitätsname“ zusätzlich zu all Ihren Warteschlangen und Themen der Wert „-NamespaceOnlyMetric-“ angezeigt. Dies stellt die Anforderung dar, die auf Namespaceebene durchgeführt wurde. Beispiele hierfür sind eine Anforderung zum Auflisten aller Warteschlangen/Themen unter dem Namespace oder Anforderungen an Entitäten, bei denen die Authentifizierung oder Autorisierung fehlgeschlagen ist.

Ressourcenprotokolle

In diesem Abschnitt werden die Typen der Ressourcenprotokolle aufgeführt, die für Azure Service Bus erfasst werden können.

  • Betriebsprotokolle
  • Protokolle zum Filtern virtueller Netzwerke und IP-Adressen
  • Laufzeitüberwachungsprotokolle

Azure Service Bus verfügt jetzt über die Möglichkeit, Protokolle an eine von zwei Zieltabellen zu verteilen: Azure Diagnostic oder Ressourcenspezifische Tabellen in Log Analytics. Sie können den im Azure-Portal verfügbaren Umschalter verwenden, um Zieltabellen auszuwählen.

Screenshot of dialog box to set destination table.

Betriebsprotokolle

Einträge im Betriebsprotokoll enthalten Elemente, die in der folgenden Tabelle aufgeführt werden:

Name Beschreibung Unterstützt in AzureDiagnostics Unterstützt in AZMSOperationalLogs (Ressourcenspezifische Tabelle)
ActivityId Interne ID, die zum Identifizieren der angegebenen Aktivität verwendet wird Ja Ja
EventName Name des Vorgangs Ja Ja
ResourceId Azure Resource Manager-Ressourcen-ID Ja Ja
SubscriptionId Abonnement-ID Ja Ja
EventtimeString Vorgangsdauer Ja Nein
TimeGenerated [UTC] Ausführungszeitpunkt (in UTC) Nein Ja
EventProperties Vorgangseigenschaften Ja Ja
Status Vorgangsstatus Ja Ja
Caller Aufrufer des Vorgangs (Azure-Portal oder Verwaltungsclient) Ja Ja
Provider Name des Dienstes, der die Protokolle aussendet, z. B. ServiceBus Nein Ja
Type Typ der ausgegebenen Protokolle Nein Ja
Category Protokollkategorie Ja Nein

Hier ein Beispiel für eine JSON-Zeichenfolge im Betriebsprotokoll:

AzureDiagnostics:


{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Create Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "category": "OperationalLogs"
}


Ressourcenspezifischer Tabelleneintrag:


{

  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Retrieve Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "TimeGenerated(UTC)": "9/28/2023 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "type": "AZMSOperationalLogs",
  "Provider" : "SERVICEBUS"

}

In Betriebsprotokollen erfasste Ereignisse und Vorgänge

Betriebsprotokolle erfassen alle Verwaltungsvorgänge, die für den Azure Service Bus-Namespace ausgeführt werden. Datenvorgänge werden aufgrund der hohen Menge an Datenvorgängen, die für Azure Service Bus durchgeführt werden, nicht erfasst.

Hinweis

Damit Sie Datenvorgänge besser nachverfolgen können, empfehlen wir Ihnen die clientseitige Nachverfolgung.

Die folgenden Verwaltungsvorgänge werden in Betriebsprotokollen erfasst:

`Scope` Vorgang
Namespace - Namespace erstellen
- Namespace aktualisieren
- Namespace löschen
- Namespace aktualisieren
- Namespace abrufen
– SharedAccess-Richtlinie
Queue - Warteschlange erstellen
- Warteschlange aktualisieren
- Warteschlange löschen
- AutoDelete Warteschlange löschen
- Warteschlange abrufen
Thema - Thema erstellen
- Thema aktualisieren
- Thema löschen
- AutoDelete Löschen eines Themas
- Thema abrufen
Subscription - Abonnement erstellen
- Abonnement aktualisieren
- Abonnement löschen
- AutoDelete Löschen eines Abonnements
- Abonnement abrufen

Hinweis

Lesevorgänge werden in Betriebsprotokollen derzeit nicht nachverfolgt.

Protokolle zum Filtern virtueller Netzwerke und IP-Adressen

Die JSON-Zeichenfolge für das Service Bus-Verbindungsereignis mit virtuellem Netzwerk enthält Elemente, die in der folgenden Tabelle aufgeführt werden:

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 Service Bus-Dienst herstellt Ja Ja
AddressIP IP-Adresse des Clients, der die Verbindung mit Service Bus herstellt Ja Ja
TimeGenerated [UTC] Ausführungszeitpunkt (in UTC) Ja Ja
Action Aktion, die vom Service Bus-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 Ja
Count Anzahl von Vorkommen für die angegebene Aktion. Ja Ja
ResourceId Azure Resource Manager-Ressourcen-ID Ja Ja
Category Protokollkategorie Ja Nein
Provider Name des Dienstes, der die Protokolle aussendet, z. B. ServiceBus Nein Ja
Type Typ der ausgegebenen Protokolle Nein Ja

Hinweis

Protokolle virtueller Netzwerke werden nur dann generiert, wenn der Namespace Zugriff aus ausgewählten Netzwerken oder über spezifische IP-Adressen (IP-Filterregeln) erlaubt.

Hier ein Beispiel für die JSON-Zeichenfolge eines VNet-Protokolls:

AzureDiagnostics;

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Accept Connection",
    "Reason": "IP is accepted by IPAddress filter.",
    "Count": 1,
    "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
    "Category": "ServiceBusVNetConnectionEvent"
}

Ressourcenspezifischer Tabelleneintrag:

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "AddressIp": "1.2.3.4",
    "Action": "Accept Connection",
    "Message": "IP is accepted by IPAddress filter.",
    "Count": 1,
    "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
    "Provider" : "SERVICEBUS",
    "Type": "AZMSVNetConnectionEvents"
}

Laufzeit-Überwachungsprotokolle

Laufzeitüberwachungsprotokolle erfassen aggregierte Diagnoseinformationen für verschiedene Datenebenenzugriffsvorgänge (z. B. Senden oder Empfangen von Nachrichten) in Service Bus.

Hinweis

Laufzeitüberwachungsprotokolle sind derzeit nur auf Premium-Ebene verfügbar.

Laufzeit-Überwachungsprotokolle enthalten die in der folgenden Tabelle aufgeführten Elemente:

Name Beschreibung Unterstützt in Azure Diagnostics Unterstützt in AZMSRuntimeAuditLogs (Ressourcenspezifische 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
time Generated (UTC) Zusammengefasste Zeit 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-Anwendungs-ID oder Name der SAS-Richtlinie, der für die Authentifizierung bei einer Ressource verwendet wird. Ja Ja
NetworkType Typ des Netzwerkzugriffs: Public oder Private. ja Ja
ClientIP IP-Adresse der Clientanwendung. Ja Ja
Count Gesamtzahl der Vorgänge, die während des aggregierten Zeitraums von 1 Minute ausgeführt wurden. Ja Ja
Properties Metadaten, die für den Datenebenenvorgang spezifisch sind. ja Ja
Category Protokollkategorie Ja Nein
Provider Name des Dienstes, der die Protokolle aussendet, z. B. ServiceBus Nein Ja
Type Typ der ausgegebenen Protokolle Nein Ja

Hier sehen Sie ein Beispiel für einen Laufzeitüberwachungsprotokolleintrag:

AzureDiagnostics:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
    "Time": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | HTTP | SBMP", 
    "AuthType": "SAS | AAD", 
    "AuthKey": "<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 | PeekLockMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
    "TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | HTTP | SBMP", 
    "AuthType": "SAS | AAD", 
    "AuthKey": "<AAD Application Name| SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1, 
    "Provider": "SERVICEBUS",
    "Type"   : "AZMSRuntimeAuditLogs"
 }

Am 30. September 2026 wird die Unterstützung des SBMP-Protokolls für Azure Service Bus eingestellt, sodass Sie dieses Protokoll nach dem 30. September 2026 nicht mehr verwenden können. Migrieren Sie mithilfe des AMQP-Protokolls zu den neuesten Azure Service Bus SDK-Bibliotheken, die wichtige Sicherheitsupdates und verbesserte Funktionen vor diesem Datum bieten.

Weitere Informationen finden Sie in der Ankündigung der Supporteinstellung.

Tabellen in Azure Monitor-Protokollen

Azure Service Bus 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.

Nächste Schritte