Dokumentacja dotycząca monitorowania danych usługi Azure Service Bus

Aby uzyskać szczegółowe informacje na temat zbierania i analizowania danych monitorowania dla usługi Azure Service Bus, zobacz Monitorowanie usługi Azure Service Bus .

Uwaga

Usługa Azure Monitor nie uwzględnia wymiarów w wyeksportowanych danych metryk wysyłanych do miejsca docelowego, takiego jak Azure Storage, Azure Event Hubs, Log Analytics itp.

Mierniki

Ta sekcja zawiera listę wszystkich automatycznie zebranych metryk platformy zebranych dla usługi Azure Service Bus. Dostawca zasobów dla tych metryk to Microsoft.ServiceBus/przestrzenie nazw.

Metryki żądań

Zlicza liczbę żądań operacji dotyczących danych i zarządzania.

Nazwa metryki Możliwość eksportowania za pomocą ustawień diagnostycznych Jednostka Typ agregacji opis Wymiary
Żądania przychodzące Tak Licznik Łącznie Liczba żądań wysyłanych do usługi Service Bus w określonym przedziale czasu. EntityName
Żądania pomyślne Nie. Licznik Łącznie Liczba pomyślnych żądań wysyłanych do usługi Service Bus w określonym przedziale czasu. Nazwa encji
Operationresult
Błędy serwera Nie. Licznik Łącznie Liczba żądań, które nie zostały przetworzone z powodu błędu w usłudze Service Bus w określonym przedziale czasu. Nazwa encji
Operationresult
Błędy użytkownika Nie. Licznik Łącznie Liczba żądań, które nie zostały przetworzone z powodu błędów użytkownika w określonym przedziale czasu. Nazwa encji
Żądania ograniczone Nie. Licznik Łącznie

Liczba żądań, które zostały ograniczone, ponieważ użycie zostało przekroczone.

Wymiar MessagingErrorSubCode ma następujące możliwe wartości:

  • Procesor CPU: ograniczanie procesora CPU
  • Storage:Wskazuje ona ograniczenie z powodu oczekujących operacji punktu kontrolnego
  • Przestrzeń nazw: ograniczanie operacji przestrzeni nazw.
  • Nieznany: Inne ograniczanie zasobów.
Nazwa encji
MessagingErrorSubCode
Liczba oczekujących operacji punktu kontrolnego Nie. count Średnia Liczba oczekujących operacji punktu kontrolnego w przestrzeni nazw. Usługa rozpoczyna ograniczanie, gdy liczba oczekujących punktów kontrolnych przekracza limit (500 000 + (500 000 * jednostki obsługi komunikatów)). Ta metryka ma zastosowanie tylko do przestrzeni nazw korzystających z warstwy Premium . MessagingErrorSubCode
Opóźnienie wysyłania serwera Nie. milisekundy Średnia Czas potrzebny usłudze Service Bus na ukończenie żądania. Nazwa encji

Następujące dwa typy błędów są klasyfikowane jako błędy użytkownika:

  1. Błędy po stronie klienta (w protokole HTTP, które byłyby błędami 400).
  2. Błędy występujące podczas przetwarzania komunikatów, takie jak MessageLockLostException.

Metryki komunikatów

Nazwa metryki Możliwość eksportowania za pomocą ustawień diagnostycznych Jednostka Typ agregacji opis Wymiary
Komunikaty przychodzące Tak Licznik Łącznie Liczba zdarzeń lub komunikatów wysyłanych do usługi Service Bus w określonym przedziale czasu. W przypadku warstw podstawowych i standardowych komunikaty przesyłane automatycznie są uwzględniane w tej metryce. W przypadku warstwy Premium nie są one uwzględniane. Nazwa encji
Komunikaty wychodzące Tak Licznik Łącznie Liczba zdarzeń lub komunikatów odebranych z usługi Service Bus w określonym przedziale czasu. Wychodzące wiadomości automatycznie przekazywane nie są uwzględniane w tej metryce. Nazwa encji
Wiadomości Nie. Licznik Średnia Liczba komunikatów w kolejce/temacie. Ta metryka zawiera komunikaty we wszystkich różnych stanach, takich jak aktywne, nieaktywne, zaplanowane itp. Nazwa encji
Aktywne komunikaty Nie. Licznik Średnia Liczba aktywnych komunikatów w kolejce/temacie. Aktywne komunikaty to komunikaty w kolejce lub subskrypcji, które są w stanie aktywnym i są gotowe do dostarczenia. Komunikaty są dostępne do odebrania. Nazwa encji
Wiadomości z komunikatami utraconymi Nie. Licznik Średnia Liczba utraconych komunikatów w kolejce/temacie. Nazwa encji
Zaplanowane komunikaty Nie. Licznik Średnia Liczba zaplanowanych komunikatów w kolejce/temacie. Nazwa encji
Ukończone komunikaty Tak Licznik Łącznie Liczba komunikatów zakończonych w określonym przedziale czasu. Nazwa encji
Porzucone wiadomości Tak Licznik Łącznie Liczba komunikatów porzuconych w określonym przedziale czasu. Nazwa encji
Size Nie. Bajty Średnia Rozmiar jednostki (kolejki lub tematu) w bajtach. Nazwa encji

