Referência de dados de monitoramento da entrega push de eventos da Grade de Eventos do Azure
Este artigo apresenta uma referência de dados de log e métricas coletados para analisar o desempenho e a disponibilidade da entrega push da Grade de Eventos do Azure.
Importante
Esse recurso está em VERSÃO PRÉVIA no momento.
Métrica
Microsoft.EventGrid/domains
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | Yes | Avaliações de filtro avançado | Contagem | Total | Total de filtros avançados avaliados nas assinaturas de evento para esse tópico. | Topic, EventSubscriptionName, DomainEventSubscriptionName |
| DeadLetteredCount | Yes | Eventos de mensagens mortas | Contagem | Total | Total de eventos de mensagens mortas correspondentes a essa assinatura de evento | Topic, EventSubscriptionName, DomainEventSubscriptionName, DeadLetterReason |
| DeliveryAttemptFailCount | Não | Eventos com falha de entrega | Contagem | Total | Total de eventos não entregues a essa assinatura de evento | Topic, EventSubscriptionName, DomainEventSubscriptionName, Error, ErrorType |
| DeliverySuccessCount | Yes | Eventos entregues | Contagem | Total | Total de eventos entregues a essa assinatura de evento | Topic, EventSubscriptionName, DomainEventSubscriptionName |
| DestinationProcessingDurationInMs | Não | Duração do processamento de destino | MilliSeconds | Média | Duração do processamento de destino em milissegundos | Topic, EventSubscriptionName, DomainEventSubscriptionName |
| DroppedEventCount | Yes | Eventos removidos | Contagem | Total | Total de eventos removidos correspondentes a essa assinatura de evento | Topic, EventSubscriptionName, DomainEventSubscriptionName, DropReason |
| MatchedEventCount | Yes | Eventos correspondentes | Contagem | Total | Total de eventos correspondentes a essa assinatura de evento | Topic, EventSubscriptionName, DomainEventSubscriptionName |
| PublishFailCount | Yes | Publicar Eventos com Falha | Contagem | Total | Total de eventos com falha ao publicar neste tópico | Topic, ErrorType, Error |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos publicados neste tópico | Tópico |
| PublishSuccessLatencyInMs | Yes | Publicar Latência de Êxito | MilliSeconds | Total | Publicar a latência de êxito em milissegundos | Sem dimensões |
Microsoft.EventGrid/eventSubscriptions
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| DeadLetteredCount | Yes | Eventos de mensagens mortas | Contagem | Total | Total de eventos de mensagens mortas correspondentes a essa assinatura de evento | DeadLetterReason |
| DeliveryAttemptFailCount | Não | Eventos com falha de entrega | Contagem | Total | Total de eventos não entregues a essa assinatura de evento | Error, ErrorType |
| DeliverySuccessCount | Yes | Eventos entregues | Contagem | Total | Total de eventos entregues a essa assinatura de evento | Sem dimensões |
| DestinationProcessingDurationInMs | Não | Duração do processamento de destino | Milissegundos | Média | Duração do processamento de destino em milissegundos | Sem dimensões |
| DroppedEventCount | Yes | Eventos removidos | Contagem | Total | Total de eventos removidos correspondentes a essa assinatura de evento | DropReason |
| MatchedEventCount | Yes | Eventos correspondentes | Contagem | Total | Total de eventos correspondentes a essa assinatura de evento | Sem dimensões |
Microsoft.EventGrid/extensionTopics
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| PublishFailCount | Yes | Publicar Eventos com Falha | Contagem | Total | Total de eventos com falha ao publicar neste tópico | ErrorType, Error |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos publicados neste tópico | Sem dimensões |
| PublishSuccessLatencyInMs | Yes | Publicar Latência de Êxito | Milissegundos | Total | Publicar a latência de êxito em milissegundos | Sem dimensões |
| UnmatchedEventCount | Yes | Eventos sem correspondência | Contagem | Total | Total de eventos sem correspondência com nenhuma das assinaturas de evento para este tópico | Sem dimensões |
Microsoft.EventGrid/partnerNamespaces
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| PublishFailCount | Yes | Publicar Eventos com Falha | Contagem | Total | Total de eventos com falha ao publicar neste namespace do parceiro | ErrorType, Error |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos publicados neste namespace do parceiro | Sem dimensões |
| PublishSuccessLatencyInMs | Yes | Publicar Latência de Êxito | MilliSeconds | Total | Publicar a latência de êxito em milissegundos | Sem dimensões |
| UnmatchedEventCount | Yes | Eventos sem correspondência | Contagem | Total | Total de eventos que não correspondem a nenhum dos tópicos do parceiro | Sem dimensões |
Microsoft.EventGrid/partnerTopics
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | Yes | Avaliações de filtro avançado | Contagem | Total | Total de filtros avançados avaliados nas assinaturas de evento para esse tópico parceiro. | EventSubscriptionName |
| DeadLetteredCount | Yes | Eventos de mensagens mortas | Contagem | Total | Total de eventos de mensagens mortas correspondentes a essa assinatura de evento | DeadLetterReason, EventSubscriptionName |
| DeliveryAttemptFailCount | Não | Eventos com falha de entrega | Contagem | Total | Total de eventos não entregues a essa assinatura de evento | Error, ErrorType, EventSubscriptionName |
| DeliverySuccessCount | Yes | Eventos entregues | Contagem | Total | Total de eventos entregues a essa assinatura de evento | EventSubscriptionName |
| DestinationProcessingDurationInMs | Não | Duração do processamento de destino | MilliSeconds | Média | Duração do processamento de destino em milissegundos | EventSubscriptionName |
| DroppedEventCount | Yes | Eventos removidos | Contagem | Total | Total de eventos removidos correspondentes a essa assinatura de evento | DropReason, EventSubscriptionName |
| MatchedEventCount | Yes | Eventos correspondentes | Contagem | Total | Total de eventos correspondentes a essa assinatura de evento | EventSubscriptionName |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos com falha ao publicar neste tópico do parceiro | Sem dimensões |
| UnmatchedEventCount | Yes | Eventos sem correspondência | Contagem | Total | Total de eventos sem correspondência com nenhuma das assinaturas de evento para este tópico parceiro | Sem dimensões |
Microsoft.EventGrid/systemTopics
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | Yes | Avaliações de filtro avançado | Contagem | Total | Total de filtros avançados avaliados nas assinaturas de evento para esse tópico. | EventSubscriptionName |
| DeadLetteredCount | Yes | Eventos de mensagens mortas | Contagem | Total | Total de eventos de mensagens mortas correspondentes a essa assinatura de evento | DeadLetterReason, EventSubscriptionName |
| DeliveryAttemptFailCount | Não | Eventos com falha de entrega | Contagem | Total | Total de eventos não entregues a essa assinatura de evento | Error, ErrorType, EventSubscriptionName |
| DeliverySuccessCount | Yes | Eventos entregues | Contagem | Total | Total de eventos entregues a essa assinatura de evento | EventSubscriptionName |
| DestinationProcessingDurationInMs | Não | Duração do processamento de destino | Milissegundos | Média | Duração do processamento de destino em milissegundos | EventSubscriptionName |
| DroppedEventCount | Yes | Eventos removidos | Contagem | Total | Total de eventos removidos correspondentes a essa assinatura de evento | DropReason, EventSubscriptionName |
| MatchedEventCount | Yes | Eventos correspondentes | Contagem | Total | Total de eventos correspondentes a essa assinatura de evento | EventSubscriptionName |
| PublishFailCount | Yes | Publicar Eventos com Falha | Contagem | Total | Total de eventos com falha ao publicar neste tópico | ErrorType, Error |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos publicados neste tópico | Sem dimensões |
| PublishSuccessLatencyInMs | Yes | Publicar Latência de Êxito | Milissegundos | Total | Publicar a latência de êxito em milissegundos | Sem dimensões |
| UnmatchedEventCount | Yes | Eventos sem correspondência | Contagem | Total | Total de eventos sem correspondência com nenhuma das assinaturas de evento para este tópico | Sem dimensões |
Microsoft.EventGrid/topics
| Métrica | Exportável por meio das Configurações de Diagnóstico? | Nome de exibição da métrica | Unidade | Tipo de agregação | Descrição | Dimensões |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | Yes | Avaliações de filtro avançado | Contagem | Total | Total de filtros avançados avaliados nas assinaturas de evento para esse tópico. | EventSubscriptionName |
| DeadLetteredCount | Yes | Eventos de mensagens mortas | Contagem | Total | Total de eventos de mensagens mortas correspondentes a essa assinatura de evento | DeadLetterReason, EventSubscriptionName |
| DeliveryAttemptFailCount | Não | Eventos com falha de entrega | Contagem | Total | Total de eventos não entregues a essa assinatura de evento | Error, ErrorType, EventSubscriptionName |
| DeliverySuccessCount | Yes | Eventos entregues | Contagem | Total | Total de eventos entregues a essa assinatura de evento | EventSubscriptionName |
| DestinationProcessingDurationInMs | Não | Duração do processamento de destino | MilliSeconds | Média | Duração do processamento de destino em milissegundos | EventSubscriptionName |
| DroppedEventCount | Yes | Eventos removidos | Contagem | Total | Total de eventos removidos correspondentes a essa assinatura de evento | DropReason, EventSubscriptionName |
| MatchedEventCount | Yes | Eventos correspondentes | Contagem | Total | Total de eventos correspondentes a essa assinatura de evento | EventSubscriptionName |
| PublishFailCount | Yes | Publicar Eventos com Falha | Contagem | Total | Total de eventos com falha ao publicar neste tópico | ErrorType, Error |
| PublishSuccessCount | Yes | Eventos publicados | Contagem | Total | Total de eventos publicados neste tópico | Sem dimensões |
| PublishSuccessLatencyInMs | Yes | Publicar Latência de Êxito | MilliSeconds | Total | Publicar a latência de êxito em milissegundos | Sem dimensões |
| UnmatchedEventCount | Yes | Eventos sem correspondência | Contagem | Total | Total de eventos sem correspondência com nenhuma das assinaturas de evento para este tópico | Sem dimensões |
Logs de recursos
As configurações de diagnóstico permitem que os usuários da Grade de Eventos capturem e exibam logs de falha de publicação e entrega em uma conta do Armazenamento, um hub de eventos ou um Workspace do Log Analytics. Este artigo fornece o esquema de logs e um exemplo de entrada de log.
Esquema para logs de falha de publicação/entrega
| Nome da propriedade | Tipo de dados | Descrição |
|---|---|---|
| Hora | DateTime | A hora em que a entrada de log foi gerada Valor de exemplo: 01-29-2020 09:52:02.700 |
| EventSubscriptionName | String | O nome da assinatura de evento Valor de exemplo: "EVENTSUB1" Essa propriedade existe somente para logs de falha de entrega. |
| Categoria | String | O nome da categoria de log. Valores de exemplo: "DeliveryFailures" ou "PublishFailures" |
| OperationName | String | O nome da operação causou a falha. Valores de exemplo: "Entregar" para falhas de entrega. |
| Mensagem | String | A mensagem de log para o usuário que explica o motivo da falha e mais detalhes. |
| ResourceId | String | A ID de recurso para o recurso de tópico/domínio Valores de exemplo: |
Exemplo - Esquema para logs de falha de publicação/entrega
{
"time": "2019-11-01T00:17:13.4389048Z",
"resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-ID /RESOURCEGROUPS/SAMPLE-RESOURCEGROUP-NAME/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/SAMPLE-TOPIC-NAME ",
"eventSubscriptionName": "SAMPLEDESTINATION",
"category": "DeliveryFailures",
"operationName": "Deliver",
"message": "Message:outcome=NotFound, latencyInMs=2635, id=xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx, systemId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx, state=FilteredFailingDelivery, deliveryTime=11/1/2019 12:17:10 AM, deliveryCount=0, probationCount=0, deliverySchema=EventGridEvent, eventSubscriptionDeliverySchema=EventGridEvent, fields=InputEvent, EventSubscriptionId, DeliveryTime, State, Id, DeliverySchema, LastDeliveryAttemptTime, SystemId, fieldCount=, requestExpiration=1/1/0001 12:00:00 AM, delivered=False publishTime=11/1/2019 12:17:10 AM, eventTime=11/1/2019 12:17:09 AM, eventType=Type, deliveryTime=11/1/2019 12:17:10 AM, filteringState=FilteredWithRpc, inputSchema=EventGridEvent, publisher=DIAGNOSTICLOGSTEST-EASTUS.EASTUS-1.EVENTGRID.AZURE.NET, size=363, fields=Id, PublishTime, SerializedBody, EventType, Topic, Subject, FilteringHashCode, SystemId, Publisher, FilteringTopic, TopicCategory, DataVersion, MetadataVersion, InputSchema, EventTime, fieldCount=15, url=sb://diagnosticlogstesting-eastus.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://diagnosticlogstesting-eastus.servicebus.windows.net/eh-diagnosticlogstest' could not be found. TrackingId:c98c5af6-11f0-400b-8f56-c605662fb849_G14, SystemTracker:diagnosticlogstesting-eastus.servicebus.windows.net:eh-diagnosticlogstest, Timestamp:2019-11-01T00:17:13, referenceId: ac141738a9a54451b12b4cc31a10dedc_G14:"
}
Os valores possíveis de Outcome são NotFound, Aborted, TimedOutGenericError, e Busy. A Grade de Eventos registra todas as informações recebidas do manipulador de eventos no message. Por exemplo, para GenericError, ela registra o código de status HTTP, o código de erro e a mensagem de erro.
Esquema de logs de operações do plano de dados
| Nome da propriedade | Tipo de dados | Descrição |
|---|---|---|
| NetworkAccess | String | Os valores permitidos são - PublicAccess – durante a conexão por meio de IP público- PrivateAccess – durante a conexão por meio do link privado |
| ClientIpAddress | String | IP de origem de solicitações de entrada |
| TlsVersion | String | A versão TLS (transport layer security) usada pela conexão do cliente. Os valores possíveis são: 1.0, 1.1 e 1.2. |
| Autenticação/Tipo | String | O tipo de segredo usado para autenticação ao publicar mensagens. - Key – A solicitação usa a chave SAS- SASToken – A solicitação usa um token SAS gerado por meio da chave SAS- AADAccessToken: Token Web JSON (JWT) emitido pelo Microsoft Entra ID- Unknown – Nenhum dos tipos de autenticação acima. As solicitações OPTIONS têm esse tipo de autenticação |
| Autenticação/ObjectId | String | ObjectId da entidade de serviço usou tipo de autenticação definido como AADAccessToken |
| OperationResult | String | Resultado da publicação. Os valores possíveis são os seguintes: - Com sucesso – Unauthorized – Forbidden – RequestEntityTooLarge – BadRequest – InternalServerError |
| TotalOperations | String | Esses rastreamentos não são emitidos para cada solicitação de publicação. Uma agregação para cada combinação exclusiva de valores acima é emitida a cada minuto |
Exemplo - Esquema para solicitações de plano de dados
{
"time": "2021-10-26T21:44:16.8117322Z",
"resourceId": "/SUBSCRIPTIONS/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/RESOURCEGROUPS/BMT-TEST/PROVIDERS/MICROSOFT.EVENTGRID/DOMAINS/BMTAUDITLOGDOMAIN",
"operationName": "Microsoft.EventGrid/events/send",
"category": "DataPlaneRequests",
"level": "Information",
"region": "CENTRALUSEUAP",
"properties": {
"aggregatedRequests": [
{
"networkAccess": "PublicAccess",
"clientIpAddress": "xx.xx.xx.xxx",
"tlsVersion": "1.2",
"authentication": {
"type": "AADAccessToken",
"objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
"operationResult": "Success",
"totalOperations": 1
}
]
}
}
Depois que a configuração de diagnóstico DataPlaneRequests for selecionada, os recursos da Grade de Eventos começarão a publicar os rastreamentos de auditoria para operações do plano de dados, incluindo as operações de acesso público e privado. Esse rastreamento pode registrar uma ou mais solicitações, se necessário.
Próximas etapas
Para saber como habilitar os logs de diagnóstico para tópicos ou domínios, confira Habilitar logs de diagnóstico.