Monitorização Hubs de Eventos do Azure referência de dados

Veja Monitorizar Hubs de Eventos do Azure para obter detalhes sobre como recolher e analisar dados de monitorização para Hubs de Eventos do Azure.

Nota

O Azure Monitor não inclui dimensões nos dados de métricas exportadas, que são enviados para um destino como o Armazenamento do Azure, o Hubs de Eventos do Azure, o Log Analytics, etc.

Métricas

Esta secção lista todas as métricas de plataforma recolhidas automaticamente para Hubs de Eventos do Azure. O fornecedor de recursos para estas métricas é Microsoft.EventHub/clusters ou Microsoft.EventHub/namespaces.

Pedir métricas

Conta o número de pedidos de operações de gestão e dados.

Nome da Métrica Exportável através das definições de diagnóstico Unidade Tipo de agregação Description Dimensões
Pedidos Recebidos Yes de palavras de palavras O número de pedidos feitos ao serviço dos Hubs de Eventos durante um período especificado. Esta métrica inclui todas as operações do plano de gestão e dados. Nome da entidade
Pedidos Com Êxito No de palavras de palavras O número de pedidos bem-sucedidos feitos ao serviço dos Hubs de Eventos durante um período especificado. Nome da entidade

Resultado da Operação
Pedidos Limitados No de palavras de palavras O número de pedidos que foram limitados porque a utilização foi excedida. Nome da entidade

Resultado da Operação

Os dois tipos de erros seguintes são classificados como erros de utilizador:

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

Métricas de mensagens

Nome da Métrica Exportável através das definições de diagnóstico Unidade Tipo de agregação Description Dimensões
Mensagens Recebidas Yes de palavras de palavras O número de eventos ou mensagens enviadas para os Hubs de Eventos durante um período especificado. Nome da entidade
Mensagens Enviadas Yes de palavras de palavras O número de eventos ou mensagens recebidos dos Hubs de Eventos durante um período especificado. Nome da entidade
Mensagens Capturadas No de palavras de palavras O número de mensagens capturadas. Nome da entidade
Bytes recebidos Yes Bytes de palavras Bytes recebidos para um hub de eventos durante um período especificado. Nome da entidade
Bytes Enviados Yes Bytes de palavras Bytes de saída para um hub de eventos durante um período especificado. Nome da entidade
Tamanho No Bytes Média Tamanho de um hub de eventos em bytes. Nome da entidade

Nota

  • Estes valores são valores para um ponto anterior no tempo. As mensagens recebidas que foram consumidas imediatamente após esse ponto anterior no tempo podem não ser refletidas nestas métricas.
  • A métrica Pedidos recebidos inclui todas as operações do plano de gestão e dados. A métrica Mensagens recebidas dá-lhe o número total de eventos que são enviados para o hub de eventos. Por exemplo, se enviar um lote de 100 eventos para um hub de eventos, será contabilizado como 1 pedido recebido e 100 mensagens recebidas.

Capturar métricas

Nome da Métrica Exportável através das definições de diagnóstico Unidade Tipo de agregação Description Dimensões
Mensagens Capturadas No de palavras de palavras O número de mensagens capturadas. Nome da entidade
Bytes Capturados No Bytes de palavras Bytes capturados para um hub de eventos Nome da entidade
Registo de Tarefas Pendentes de Capturas No de palavras de palavras Registo de tarefas pendentes de captura de um hub de eventos Nome da entidade

Métricas de ligação

Nome da Métrica Exportável através das definições de diagnóstico Unidade Tipo de agregação Description Dimensões
Ligações Ativas No de palavras Média O número de ligações ativas num espaço de nomes e numa entidade (hub de eventos) no espaço de nomes. O valor para esta métrica é um valor para um ponto anterior no tempo. As ligações que estavam ativas imediatamente após esse ponto anterior no tempo podem não ser refletidas na métrica. Nome da entidade
Ligações Abertas No de palavras Média O número de ligações abertas. Nome da entidade
Ligações Fechadas No de palavras Média O número de ligações fechadas. Nome da entidade

