Referência de dados do monitoramento do Barramento de Serviço do Azure
Confira Monitoramento do Barramento de Serviço do Azure para obter detalhes sobre como coletar e analisar os dados de monitoramento do Barramento de Serviço do Azure.
Observação
O Azure Monitor não inclui dimensões nos dados de métrica exportados enviados a um destino, como o Armazenamento do Azure, os Hubs de Eventos do Azure, o Log Analytics etc.
Métricas
Esta seção lista todas as métricas da plataforma coletadas automaticamente do Barramento de Serviço do Azure. O provedor de recursos dessas métricas é Microsoft.ServiceBus/namespaces.
Métricas de solicitação
Conta o número de solicitações de gerenciamento de dados e de operações.
Nome da métrica | Exportável por meio das configurações de diagnóstico | Unidade | Tipo de agregação | Descrição | Dimensões |
---|---|---|---|---|---|
Solicitações de entrada | Sim | Contagem | Total | O número de solicitações feitas ao serviço de Barramento de Serviço durante um período específico. | EntityName |
Solicitações bem sucedidas | Não | Contagem | Total | O número de solicitações bem-sucedidas feitas ao serviço de Barramento de Serviço durante um período específico. | Nome da entidade OperationResult |
Erros do Servidor | Não | Contagem | Total | O número de solicitações não processadas devido a um erro no serviço de Barramento de Serviço durante um período específico. | Nome da entidade OperationResult |
Erros de Usuário | Não | Contagem | Total | O número de solicitações não processadas devido a erros do usuário durante um período específico. | Nome da entidade |
Solicitações Limitadas | Não | Contagem | Total | O número de solicitações que foram restringidas porque o uso foi excedido. A dimensão MessagingErrorSubCode tem os seguintes valores possíveis:
|
Nome da entidade MessagingErrorSubCode |
Contagem de operações de ponto de verificação pendentes | No | count | Média | O número de operações de ponto de verificação pendentes no namespace. O serviço começa a ser limitado quando a contagem de pontos de verificação pendentes excede o limite de operações (500.000 + (500.000 * unidades de mensagem)). Essa métrica se aplica somente a namespaces que usam a camada Premium. | MessagingErrorSubCode |
Latência de envio do servidor | No | milissegundos | Média | O tempo gasto pelo serviço de Barramento de Serviço para concluir a solicitação. | Nome da entidade |
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
Nome da métrica | Exportável por meio das configurações de diagnóstico | Unidade | Tipo de agregação | Descrição | Dimensões |
---|---|---|---|---|---|
Mensagens de entrada | Sim | Contagem | Total | O número de eventos ou mensagens enviadas para o Barramento de Serviço durante um período específico. Para as camadas básica e standard, as mensagens de entrada encaminhadas automaticamente são incluídas nessa métrica. E, para a camada premium, elas não estão incluídas. | Nome da entidade |
Mensagens de saída | Sim | Contagem | Total | O número de eventos ou mensagens recebidas do Barramento de Serviço durante um período específico. As mensagens de saída encaminhadas automaticamente não estão incluídas nessa métrica. | Nome da entidade |
Mensagens | Não | Contagem | Média | Contagem de mensagens em uma fila/tópico. Essa métrica inclui mensagens em todos os diferentes estados, como ativas, com mensagens mortas, agendadas etc. | Nome da entidade |
Mensagens ativas | Não | Contagem | Média | Contagem de mensagens ativas em uma fila/tópico. Mensagens ativas são as mensagens na fila ou na assinatura que estão no estado ativo e prontas para entrega. As mensagens estão disponíveis para serem recebidas. | Nome da entidade |
Mensagens mortas | Não | Contagem | Média | Contagem de mensagens mortas em uma fila/um tópico. | Nome da entidade |
Mensagens agendadas | Não | Contagem | Média | Contagem de mensagens agendadas em uma fila/um tópico. | Nome da entidade |
Mensagens concluídas | Sim | Contagem | Total | O número de mensagens concluídas durante um período especificado. | Nome da entidade |
Mensagens abandonadas | Sim | Contagem | Total | O número de mensagens abandonadas durante um período especificado. | Nome da entidade |
Tamanho | Não | Bytes | Média | Tamanho de uma entidade (fila ou tópico) em bytes. | Nome da entidade |
Importante
Os valores para mensagens, mensagens ativas, inativas, agendadas, concluídas e abandonadas são valores pontuais. As mensagens de entrada consumidas imediatamente após esse ponto podem não estar refletidas nas métricas.
Observação
Quando um cliente tenta obter as informações sobre uma fila ou tópico, o serviço do Barramento de Serviço retorna algumas informações estáticas, como nome, hora da última atualização, hora da criação, sessão necessária ou não etc. Além de algumas informações dinâmicas, como número de mensagens. Se a solicitação for limitada, o serviço retornará as informações estáticas e as informações dinâmicas vazias. É por isso que o número de mensagens é mostrado como 0 quando o namespace está sendo limitado. Este comportamento ocorre por design.
Métricas de conexão
Nome da métrica | Exportável por meio das configurações de diagnóstico | Unidade | Tipo de agregação | Descrição | Dimensões |
---|---|---|---|---|---|
Conexões ativas | Não | Contagem | Total | O número de conexões ativas em um namespace, bem como em uma entidade no namespace. O valor dessa métrica é um valor pontual. As conexões que estavam ativas imediatamente após esse ponto podem não ser refletidas na métrica. | |
Conexões Abertas | Não | Contagem | Média | O número de conexões abertas. O valor dessa métrica é uma agregação e inclui todas as conexões que foram abertas na janela de tempo de agregação. | Nome da entidade |
Conexões Fechadas | Não | Contagem | Média | O número de conexões fechadas. O valor dessa métrica é uma agregação e inclui todas as conexões que foram abertas na janela de tempo de agregação. | Nome da entidade |
Métricas de uso de recurso
Observação
As métricas 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
Nome da métrica | Exportável por meio das configurações de diagnóstico | Unidade | Tipo de agregação | Descrição | Dimensões |
---|---|---|---|---|---|
Uso da CPU por namespace | Não | CPU | Porcentagem | A porcentagem de uso da CPU do namespace. | Réplica |
Uso do tamanho da memória por namespace | Não | Uso de Memória | Porcentagem | A porcentagem de uso de memória do namespace. | Réplica |
Métricas de erro
Nome da métrica | Exportável por meio das configurações de diagnóstico | Unidade | Tipo de agregação | Descrição | Dimensões |
---|---|---|---|---|---|
Erros do Servidor | Não | Contagem | Total | O número de solicitações não processadas devido a um erro no serviço de Barramento de Serviço durante um período específico. | Nome da entidade Resultado da Operação |
Erros do usuário | Não | Contagem | Total | O número de solicitações não processadas devido a erros do usuário durante um período específico. | Nome da entidade Resultado da Operação |
Dimensões de métrica
O Barramento de Serviço do Azure dá suporte às seguintes dimensões para métricas no Azure Monitor. Adicionar dimensões às métricas é opcional. Se você não adicionar dimensões, as métricas serão especificadas no nível de namespace.
Nome da dimensão | Descrição |
---|---|
Nome da entidade | O Barramento de Serviço dá suporte a entidades de mensagens no namespace. Com a métrica "Solicitações de Entrada", a dimensão Nome da entidade terá um valor de '-NamespaceOnlyMetric-' além de todas as suas filas e tópicos. Isso 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. |
Logs de recursos
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:
Nome | Descrição | Com suporte em AzureDiagnostics | Com suporte em AZMSOperationalLogs (tabela específica ao recurso) |
---|---|---|---|
ActivityId |
ID interna, usada para identificar a atividade especificada | Sim | Yes |
EventName |
Nome da operação | Sim | Yes |
ResourceId |
ID de recurso do Azure Resource Manager | Sim | Yes |
SubscriptionId |
ID da assinatura | Sim | Yes |
EventtimeString |
Hora da operação | Sim | Não |
TimeGenerated [UTC] |
Hora da operação executada (em UTC) | Não | Sim |
EventProperties |
Propriedades da operação | Sim | Yes |
Status |
Status da operação | Sim | Yes |
Caller |
Chamador da operação (portal do Azure ou cliente de gerenciamento) | Sim | Yes |
Provider |
Nome do serviço que emite os logs, por exemplo, ServiceBus | Não | Sim |
Type |
Tipos de log emitidos | Não | Sim |
Category |
Categoria do Log | Sim | Não |
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 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 ao 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 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.
Observação
Para ajudá-lo a acompanhar melhor as operações de dados, é recomendável usar o rastreamento do lado do cliente.
As seguintes operações de gerenciamento são capturadas em logs operacionais:
Escopo | Operação |
---|---|
Namespace | - Criar Namespace - Atualizar Namespace - Excluir Namespace - Atualizar Namespace - Recuperar Namespace - Política SharedAccess |
Fila | - Criar Fila - Atualizar Fila - Excluir Fila - Excluir Fila de Exclusão Automática - Recuperar Fila |
Tópico | - Criar Tópico - Atualizar Tópico - Excluir Tópico - Excluir Tópico de Exclusão Automática - Recuperar Tópico |
Subscription | - Criar Assinatura - Atualizar Assinatura - Excluir Assinatura - Excluir Assinatura de Exclusão Automática - Recuperar Assinatura |
Observação
Atualmente, as operações de Leitura não são acompanhadas nos logs operacionais.
Logs de filtragem de IP e rede virtual
O evento JSON de conexão de VNet (rede virtual) do Barramento de Serviço inclui elementos listados na tabela a seguir:
Nome | Descrição | Com suporte no Diagnóstico do Azure | Com suporte no AZMSVnetConnectionEvents (tabela específica ao recurso) |
---|---|---|---|
SubscriptionId |
ID de assinatura do Azure | Sim | Yes |
NamespaceName |
Nome do namespace | Sim | Yes |
IPAddress |
Endereço IP de um cliente que se conecta ao serviço de Barramento de Serviço | Sim | Yes |
AddressIP |
Endereço IP do cliente que está se conectando ao barramento de serviço | Sim | Yes |
TimeGenerated [UTC] |
Hora da operação executada (em UTC) | Sim | Yes |
Action |
Ação feita pelo serviço de Barramento de Serviço ao avaliar solicitações de conexão. As ações com suporte são Aceitar conexão e Negar conexão. | Sim | Yes |
Reason |
Fornece um motivo pelo qual a ação foi feita | Sim | Yes |
Count |
Número de ocorrências para a ação especificada | Sim | Yes |
ResourceId |
ID do Recurso do Azure Resource Manager. | Sim | Yes |
Category |
Categoria do Log | Sim | Não |
Provider |
Nome do serviço que emite os logs, por exemplo, ServiceBus | Não | Sim |
Type |
Tipos de Log Emitidos | Não | Sim |
Observação
Logs de rede virtual são gerados apenas quando o namespace permite o acesso de redes selecionadas ou de endereços IP específicos (regras de filtro de IP).
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.
Observação
Os logs de auditoria de runtime estão atualmente disponíveis apenas na camada Premium.
Os logs de auditoria de runtime incluem os elementos listados na tabela abaixo:
Name | Descrição | Com suporte no Diagnóstico do Azure | Com suporte em AZMSRuntimeAuditLogs (tabela específica ao recurso) |
---|---|---|---|
ActivityId |
Uma UUID gerada aleatoriamente que garante a exclusividade da atividade de auditoria. | Sim | Yes |
ActivityName |
Nome da operação de runtime. | Sim | Yes |
ResourceId |
Recursos associados à atividade. | Sim | Yes |
Timestamp |
Tempo de agregação. | Sim | Não |
time Generated (UTC) |
Tempo agregado | Não | Sim |
Status |
Status da atividade (êxito ou falha). | Sim | Yes |
Protocol |
Tipo de protocolo associado à operação. | Sim | Yes |
AuthType |
Tipo de autenticação (Microsoft Entra ID ou política de SAS). | Sim | Yes |
AuthKey |
A ID de aplicativo do Microsoft Entra ou o nome da política de SAS que é usado para autenticar em um recurso. | Sim | Yes |
NetworkType |
Tipo de acesso à rede: Public ou Private . |
sim | Yes |
ClientIP |
Endereço IP do aplicativo cliente. | Sim | Yes |
Count |
Número total de operações realizadas durante o período agregado de um minuto. | Sim | Yes |
Properties |
Metadados específicos para a operação do plano de dados. | sim | Yes |
Category |
Categoria do log | Sim | Não |
Provider |
Nome do serviço que emite os logs, por exemplo, ServiceBus | Não | Sim |
Type |
Tipos de Log emitidos | Não | Sim |
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 excedidos de cota. Eles fornecem diagnósticos detalhados para identificação de erros.
Os logs de erros de diagnóstico incluem elementos listados na tabela abaixo:
Nome | Descrição | Com suporte no Diagnóstico do Azure | Com suporte em AZMSDiagnosticErrorLogs (tabela específica do recurso) |
---|---|---|---|
ActivityId |
Uma UUID gerada aleatoriamente que garante a exclusividade da atividade de auditoria. | Sim | Yes |
ActivityName |
Nome da operação | Sim | Yes |
NamespaceName |
Nome do namespace | Sim | sim |
EntityType |
Tipo de Entidade | Sim | Yes |
EntityName |
Nome da Entidade | Sim | Yes |
OperationResult |
Tipo de erro na Operação (Clienterror ou Serverbusy ou quotaexceed) | Sim | Yes |
ErrorCount |
Contagem de erros idênticos durante o período de agregação de 1 minuto. | Sim | Yes |
ErrorMessage |
Mensagem de erro detalhada | Sim | Yes |
Provider |
Nome do Serviço que emite os logs. Valores possíveis: eventhub, relay e servicebus | Sim | Yes |
Time Generated (UTC) |
Tempo de operação | Não | Sim |
EventTimestamp |
Hora da operação | Sim | Não |
Category |
Categoria do log | Sim | Não |
Type |
Tipos de Log emitidos | Não | Sim |
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 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"
}
Em 30 de setembro de 2026, desativaremos o suporte do protocolo SBMP para o Barramento de Serviço do Azure, portanto, não será mais possível usar esse protocolo após essa data. 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.
Tabelas de Logs do Azure Monitor
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. Para ver uma lista de tabelas Kusto que o serviço usa, confira a referência de tabela dos logs do Azure Monitor.
Próximas etapas
- Para obter detalhes sobre o monitoramento do Barramento de Serviço do Azure, confira Monitoramento do Barramento de Serviço do Azure.
- Veja Monitorar os recursos do Azure com o Azure Monitor para obter detalhes sobre o monitoramento de recursos do Azure.