Referenční informace k monitorování dat služby Azure Service Bus

Podrobnosti o shromažďování a analýze dat monitorování služby Azure Service Bus najdete v tématu Monitorování služby Azure Service Bus .

Poznámka:

Azure Monitor nezahrnuje dimenze do exportovaných dat metrik odesílaných do cíle, jako je Azure Storage, Azure Event Hubs, Log Analytics atd.

Metriky

Tato část obsahuje seznam všech automaticky shromážděných metrik platformy shromážděných pro Službu Azure Service Bus. Poskytovatel prostředků pro tyto metriky je Microsoft.ServiceBus/namespaces.

Vyžádání metrik

Spočítá počet žádostí o operace správy a dat.

Název metriky Exportovatelné prostřednictvím nastavení diagnostiky Unit Typ agregace Popis Dimenze
Příchozí žádosti Ano Počet Celkem Počet požadavků provedených službě Service Bus v zadaném období EntityName
Úspěšné požadavky No Počet Celkem Počet úspěšných požadavků provedených ve službě Service Bus v zadaném období Název entity
OperationResult
Chyby serveru No Počet Celkem Počet požadavků, které se nezpracovávají kvůli chybě ve službě Service Bus v zadaném období Název entity
OperationResult
Chyby uživatele No Počet Celkem Počet požadavků, které se nezpracovávají kvůli chybám uživatelů v zadaném období. Název entity
Omezené požadavky No Počet Celkem

Počet omezených požadavků, protože došlo k překročení využití.

Dimenze MessagingErrorSubCode má následující možné hodnoty:

  • PROCESOR: Omezování procesoru
  • Storage:Označuje omezení kvůli čekajícími operacím kontrolního bodu.
  • Obor názvů: Omezování operací oboru názvů
  • Neznámé: Omezení jiných prostředků