Ważne

Wartości komunikatów, aktywnych, utraconych, zaplanowanych, zakończonych i porzuconych komunikatów są wartościami punkt-w czasie. Komunikaty przychodzące, które zostały zużyte natychmiast po tym punkcie w czasie, mogą nie być odzwierciedlane w tych metrykach.

Uwaga

Gdy klient próbuje uzyskać informacje o kolejce lub temacie, usługa Service Bus zwraca pewne informacje statyczne, takie jak nazwa, czas ostatniej aktualizacji, czas utworzenia, wymaga sesji lub nie itp., a niektóre informacje dynamiczne, takie jak liczba komunikatów. Jeśli żądanie zostanie ograniczone, usługa zwróci informacje statyczne i puste informacje dynamiczne. Dlatego liczba komunikatów jest wyświetlana jako 0, gdy przestrzeń nazw jest ograniczana. To zachowanie jest celowe.

Metryki Połączenie ion

Nazwa metryki Możliwość eksportowania za pomocą ustawień diagnostycznych Jednostka Typ agregacji opis Wymiary
Aktywne połączenia Nie. Licznik Łącznie Liczba aktywnych połączeń w przestrzeni nazw i w jednostce w przestrzeni nazw. Wartość tej metryki jest wartością typu punkt w czasie. Połączenie, które były aktywne bezpośrednio po tym punkcie w czasie, mogą nie zostać odzwierciedlone w metryce.
otwarte Połączenie ions Nie. Licznik Średnia Liczba otwartych połączeń. Wartość dla tej metryki jest agregacją i zawiera wszystkie połączenia, które zostały otwarte w oknie czasu agregacji. Nazwa encji
Zamknięte Połączenie iony Nie. Licznik Średnia Liczba zamkniętych połączeń. Wartość dla tej metryki jest agregacją i zawiera wszystkie połączenia, które zostały otwarte w oknie czasu agregacji. Nazwa encji

Metryki użycia zasobów

Uwaga

Poniższe metryki są dostępne tylko w warstwie Premium .

Ważne metryki do monitorowania przerw w działaniu przestrzeni nazw warstwy Premium to: użycie procesora CPU na przestrzeń nazw i rozmiar pamięci na przestrzeń nazw. Skonfiguruj alerty dla tych metryk przy użyciu usługi Azure Monitor.

Druga metryka, którą można monitorować, to: żądania ograniczone. Nie powinno to być jednak problemem, o ile przestrzeń nazw pozostaje w granicach pamięci, procesora CPU i połączeń obsługiwanych przez brokera. Aby uzyskać więcej informacji, zobacz Ograniczanie przepustowości w warstwie Premium usługi Azure Service Bus

Nazwa metryki Możliwość eksportowania za pomocą ustawień diagnostycznych Jednostka Typ agregacji opis Wymiary
Użycie procesora CPU na przestrzeń nazw Nie. Procesor CPU Procent Procentowe użycie procesora CPU w przestrzeni nazw. Replika
Użycie rozmiaru pamięci na przestrzeń nazw Nie. Użycie pamięci Procent Procentowe użycie pamięci w przestrzeni nazw. Replika

Metryki błędów

Nazwa metryki Możliwość eksportowania za pomocą ustawień diagnostycznych Jednostka Typ agregacji opis Wymiary
Błędy serwera Nie. Licznik Łącznie Liczba żądań, które nie zostały przetworzone z powodu błędu w usłudze Service Bus w określonym przedziale czasu. Nazwa encji

Wynik operacji
Błędy użytkownika Nie. Licznik Łącznie Liczba żądań, które nie zostały przetworzone z powodu błędów użytkownika w określonym przedziale czasu. Nazwa encji

Wynik operacji

Wymiary metryk

Usługa Azure Service Bus obsługuje następujące wymiary metryk w usłudze Azure Monitor. Dodawanie wymiarów do metryk jest opcjonalne. Jeśli nie dodasz wymiarów, metryki są określane na poziomie przestrzeni nazw.

