Referência de dados de monitoramento do Barramento de Serviço do Azure

Este artigo contém todas as informações de referência de monitoramento para este serviço.

Consulte Monitorar o Barramento de Serviço do Azure para obter detalhes sobre os dados que você pode coletar para o Barramento de Serviço e como usá-los.

Métrica

Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas da plataforma com suporte no Azure Monitor.

Para obter informações sobre retenção de métricas, consulte Visão geral das métricas do Azure Monitor.

Métricas com suporte para Microsoft.ServiceBus/Namespaces

A tabela a seguir lista as métricas disponíveis para o tipo de recurso Microsoft.ServiceBus/Namespaces.

• Nem todas as colunas podem estar presentes em todas as tabelas.
• Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para exibir todas as colunas disponíveis.

Títulos de tabela

• Categoria: o grupo ou classificação de métricas.
• Métrica: o nome de exibição da métrica como aparece no portal do Azure.
• Nome na API REST: o nome da métrica, conforme mencionado na API REST.
• Unidade: unidade de medida
• Agregação: o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
• Dimensões: as Dimensões disponíveis para a métrica.
• Intervalos de agregação: os Intervalos em que a métrica é amostrada. Por exemplo, PT1M indica que a métrica é amostrada a cada minuto, PT30M a cada 30 minutos, PT1H a cada hora e assim por diante.
• Exportação de DS: se a métrica é exportável para os Logs do Azure Monitor via configurações de diagnóstico. Para obter mais informações sobre exportação de métricas, consulte as Criar configurações de diagnóstico no Azure Monitor.

As seções a seguir fornecem descrições mais detalhadas das métricas apresentadas na seção anterior.

Métricas de solicitação

As métricas de solicitação contam o número de solicitações de dados e operações de gerenciamento.

Os dois tipos de erros abaixo são classificados como erros do usuário:

• Erros do lado do cliente (em HTTP, seriam os erros 400).
• Erros que ocorrem durante o processamento de mensagens, como MessageLockLostException.

Métricas de mensagens

As métricas a seguir são métricas de mensagem.

Métricas de conexão

As métricas a seguir são métricas de conexão.

Métricas de uso de recurso

As métricas de recursos a seguir estão disponíveis apenas com a camada premium.

As métricas importantes para monitorar interrupções em um namespace da camada Premium são: Uso da CPU por namespace e tamanho da memória por namespace. Configure alertas para essas métricas usando o Azure Monitor.

A outra métrica que você pode monitorar é: solicitações limitadas. Ela não deve ser um problema se o namespace permanecer dentro dos seus limites de memória, CPU e conexões agenciadas. Para obter mais informações, confira Limitação na camada Premium do Barramento de Serviço do Azure

Métricas de erro

As métricas a seguir são métricas de erro.

Métricas de replicação geográfica

As métricas a seguir são métricas de replicação geográfica:

Dimensões de métrica

Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.

Este serviço tem as dimensões a seguir associadas a essas métricas.

• O Barramento de Serviço EntityName dá suporte a entidades de mensagens no namespace. Com a métrica Solicitações de Entrada, a dimensão Nome da Entidade tem um valor além de -NamespaceOnlyMetric- todas as suas filas e tópicos. Esse valor representa a solicitação, que foi feita no nível do namespace. Os exemplos incluem uma solicitação para listar todas as filas/tópicos no namespace ou solicitações para entidades que falharam na autenticação ou autorização.
• MessagingErrorSubCode
• Resultado da operação
• Réplica

Logs de recursos

Esta seção lista os tipos de logs de recursos que você pode coletar para o este serviço. A seção extrai da lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.

Logs de recursos com suporte para Microsoft.ServiceBus/Namespaces

Esta seção lista os tipos de logs de recursos que você pode coletar para o Barramento de Serviço do Azure.

• Logs operacionais
• Logs de filtragem de IP e rede virtual
• Logs de auditoria de runtime

O Barramento de Serviço do Azure agora tem a capacidade de expedir logs para qualquer uma das duas tabelas de destino: tabelas específicas ao Diagnósticos do Azure ou ao Resource no Log Analytics. Você poderia usar o botão de alternância disponível no portal do Azure para escolher as tabelas de destino.

Logs operacionais

As entradas do log operacional incluem os elementos listados na seguinte tabela:

Este é um exemplo de uma cadeia de caracteres JSON do log operacional:

AzureDiagnostics:

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Create Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION 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"
}

Entrada de tabela específica ao recurso:

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Retrieve Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION 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"
}

Eventos e operações capturados nos logs de diagnóstico

Os logs operacionais capturam todas as operações de gerenciamento executadas no namespace do Barramento de Serviço do Azure. As operações de dados não são capturadas devido ao alto volume de operações de dados que são realizadas no Barramento de Serviço do Azure.

As seguintes operações de gerenciamento são capturadas em logs operacionais:

Logs de filtragem de IP e rede virtual

O JSON do evento de conexão de rede virtual do Barramento de Serviço inclui elementos listados na tabela a seguir:

Veja um exemplo de uma cadeia de caracteres JSON de log de rede virtual:

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

Entrada de tabela específica ao recurso:

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

Logs de auditoria de runtime

Os logs de auditoria do runtime capturam informações de diagnóstico agregadas de várias operações de acesso do plano de dados (como enviar ou receber mensagens) no Barramento de Serviço.

Os logs de auditoria de runtime incluem os elementos listados na tabela abaixo:

Veja um exemplo de uma entrada de log de auditoria de 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"
}

Entrada de tabela específica ao recurso:

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

Logs de erros de diagnóstico

Os logs de erros de diagnóstico capturam mensagens de erro para qualquer lado do cliente, limitação e erros de cota excedida. Eles fornecem diagnósticos detalhados para identificação de erros.

Os Logs de Erros de Diagnóstico incluem elementos listados nesta tabela:

Aqui está um exemplo de entrada de log de erros de diagnóstico:

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

Entrada de tabela específica ao recurso:

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

Tabelas de Logs do Azure Monitor

Esta seção lista todas as tabelas dos Logs do Azure Monitor relevantes para este serviço e disponíveis para consulta pela análise de logs usando o Kusto. As tabelas contêm dados de log de recursos e possivelmente mais, dependendo do que é coletado e roteado para elas.

Em 30 de setembro de 2026, desativaremos o suporte do protocolo SBMP para o Barramento de Serviço do Azure, para que você não possa mais usar esse protocolo após 30 de setembro de 2026. Migre para as bibliotecas mais recentes do SDK do Barramento de Serviço do Azure usando o protocolo AMQP, que oferece atualizações de segurança críticas e funcionalidades aprimoradas, antes dessa data.

Para obter mais informações, confira o anúncio de desativação do suporte.

O Barramento de Serviço do Azure usa as tabelas Kusto dos logs do Azure Monitor. Você pode consultar essas tabelas com o Log Analytics.

Barramento de Serviço Microsoft.ServiceBus/namespaces

• AzureActivity
• AzureMetrics
• AzureDiagnostics
• AZMSOperationalLogs
• AZMSVnetConnectionEvents
• AZMSRunTimeAuditLogs
• AZMSApplicationMetricLogs
• AZMSDiagnosticErrorLogs

Log de atividades

A tabela vinculada lista as operações que podem ser registradas no log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.

Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.

• Operações do provedor de recursos de integração

Conteúdo relacionado

• Consulte Monitorar o Barramento de Serviço do Azure para obter uma descrição do monitoramento do Barramento de Serviço.
• Confira Monitorar recursos do Azure com o Azure Monitor para ver informações detalhadas sobre o monitoramento dos recursos do Azure.