Název entity
MessagingErrorSubCode
Počet operací čekajících na kontrolní bod No count Průměr Počet čekajících operací kontrolních bodů v oboru názvů. Služba se začne omezovat, když počet čekajících kontrolních bodů překročí limit operací (500 000 + (500 000 * jednotek zasílání zpráv). Tato metrika se vztahuje pouze na obory názvů používající úroveň Premium . MessagingErrorSubCode
Latence odesílání serveru No milisekundy Průměr Doba potřebná službou Service Bus k dokončení požadavku. Název entity

Následující dva typy chyb jsou klasifikovány jako uživatelské chyby:

  1. Chyby na straně klienta (v protokolu HTTP by to byly chyby 400).
  2. Chyby, ke kterým dochází při zpracování zpráv, například MessageLockLostException.

Metriky zpráv

Název metriky Exportovatelné prostřednictvím nastavení diagnostiky Unit Typ agregace Popis Dimenze
Příchozí zprávy Ano Počet Celkem Počet událostí nebo zpráv odesílaných službě Service Bus během zadaného období. U úrovní Basic a Standard jsou příchozí zprávy automaticky přeposílané do této metriky zahrnuty. A pro úroveň Premium nejsou zahrnuté. Název entity
Odchozí zprávy Ano Počet Celkem Počet událostí nebo zpráv přijatých ze služby Service Bus v zadaném období Odchozí automaticky přeposílané zprávy nejsou součástí této metriky. Název entity
Zprávy No Počet Průměr Počet zpráv ve frontě nebo tématu Tato metrika zahrnuje zprávy ve všech různých stavech, jako jsou aktivní, nedoručené, naplánované atd. Název entity
Aktivní zprávy No Počet Průměr Počet aktivních zpráv ve frontě nebo tématu Aktivní zprávy jsou zprávy ve frontě nebo odběru, které jsou v aktivním stavu a připravené k doručení. Zprávy jsou k dispozici k přijetí. Název entity
Nedoručené zprávy No Počet Průměr Počet nedoručených zpráv ve frontě nebo tématu Název entity
Plánované zprávy No Počet Průměr Počet naplánovaných zpráv ve frontě nebo tématu Název entity
Dokončené zprávy Ano Počet Celkem Počet zpráv dokončených v zadaném období. Název entity
Opuštěné zprávy Ano Počet Celkem Počet zpráv opuštěných během zadaného období. Název entity
Velikost No Přijaté Průměr Velikost entity (fronty nebo tématu) v bajtech Název entity

Důležité

Hodnoty pro zprávy, aktivní, nedoručené, naplánované, dokončené a opuštěné zprávy jsou hodnoty k určitému bodu v čase. Příchozí zprávy, které byly spotřebovány okamžitě po tomto bodu v čase, se nemusí v těchto metrikách projevit.

Poznámka:

Když se klient pokusí získat informace o frontě nebo tématu, vrátí služba Service Bus některé statické informace, jako je název, čas poslední aktualizace, čas vytvoření, vyžaduje relaci nebo ne atd., a některé dynamické informace, jako jsou počty zpráv. Pokud se požadavek omezí, vrátí služba statické informace a prázdné dynamické informace. Proto se počty zpráv zobrazují jako 0, když je obor názvů omezený. Toto chování je záměrné.

metriky Připojení ion

Název metriky Exportovatelné prostřednictvím nastavení diagnostiky Unit Typ agregace Popis Dimenze
Aktivní připojení No Počet Celkem Počet aktivních připojení v oboru názvů a entitě v oboru názvů. Hodnota pro tuto metriku je hodnota k určitému bodu v čase. Připojení, které byly aktivní okamžitě po tomto bodu v čase, se nemusí promítnout do metriky.
Otevřené Připojení ions No Počet Průměr Počet otevřenýchpřipojeních Hodnota pro tuto metriku je agregace a zahrnuje všechna připojení otevřená v časovém intervalu agregace. Název entity
Připojení iony zavřené No Počet Průměr Počet uzavřených připojení. Hodnota pro tuto metriku je agregace a zahrnuje všechna připojení otevřená v časovém intervalu agregace. Název entity

Metriky využití prostředků

Poznámka:

Následující metriky jsou k dispozici pouze s úrovní Premium .

Důležité metriky pro monitorování výpadků oboru názvů úrovně Premium jsou: využití procesoru na obor názvů a velikost paměti na obor názvů. Nastavte upozornění na tyto metriky pomocí služby Azure Monitor.

Další metrika, kterou byste mohli monitorovat, je: omezené požadavky. Nemělo by to být problém, ale pokud obor názvů zůstane v rámci limitů paměti, procesoru a zprostředkovaných připojení. Další informace najdete v tématu Omezování na úrovni Premium služby Azure Service Bus.

Název metriky Exportovatelné prostřednictvím nastavení diagnostiky Unit Typ agregace Popis Dimenze
Využití procesoru na obor názvů No Procesor Procenta Procento využití procesoru oboru názvů. Replika
Využití velikosti paměti na obor názvů No Využití paměti Procenta Procento využití paměti oboru názvů. Replika

Metriky chyb

Název metriky Exportovatelné prostřednictvím nastavení diagnostiky Unit Typ agregace Popis Dimenze
Chyby serveru No Počet Celkem Počet požadavků, které se nezpracovávají kvůli chybě ve službě Service Bus v zadaném období Název entity

Výsledek operace
Chyby uživatele No Počet Celkem Počet požadavků, které se nezpracovávají kvůli chybám uživatelů v zadaném období. Název entity

Výsledek operace

Rozměry metrik

Azure Service Bus podporuje následující dimenze pro metriky ve službě Azure Monitor. Přidání dimenzí do metrik je volitelné. Pokud dimenze nepřidáte, metriky se zadají na úrovni oboru názvů.

Název dimenze Popis
Název entity Service Bus podporuje entity zasílání zpráv v oboru názvů. U metriky Příchozí požadavky bude dimenze Název entity kromě všech vašich front a témat obsahovat hodnotu -NamespaceOnlyMetric-. Představuje požadavek, který byl proveden na úrovni oboru názvů. Mezi příklady patří požadavek na výpis všech front/témat v rámci oboru názvů nebo požadavků na entity, které selhaly při ověřování nebo autorizaci.

Protokoly prostředků

Tato část obsahuje seznam typů protokolů prostředků, které můžete shromažďovat pro Službu Azure Service Bus.

  • Provozní protokoly
  • Protokoly filtrování virtuální sítě a IP adres
  • Protokoly auditu modulu runtime

Azure Service Bus teď má možnost odesílat protokoly do jedné ze dvou cílových tabulek – Tabulky specifické pro Diagnostiku Azure nebo prostředky v Log Analytics. K výběru cílových tabulek můžete použít přepínač dostupný na webu Azure Portal.

Snímek obrazovky s dialogovým oknem pro nastavení cílové tabulky

Provozní protokoly

Položky provozního protokolu zahrnují prvky uvedené v následující tabulce:

Název Popis Podporováno ve službě AzureDiagnostics Podporováno v AZMSOperationalLogs (tabulka specifická pro prostředky)
ActivityId Interní ID používané k identifikaci zadané aktivity Ano Yes
EventName Název operace Ano Yes
ResourceId ID prostředku Azure Resource Manageru Ano Yes
SubscriptionId Subscription ID Ano Yes
EventtimeString Čas operace Yes No
TimeGenerated [UTC] Čas provedení operace (v UTC) No Ano
EventProperties Vlastnosti operace Ano Yes
Status Stav operace Ano Yes
Caller Volající operace (azure portal nebo klient pro správu) Ano Yes
Provider Název služby vygenerující protokoly, například ServiceBus No Ano
Type Typ vygenerovaných protokolů No Ano
Category Kategorie protokolu Yes No

Tady je příklad řetězce JSON provozního protokolu:

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


Položka tabulky specifická pro zdroj:


{

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

}

Události a operace zachycené v provozních protokolech

Provozní protokoly zaznamenávají všechny operace správy prováděné v oboru názvů služby Azure Service Bus. Operace s daty se nezachytávají kvůli velkému objemu datových operací, které se provádějí ve službě Azure Service Bus.

Poznámka:

Pokud chcete lépe sledovat operace s daty, doporučujeme použít trasování na straně klienta.

V provozních protokolech se zaznamenávají následující operace správy:

Obor Operace
Obor názvů – Vytvořit obor názvů
– Aktualizovat obor názvů
- Odstranit obor názvů
– Aktualizovat obor názvů
– Načtení oboru názvů
– Zásady sdílené technologieAccess
Fronta – Vytvořit frontu
- Aktualizovat frontu
- Odstranit frontu
– Automatická odstranění fronty
– Načtení fronty
Téma - Vytvořit téma
- Aktualizovat téma
- Odstranit téma
- AutoDelete Odstranit téma
- Načíst téma
Předplatné – Vytvoření předplatného
– Aktualizace předplatného
- Odstranit předplatné
– Automatické odstranění předplatného
– Načtení předplatného

Poznámka:

Operace čtení se v provozních protokolech v současné době nesledují.

Protokoly filtrování virtuální sítě a IP adres

Json události připojení služby Service Bus (VNet) obsahuje prvky uvedené v následující tabulce:

Název Popis Podporováno v Diagnostice Azure Podporováno v AZMSVnet Připojení ionEvents (tabulka specifická pro prostředky)
SubscriptionId ID předplatného Azure Ano Yes
NamespaceName Název oboru názvů Ano Yes
IPAddress IP adresa klienta, který se připojuje ke službě Service Bus Ano Yes
AddressIP IP adresa klienta, který se připojuje ke službě Service Bus Ano Yes
TimeGenerated [UTC] Čas provedení operace (v UTC) Ano Yes
Action Akce provedená službou Service Bus při vyhodnocování požadavků na připojení Podporované akce jsou akce Přijmout Připojení ion a Odepřít Připojení. Ano Yes
Reason Poskytuje důvod, proč byla akce provedena. Ano Yes
Count Počet výskytů dané akce Ano Yes
ResourceId ID prostředku Azure Resource Manageru Ano Yes
Category Kategorie protokolu Yes No
Provider Název služby vygenerující protokoly, například ServiceBus No Ano
Type Typ vygenerovaných protokolů No Ano

Poznámka:

Protokoly virtuální sítě se generují jenom v případě, že obor názvů povoluje přístup z vybraných sítí nebo z konkrétních IP adres (pravidla filtru IP adres).

Tady je příklad řetězce JSON protokolu virtuální sítě:

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

Položka tabulky specifická pro zdroj:

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

Protokoly auditu modulu runtime

Protokoly auditu modulu runtime zaznamenávají agregované diagnostické informace pro různé operace přístupu roviny dat (například odesílání nebo přijímání zpráv) ve službě Service Bus.

Poznámka:

Protokoly auditu modulu runtime jsou aktuálně k dispozici pouze na úrovni Premium .

Protokoly auditu modulu runtime zahrnují prvky uvedené v následující tabulce:

Název Popis Podporováno v Diagnostice Azure Podporováno v AZMSRuntimeAuditLogs (tabulka specifická pro prostředky)
ActivityId Náhodně vygenerované UUID, které zajišťuje jedinečnost aktivity auditu. Ano Yes
ActivityName Název operace modulu runtime. Ano Yes
ResourceId Prostředek přidružený k aktivitě Ano Yes
Timestamp Čas agregace Yes No
time Generated (UTC) Agregovaný čas No Ano
Status Stav aktivity (úspěch nebo selhání) Ano Yes
Protocol Typ protokolu přidruženého k operaci. Ano Yes
AuthType Typ ověřování (microsoft Entra ID nebo zásady SAS) Ano Yes
AuthKey ID aplikace Microsoft Entra nebo název zásady SAS, který se používá k ověření prostředku. Ano Yes
NetworkType Typ síťového přístupu: Public neboPrivate. ano Yes
ClientIP IP adresa klientské aplikace. Ano Yes
Count Celkový počet operací provedených během agregovaného období 1 minuty Ano Yes
Properties Metadata specifická pro operaci roviny dat. ano Yes
Category Kategorie protokolu Yes No
Provider Název služby vygenerující protokoly, například ServiceBus No Ano
Type Typ vygenerovaných protokolů No Ano

Tady je příklad položky protokolu auditu modulu runtime:

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

Položka tabulky specifická pro zdroj:

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

Diagnostické protokoly chyb

Diagnostické protokoly chyb zaznamenávají chybové zprávy pro všechny strany klienta, omezování a chyby překročení kvóty. Poskytují podrobnou diagnostiku identifikace chyb.

Protokoly diagnostických chyb obsahují prvky uvedené v následující tabulce:

Název Popis Podporováno v Diagnostice Azure Podporováno v AZMSDiagnosticErrorLogs (tabulka specifická pro prostředky)
ActivityId Náhodně vygenerované UUID, které zajišťuje jedinečnost aktivity auditu. Ano Yes
ActivityName Název operace Ano Yes
NamespaceName Název oboru názvů Ano ano
EntityType Typ entity Ano Yes
EntityName Název entity Ano Yes
OperationResult Typ chyby v operaci (Chyba klienta nebo Serverbusy nebo kvótaexceeded) Ano Yes
ErrorCount Počet identických chyb během agregačního období 1 minuty Ano Yes
ErrorMessage Podrobná chybová zpráva Ano Yes
Provider Název služby vygenerující protokoly Možné hodnoty: eventhub, relay a servicebus Ano Yes
Time Generated (UTC) Doba provozu No Ano
EventTimestamp Čas operace Yes No
Category Kategorie protokolu Yes No
Type Typ vygenerovaných protokolů No Ano

Tady je příklad položky diagnostického protokolu chyb:

{
    "ActivityId": "0000000000-0000-0000-0000-00000000000000",
    "SubscriptionId": "<Azure Subscription Id",
    "NamespaceName": "Name of Service Bus Namespace",
    "EntityType": "Queue",
    "EntityName": "Name of Service Bus Queue",
    "ActivityName": "SendMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
    "OperationResult": "ClientError",
    "ErrorCount": 1,
    "EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
    "ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
    "category": "DiagnosticErrorLogs"
 }

Položka tabulky specifická pro zdroj:

{
    "ActivityId": "0000000000-0000-0000-0000-00000000000000",
    "NamespaceName": "Name of Service Bus Namespace",
    "EntityType": "Queue",
    "EntityName": "Name of Service Bus Queue",
    "ActivityName": "SendMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
    "OperationResult": "ClientError",
    "ErrorCount": 1,
    "TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
    "ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
    "Type": "AZMSDiagnosticErrorLogs"
 }

Dne 30. září 2026 vyřadíme podporu protokolu SBMP pro Azure Service Bus, takže tento protokol už nebudete moct používat po 30. září 2026. Migrujte na nejnovější knihovny sady SDK služby Azure Service Bus pomocí protokolu AMQP, který nabízí důležité aktualizace zabezpečení a vylepšené funkce před tímto datem.

Další informace najdete v oznámení o vyřazení podpory.

Tabulky protokolů služby Azure Monitor

Azure Service Bus používá tabulky Kusto z protokolů služby Azure Monitor. Tyto tabulky můžete dotazovat pomocí Log Analytics. Seznam tabulek Kusto, které služba používá, najdete v referenčních informacích k tabulkám protokolů služby Azure Monitor.

Další kroky