Métricas de erro

Nome da Métrica Exportável através das definições de diagnóstico Unidade Tipo de agregação Description Dimensões
Erros do Servidor No de palavras de palavras O número de pedidos não processados devido a um erro no serviço Hubs de Eventos durante um período especificado. Nome da entidade

Resultado da Operação
Erros do Utilizador No de palavras de palavras O número de pedidos não processados devido a erros de utilizador durante um período especificado. Nome da entidade

Resultado da Operação
Erros de Quota Excedida No de palavras de palavras O número de erros causados por quotas excedidas durante um período especificado. Nome da entidade

Resultado da Operação

Nota

O Logic Apps cria recetores e recetores de época que podem ser movidos de um nó para outro, dependendo da carga do serviço. Durante essas movimentações, ReceiverDisconnection podem ocorrer exceções. São contabilizados como erros do utilizador no lado do serviço Dos Hubs de Eventos. O Logic Apps pode recolher falhas de clientes dos Hubs de Eventos para que possa vê-las nos registos de utilizadores.

Dimensões das métricas

Hubs de Eventos do Azure suporta as seguintes dimensões para métricas no Azure Monitor. Adicionar dimensões às métricas é opcional. Se não adicionar dimensões, as métricas são especificadas ao nível do espaço de nomes.

Nome da dimensão Description
Nome da Entidade Nome do hub de eventos.

Registos do recurso

Os Hubs de Eventos capturam registos de diagnóstico para as seguintes categorias:

Categoria Descrição
Registos de Arquivo Captura informações sobre operações de Captura de Hubs de Eventos , especificamente, registos relacionados com erros de captura.
Registos Operacionais Capture todas as operações de gestão executadas no espaço de nomes Hubs de Eventos do Azure. As operações de dados não são capturadas devido ao elevado volume de operações de dados realizadas no Hubs de Eventos do Azure.
Dimensionar automaticamente registos Captura operações de ampliação automática realizadas num espaço de nomes dos Hubs de Eventos.
Registos do coordenador do Kafka Captura operações de coordenação do Kafka relacionadas com os Hubs de Eventos.
Registos de erros de utilizador do Kafka Captura informações sobre as APIs do Kafka chamadas nos Hubs de Eventos.
Evento de ligação da rede virtual (VNet) dos Hubs de Eventos Captura informações sobre endereços IP e redes virtuais que enviam tráfego para os Hubs de Eventos.
Registos de utilizadores de chaves geridas pelo cliente Captura operações relacionadas com a chave gerida pelo cliente.

Todos os registos são armazenados no formato JavaScript Object Notation (JSON). Cada entrada tem campos de cadeia que utilizam o formato descrito nas secções seguintes.

Arquivar esquema de registos

As cadeias JSON de registo de arquivo incluem elementos listados na tabela seguinte:

Nome Descrição
TaskName Descrição da tarefa que falhou
ActivityId ID interno, utilizado para controlo
trackingId ID interno, utilizado para controlo
resourceId ID de recurso do Azure Resource Manager
eventHub Nome completo do hub de eventos (inclui o nome do espaço de nomes)
partitionId Partição do Hub de Eventos a ser escrita em
archiveStep valores possíveis: ArchiveFlushWriter, DestinationInit
startTime Hora de início da falha
failures Número de vezes que a falha ocorreu
durationInSeconds Duração da falha
message Mensagem de erro
category ArchiveLogs

O código seguinte é um exemplo de uma cadeia JSON de registo de arquivo:

{
   "TaskName": "EventHubArchiveUserError",
   "ActivityId": "000000000-0000-0000-0000-0000000000000",
   "trackingId": "0000000-0000-0000-0000-00000000000000000",
   "resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
   "eventHub": "<Event Hub full name>",
   "partitionId": "1",
   "archiveStep": "ArchiveFlushWriter",
   "startTime": "9/22/2016 5:11:21 AM",
   "failures": 3,
   "durationInSeconds": 360,
   "message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n   at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n   at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n   at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n   --- End of inner exception stack trace ---\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n   at System.",
   "category": "ArchiveLogs"
}

Esquema de registos operacionais

As cadeias JSON de registo operacional incluem elementos listados na tabela seguinte:

Nome Descrição
ActivityId ID interno, utilizado para fins de controlo
EventName nome da operação. Para obter uma lista de valores para este elemento, veja Os nomes dos eventos
resourceId ID de recurso do Azure Resource Manager
SubscriptionId ID da subscrição
EventTimeString Hora da operação
EventProperties Propriedades da operação. Este elemento fornece mais informações sobre o evento, conforme mostrado no exemplo seguinte.
Status Estado da operação. O valor pode ser Com Êxito ou Com Falhas.
Caller Autor da operação (portal do Azure ou cliente de gestão)
Category OperationalLogs

O código seguinte é um exemplo de uma cadeia JSON de registo operacional:

Example:
{
   "ActivityId": "00000000-0000-0000-0000-00000000000000",
   "EventName": "Create EventHub",
   "resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
   "SubscriptionId": "000000000-0000-0000-0000-000000000000",
   "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
   "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
   "Status": "Succeeded",
   "Caller": "ServiceBus Client",
   "category": "OperationalLogs"
}

Nomes de eventos

O nome do evento é preenchido como tipo de operação + tipo de recurso a partir das seguintes enumerações. Por exemplo, Create Queue, Retrieve Event Huou Delete Rule.

Tipo de operação Tipo de recurso
  • Criar
  • Atualizar
  • Eliminar
  • Obter
  • Desconhecido
  • Espaço de Nomes
  • Fila
  • Tópico
  • Subscrição
  • EventHub
  • EventHubSubscription
  • NotificationHub
  • NotificationHubTier
  • SharedAccessPolicy
  • UsageCredit
  • NamespacePnsCredentials
  • RegraGrupo de Consumidores

Esquema de registos de dimensionamento automático

O JSON de registo de dimensionamento automático inclui elementos listados na tabela seguinte:

Nome Descrição
TrackingId ID interno, que é utilizado para fins de rastreio
ResourceId ID de recurso do Azure Resource Manager.
Message Mensagem informativa, que fornece detalhes sobre a ação de ampliação automática. A mensagem contém o valor anterior e atual da unidade de débito para um determinado espaço de nomes e o que acionou a inflação do TU.

Eis um exemplo de evento de dimensionamento automático:

{
    "TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
    "Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name"
}

Esquema de registos do coordenador do Kafka

O registo de coordenador do Kafka JSON inclui elementos listados na tabela seguinte:

Nome Descrição
RequestId ID do Pedido, que é utilizado para fins de rastreio
ResourceId ID de recurso do Azure Resource Manager
Operation Nome da operação efetuada durante a coordenação do grupo
ClientId ID de Cliente
NamespaceName Nome do espaço de nomes
SubscriptionId ID da subscrição do Azure
Message Mensagem informativa ou de aviso, que fornece detalhes sobre as ações realizadas durante a coordenação do grupo.

Exemplo

{
    "RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
    "Operation": "Join.Start",
    "ClientId": "KafkaExampleConsumer#0",
    "Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Category": "KafkaCoordinatorLogs"
}

Esquema de registos de erros de utilizador do Kafka

O registo de erros do utilizador do Kafka JSON inclui elementos listados na tabela seguinte:

Nome Descrição
TrackingId ID de controlo, que é utilizado para fins de rastreio.
NamespaceName Nome do espaço de nomes
Eventhub Nome do hub de eventos
PartitionId ID de Partição
GroupId ID do Grupo
ClientId ID de Cliente
ResourceId ID de recurso do Azure Resource Manager.
Message Mensagem informativa, que fornece detalhes sobre um erro