Nazwa wymiaru opis
Nazwa encji Usługa Service Bus obsługuje jednostki obsługi komunikatów w przestrzeni nazw. W przypadku metryki "Żądania przychodzące" wymiar Nazwa jednostki będzie miał wartość "-NamespaceOnlyMetric-" oprócz wszystkich kolejek i tematów. Reprezentuje to żądanie, które zostało wykonane na poziomie przestrzeni nazw. Przykłady obejmują żądanie wyświetlenia listy wszystkich kolejek/tematów w przestrzeni nazw lub żądań jednostek, które nie powiodły się uwierzytelnianie lub autoryzacja.

Dzienniki zasobów

W tej sekcji wymieniono typy dzienników zasobów, które można zbierać dla usługi Azure Service Bus.

  • Dzienniki operacyjne
  • Dzienniki filtrowania sieci wirtualnej i adresów IP
  • Dzienniki inspekcji środowiska uruchomieniowego

Usługa Azure Service Bus ma teraz możliwość wysyłania dzienników do jednej z dwóch tabel docelowych — Azure Diagnostic lub Resource specific tables w usłudze Log Analytics. Aby wybrać tabele docelowe, możesz użyć przełącznika dostępnego w witrynie Azure Portal.

Screenshot of dialog box to set destination table.

Dzienniki operacyjne

Wpisy dziennika operacyjnego zawierają elementy wymienione w poniższej tabeli:

Nazwa/nazwisko opis Obsługiwane w usłudze AzureDiagnostics Obsługiwane w AZMSOperationalLogs (tabela specyficzna dla zasobów)
ActivityId Identyfikator wewnętrzny służący do identyfikowania określonego działania Tak Tak
EventName Nazwa operacji Tak Tak
ResourceId Identyfikator zasobu usługi Azure Resource Manager Tak Tak
SubscriptionId Identyfikator subskrypcji Tak Tak
EventtimeString Czas operacji Tak Nie.
TimeGenerated [UTC] Czas wykonania operacji (w utc) Nie. Tak
EventProperties Właściwości operacji Tak Tak
Status Stan operacji Tak Tak
Caller Obiekt wywołujący operację (witryna Azure Portal lub klient zarządzania) Tak Tak
Provider Nazwa usługi emitująca dzienniki, np. ServiceBus Nie. Tak
Type Typ emitowanych dzienników Nie. Tak
Category Kategoria dziennika Tak Nie.

Oto przykład ciągu JSON dziennika operacyjnego:

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"
}


Wpis tabeli specyficznej dla zasobu:


{

  "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"

}

Zdarzenia i operacje przechwycone w dziennikach operacyjnych

Dzienniki operacyjne przechwytują wszystkie operacje zarządzania wykonywane w przestrzeni nazw usługi Azure Service Bus. Operacje na danych nie są przechwytywane ze względu na dużą liczbę operacji danych wykonywanych w usłudze Azure Service Bus.

Uwaga

Aby ułatwić lepsze śledzenie operacji na danych, zalecamy użycie śledzenia po stronie klienta.

Następujące operacje zarządzania są przechwytywane w dziennikach operacyjnych:

Zakres Operacja
Przestrzeń nazw - Tworzenie przestrzeni nazw
- Aktualizowanie przestrzeni nazw
- Usuń przestrzeń nazw
- Aktualizowanie przestrzeni nazw
- Pobieranie przestrzeni nazw
- Zasady funkcji SharedAccess
Kolejka - Tworzenie kolejki
- Aktualizowanie kolejki
- Usuwanie kolejki
- Automatyczne usuwanie kolejki
- Pobieranie kolejki
Temat - Tworzenie tematu
- Aktualizowanie tematu
- Usuwanie tematu
- AutoDelete Delete Topic (Automatyczne usuwanie tematu)
- Pobieranie tematu
Subskrypcja - Tworzenie subskrypcji
— Aktualizowanie subskrypcji
— Usuwanie subskrypcji
— Automatyczne usuwanie subskrypcji
- Pobieranie subskrypcji

Uwaga

Obecnie operacje odczytu nie są śledzone w dziennikach operacyjnych.

Dzienniki filtrowania sieci wirtualnej i adresów IP

Kod JSON zdarzenia połączenia usługi Service Bus (VNet) zawiera elementy wymienione w poniższej tabeli:

Nazwa/nazwisko opis Obsługiwane w Diagnostyka Azure Obsługiwane w sieci AZMSVnet Połączenie ionEvents (tabela specyficzna dla zasobów)
SubscriptionId Identyfikator subskrypcji Azure Tak Tak
NamespaceName Nazwa przestrzeni nazw Tak Tak
IPAddress Adres IP klienta nawiązującego połączenie z usługą Service Bus Tak Tak
AddressIP Adres IP klienta nawiązującego połączenie z usługą Service Bus Tak Tak
TimeGenerated [UTC] Czas wykonania operacji (w utc) Tak Tak
Action Akcja wykonywana przez usługę Service Bus podczas oceniania żądań połączenia. Obsługiwane akcje to Akceptuj Połączenie ion i Odmów Połączenie ion. Tak Tak
Reason Zawiera powód, dla którego wykonano akcję Tak Tak
Count Liczba wystąpień dla danej akcji Tak Tak
ResourceId Identyfikator zasobu usługi Azure Resource Manager. Tak Tak
Category Kategoria dziennika Tak Nie.
Provider Nazwa usługi emitująca dzienniki, np. ServiceBus Nie. Tak
Type Typ emitowanych dzienników Nie. Tak

Uwaga

Dzienniki sieci wirtualnej są generowane tylko wtedy, gdy przestrzeń nazw zezwala na dostęp z wybranych sieci lub z określonych adresów IP (reguł filtrowania adresów IP).

Oto przykład ciągu JSON dziennika sieci wirtualnej:

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"
}

Wpis tabeli specyficznej dla zasobu:

{
    "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"
}

Dzienniki inspekcji środowiska uruchomieniowego

Dzienniki inspekcji środowiska uruchomieniowego przechwytują zagregowane informacje diagnostyczne dotyczące różnych operacji dostępu do płaszczyzny danych (takich jak wysyłanie lub odbieranie komunikatów) w usłudze Service Bus.

Uwaga

Dzienniki inspekcji środowiska uruchomieniowego są obecnie dostępne tylko w warstwie Premium .

Dzienniki inspekcji środowiska uruchomieniowego zawierają elementy wymienione w poniższej tabeli:

Nazwa/nazwisko opis Obsługiwane w Diagnostyka Azure Obsługiwane w AZMSRuntimeAuditLogs (tabela specyficzna dla zasobów)
ActivityId Wygenerowany losowo identyfikator UUID zapewniający unikatowość działania inspekcji. Tak Tak
ActivityName Nazwa operacji środowiska uruchomieniowego. Tak Tak
ResourceId Zasób skojarzony z działaniem. Tak Tak
Timestamp Czas agregacji. Tak Nie.
time Generated (UTC) Zagregowany czas Nie. Tak
Status Stan działania (powodzenie lub niepowodzenie). Tak Tak
Protocol Typ protokołu skojarzonego z operacją. Tak Tak
AuthType Typ uwierzytelniania (identyfikator Entra firmy Microsoft lub zasady sygnatury dostępu współdzielonego). Tak Tak
AuthKey Identyfikator aplikacji Entra firmy Microsoft lub nazwa zasad sygnatury dostępu współdzielonego używana do uwierzytelniania w zasobie. Tak Tak
NetworkType Typ dostępu do sieci: Public lubPrivate. tak Tak
ClientIP Adres IP aplikacji klienckiej. Tak Tak
Count Łączna liczba operacji wykonywanych w zagregowanym okresie 1 minuty. Tak Tak
Properties Metadane specyficzne dla operacji płaszczyzny danych. tak Tak
Category Kategoria dziennika Tak Nie.
Provider Nazwa usługi emitująca dzienniki, np. ServiceBus Nie. Tak
Type Typ emitowanych dzienników Nie. Tak

Oto przykład wpisu dziennika inspekcji środowiska uruchomieniowego:

AzureDiagnostics:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | 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"
 }

Wpis tabeli specyficznej dla zasobu:

{
    "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"
 }

30 września 2026 r. wycofamy obsługę protokołu SBMP dla usługi Azure Service Bus, więc nie będzie można już używać tego protokołu po 30 września 2026 r. Przeprowadź migrację do najnowszych bibliotek zestawu SDK usługi Azure Service Bus przy użyciu protokołu AMQP, który oferuje krytyczne aktualizacje zabezpieczeń i ulepszone możliwości przed tą datą.

Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu pomocy technicznej.

Tabele dzienników usługi Azure Monitor

Usługa Azure Service Bus używa tabel Kusto z dzienników usługi Azure Monitor. Te tabele można wykonywać za pomocą usługi Log Analytics. Aby uzyskać listę tabel Usługi Kusto używanych przez usługę, zobacz Dokumentacja tabeli dzienników usługi Azure Monitor.

Następne kroki