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á-lo.

Métricas

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

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

Métricas suportadas 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 visualizar todas as colunas disponíveis.

Cabeçalhos de tabela

• Categoria - O grupo ou classificação de métricas.
• Métrica - O nome para exibição da métrica conforme aparece no portal do Azure.
• Nome na API REST - O nome da métrica conforme referido na API REST.
• Unidade - Unidade de medida.
• Agregação - O tipo de agregação padrão. Valores válidos: Média (Média), Mínima (Mín), Máxima (Máx), Total (Soma), Contagem.
• Dimensões - Dimensões disponíveis para a métrica.
• Intervalos de grãos de - tempo 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.
• DS Export- Se a métrica é exportável para os Logs do Azure Monitor por meio de configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Criar configurações de diagnóstico no Azure Monitor.

As seções a seguir fornecem descrições mais detalhadas para as 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 a seguir são classificados como erros do usuário:

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

Métricas de mensagem

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 recursos

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

As métricas importantes a serem monitoradas para quaisquer interrupções de um namespace de 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. No entanto, isso não deve ser um problema, desde que o namespace permaneça dentro de seus limites de memória, CPU e conexões intermediadas. Para obter mais informações, consulte 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 métricas

Para obter informações sobre o que são dimensões métricas, consulte Métricas multidimensionais.

Este serviço tem as seguintes dimensões associadas às suas métricas.

• O EntityName Service Bus oferece suporte a entidades de mensagens sob o 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
• OperationResult
• Réplica

Registos do recurso

Esta seção lista os tipos de logs de recursos que você pode coletar para 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 suportados 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.

• Registos operacionais
• Rede virtual e logs de filtragem de IP
• Logs de auditoria de tempo de execução

O Barramento de Serviço do Azure agora tem a capacidade de despachar logs para qualquer uma das duas tabelas de destino - Diagnóstico do Azure ou tabelas específicas de recursos no Log Analytics. Você pode usar a alternância disponível no portal do Azure para escolher tabelas de destino.

Registos operacionais

As entradas do log operacional incluem elementos listados na tabela a seguir:

Aqui está um exemplo de uma cadeia de caracteres JSON de log operacional:

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

Entrada de tabela específica do recurso:

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

Eventos e operações capturados em logs operacionais

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 grande volume de operações de dados realizadas no Barramento de Serviço do Azure.

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

Rede virtual e logs de filtragem de IP

O evento JSON de conexão de rede virtual do Service Bus inclui elementos listados na tabela a seguir:

Aqui está 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 do 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 tempo de execução

Os logs de auditoria de tempo de execução capturam informações de diagnóstico agregadas para várias operações de acesso ao plano de dados (como enviar ou receber mensagens) no Service Bus.

Os logs de auditoria de tempo de execução incluem os elementos listados na tabela a seguir:

Aqui está um exemplo de uma entrada de log de auditoria de tempo de execução:

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

Registo de Erros de Diagnóstico

Os logs de erro 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 a 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 erro 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 do 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 as tabelas de Logs do Azure Monitor relevantes para este serviço, que estão disponíveis para consulta pelo Log Analytics usando consultas 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 ao protocolo SBMP para o Barramento de Serviço do Azure, portanto, você não poderá 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 oferecem atualizações de segurança críticas e recursos aprimorados, antes dessa data.

Para obter mais informações, consulte o anúncio de aposentadoria de suporte.

O Barramento de Serviço do Azure usa 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

Registo 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 possíveis do provedor de recursos no log de atividades.

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

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

Conteúdos relacionados

• Consulte Monitorar o Barramento de Serviço do Azure para obter uma descrição do monitoramento do Barramento de Serviço.
• Consulte Monitorar recursos do Azure com o Azure Monitor para obter detalhes sobre o monitoramento de recursos do Azure.