Esquema de eventos de ligação de rede virtual dos Hubs de Eventos

O JSON do evento de ligação da rede virtual (VNet) dos Hubs de Eventos inclui elementos listados na tabela seguinte:

Nome Descrição
SubscriptionId ID da subscrição do Azure
NamespaceName Nome do espaço de nomes
IPAddress Endereço IP de um cliente que se liga ao serviço Hubs de Eventos
Action Ação efetuada pelo serviço Hubs de Eventos ao avaliar os pedidos de ligação. As ações suportadas são Aceitar Ligação e Negar Ligação.
Reason Fornece um motivo pelo qual a ação foi efetuada
Count Número de ocorrências para a ação especificada
ResourceId ID de recurso do Azure Resource Manager.

Os registos de rede virtual só são gerados se o espaço de nomes permitir o acesso a partir de redes selecionadas ou de endereços IP específicos (regras de filtro IP). Se não quiser restringir o acesso ao seu espaço de nomes com estas funcionalidades e continuar a querer obter registos de rede virtual para controlar os endereços IP dos clientes que se ligam ao espaço de nomes dos Hubs de Eventos, pode utilizar a seguinte solução. Ative a filtragem de IP e adicione o intervalo IPv4 endereçável total (1.0.0.0/1 - 255.0.0.0/1). A filtragem de IP dos Hubs de Eventos não suporta intervalos IPv6. Poderá ver endereços de ponto final privados no formato IPv6 no registo.

Exemplo

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Deny Connection",
    "Reason": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
    "Count": "65",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Category": "EventHubVNetConnectionEvent"
}

Esquema de registos de utilizadores chave gerida pelo cliente

O JSON do registo de utilizadores da chave gerida pelo cliente inclui elementos listados na seguinte tabela:

Nome Descrição
Category Tipo de categoria para uma mensagem. É um dos seguintes valores: erro e informações. Por exemplo, se a chave do cofre de chaves estiver a ser desativada, será uma categoria de informações ou se não for possível desembrulhar uma chave, poderá estar em erro.
ResourceId ID de recurso interno, que inclui o ID da subscrição do Azure e o nome do espaço de nomes
KeyVault Nome do recurso Key Vault
Key Nome da chave de Key Vault utilizada para encriptar o espaço de nomes dos Hubs de Eventos.
Version Versão da chave de Key Vault.
Operation A operação executada na chave no cofre de chaves. Por exemplo, desative/ative a chave, moldar ou desembrulhar.
Code O código associado à operação. Exemplo: o código de erro 404 significa que a chave não foi encontrada.
Message Mensagem, que fornece detalhes sobre um erro ou mensagem informativa

Eis um exemplo do registo de uma chave gerida pelo cliente:

{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111-1111-1111-1111-111111111111",
   "category": "error"
   "resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "1111111111111111111111111111111",
   "operation": "wrapKey",
   "code": "404",
   "message": "Key not found: ehbyok0/111111111111111111111111111111",
}



{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111111111-1111-1111-1111111111111",
   "category": "info"
   "resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "111111111111111111111111111111",
   "operation": "disable" | "restore",
   "code": "",
   "message": "",
}

Seguem-se os códigos de erro comuns a procurar quando a encriptação BYOK está ativada.

Ação Código de erro Estado resultante dos dados
Remover a permissão de moldagem/desembrulhar de um cofre de chaves 403 Inacessível
Remover a associação à função do AAD de um principal do AAD que concedeu a permissão wrap/unwrap 403 Inacessível
Eliminar uma chave de encriptação do cofre de chaves 404 Inacessível
Eliminar o cofre de chaves 404 Inacessível (pressupõe que a eliminação recuperável está ativada, que é uma definição necessária.)
Alterar o período de expiração na chave de encriptação de modo a que já tenha expirado 403 Inacessível
Alterar o NBF (não antes) de modo a que a chave de encriptação de chaves não esteja ativa 403 Inacessível
Selecionar a opção Permitir Serviços MSFT para a firewall do cofre de chaves ou bloquear o acesso de rede ao cofre de chaves que tem a chave de encriptação 403 Inacessível
Mover o cofre de chaves para um inquilino diferente 404 Inacessível
Problema de rede intermitente ou interrupção do DNS/AAD/MSI Acessível com a chave de encriptação de dados em cache

Registos de auditoria do runtime

Os registos de auditoria do runtime capturam informações de diagnóstico agregadas para todas as operações de acesso do plano de dados (como eventos de envio ou receção) nos Hubs de Eventos.

Nota

Os registos de auditoria do runtime só estão disponíveis em escalões premium e dedicados .

Os registos de auditoria do runtime incluem os elementos listados na tabela seguinte:

Nome Descrição
ActivityId Um UUID gerado aleatoriamente que garante a exclusividade da atividade de auditoria.
ActivityName Nome da operação runtime.
ResourceId Recurso associado à atividade.
Timestamp Hora da agregação.
Status Estado da atividade (êxito ou falha).
Protocol Tipo do protocolo associado à operação.
AuthType Tipo de autenticação (Azure Active Directory ou Política SAS).
AuthKey ID da aplicação do Azure Active Directory ou nome da política SAS que é utilizado para autenticar num recurso.
NetworkType Tipo de acesso à rede: Public ou Private.
ClientIP Endereço IP da aplicação cliente.
Count Número total de operações realizadas durante o período agregado de 1 minuto.
Properties Metadados específicos da operação do plano de dados.
Category Categoria do registo

Eis um exemplo de uma entrada de registo de auditoria de runtime:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
    "Time": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | KAFKA | HTTP | Web Sockets", 
    "AuthType": "SAS | Azure Active Directory", 
    "AuthId": "<AAD application name | SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1,
    "Category": "RuntimeAuditLogs"
 }

Registos de métricas da aplicação

Os registos de métricas da aplicação captam as informações agregadas em determinadas métricas relacionadas com as operações do plano de dados. As informações capturadas incluem as seguintes métricas de runtime.

Nota

Os registos de métricas da aplicação só estão disponíveis em escalões premium e dedicados . Registos da Métrica da Aplicação para as seguintes métricas– IncomingBytes. IncomingMessages ,OutgoingBytes ,OutgoingMessages só são gerados se já tiver criado Grupos de Aplicações no seu ambiente. Os Grupos de Aplicações devem ter o mesmo contexto de segurança - ID do AAD ou chave SAS, que está a ser utilizada para enviar/receber dados para Hubs de Eventos do Azure.

Nome Descrição
ConsumerLag Indique o desfasamento entre consumidores e produtores.
NamespaceActiveConnections Detalhes das ligações ativas estabelecidas de um cliente para o hub de eventos.
GetRuntimeInfo Obtenha informações de tempo de execução a partir dos Hubs de Eventos.
GetPartitionRuntimeInfo Obtenha as informações de runtime aproximadas para uma partição lógica de um hub de eventos.
IncomingMessages Detalhes do número de mensagens publicadas nos Hubs de Eventos.
IncomingBytes Detalhes do débito do Publisher enviado para os Hubs de Eventos
OutgoinMessages Detalhes do número de mensagens consumidas nos Hubs de Eventos.
OutgoingBytes Detalhes do débito do Consumidor a partir dos Hubs de Eventos.

Tabelas de Registos do Azure Monitor

Hubs de Eventos do Azure utiliza tabelas Kusto a partir dos Registos do Azure Monitor. Pode consultar estas tabelas com o Log Analytics. Para obter uma lista das tabelas kusto que o serviço utiliza, veja Referência da tabela de Registos do Azure Monitor.

Importante

As dimensões não são exportadas para uma área de trabalho do Log Analytics.

Passos seguintes