Partilhar via


Monitorar a referência de dados para a entrega de eventos push da Grade de Eventos do Azure

Este artigo fornece uma referência de dados de log e métricas coletados para analisar o desempenho e a disponibilidade da entrega por push da Grade de Eventos do Azure.

Importante

Este recurso está atualmente em visualização.

Métricas

Microsoft.EventGrid/domínios

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
AdvancedFilterEvaluationCount Sim Avaliações avançadas de filtros Count Total Total de filtros avançados avaliados em assinaturas de eventos para este tópico. Tópico, EventSubscriptionName, DomainEventSubscriptionName
DeadLetteredCount Sim Eventos com letras mortas Count Total Total de eventos com letras mortas correspondentes a esta subscrição de evento Tópico, EventSubscriptionName, DomainEventSubscriptionName, DeadLetterReason
DeliveryAttemptFailCount Não Eventos de falha na entrega Count Total O total de eventos não foi entregue a esta subscrição de evento Tópico, EventSubscriptionName, DomainEventSubscriptionName, Error, ErrorType
DeliverySuccessCount Sim Eventos Entregues Count Total Total de eventos entregues para esta subscrição de evento Tópico, EventSubscriptionName, DomainEventSubscriptionName
DestinationProcessingDurationInMs Não Duração do processamento de destino Milissegundos Média Duração do processamento de destino em milissegundos Tópico, EventSubscriptionName, DomainEventSubscriptionName
DroppedEventCount Sim Eventos descartados Count Total Total de eventos descartados correspondentes a esta assinatura de evento Tópico, EventSubscriptionName, DomainEventSubscriptionName, DropReason
MatchedEventCount Sim Eventos Correspondentes Count Total Total de eventos correspondentes a esta subscrição de evento Tópico, EventSubscriptionName, DomainEventSubscriptionName
PublishFailCount Sim Publicar eventos com falha Count Total O total de eventos não pôde ser publicado neste tópico Tópico, ErrorType, Erro
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados neste tópico Tópico
PublishSuccessLatencyInMs Sim Latência de sucesso de publicação Milissegundos Total Publicar latência de sucesso em milissegundos Sem dimensões

Microsoft.EventGrid/eventSubscriptions

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
DeadLetteredCount Sim Eventos com letras mortas Count Total Total de eventos com letras mortas correspondentes a esta subscrição de evento DeadLetterReason
DeliveryAttemptFailCount Não Eventos de falha na entrega Count Total O total de eventos não foi entregue a esta subscrição de evento Erro, ErrorType
DeliverySuccessCount Sim Eventos Entregues Count Total Total de eventos entregues para esta subscrição 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 Sim Eventos descartados Count Total Total de eventos descartados correspondentes a esta assinatura de evento DropReason
MatchedEventCount Sim Eventos Correspondentes Count Total Total de eventos correspondentes a esta subscrição de evento Sem dimensões

Microsoft.EventGrid/extensionTopics

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
PublishFailCount Sim Publicar eventos com falha Count Total O total de eventos não pôde ser publicado neste tópico ErrorType, Erro
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados neste tópico Sem dimensões
PublishSuccessLatencyInMs Sim Latência de sucesso de publicação Milissegundos Total Publicar latência de sucesso em milissegundos Sem dimensões
UnmatchedEventCount Sim Eventos incomparáveis Count Total Total de eventos que não correspondem a nenhuma das assinaturas de eventos para este tópico Sem dimensões

Microsoft.EventGrid/partnerNamespaces

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
PublishFailCount Sim Publicar eventos com falha Count Total O total de eventos não pôde ser publicado neste namespace de parceiro ErrorType, Erro
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados neste namespace de parceiro Sem dimensões
PublishSuccessLatencyInMs Sim Latência de sucesso de publicação Milissegundos Total Publicar latência de sucesso em milissegundos Sem dimensões
UnmatchedEventCount Sim Eventos incomparáveis Count 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 através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
AdvancedFilterEvaluationCount Sim Avaliações avançadas de filtros Count Total Total de filtros avançados avaliados em assinaturas de eventos para este tópico de parceiro. EventSubscriptionName
DeadLetteredCount Sim Eventos com letras mortas Count Total Total de eventos com letras mortas correspondentes a esta subscrição de evento DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount Não Eventos de falha na entrega Count Total O total de eventos não foi entregue a esta subscrição de evento Error, ErrorType, EventSubscriptionName
DeliverySuccessCount Sim Eventos Entregues Count Total Total de eventos entregues para esta subscrição 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 Sim Eventos descartados Count Total Total de eventos descartados correspondentes a esta assinatura de evento DropReason, EventSubscriptionName
MatchedEventCount Sim Eventos Correspondentes Count Total Total de eventos correspondentes a esta subscrição de evento EventSubscriptionName
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados para este tópico de parceiro Sem dimensões
UnmatchedEventCount Sim Eventos incomparáveis Count Total Total de eventos que não correspondem a nenhuma das assinaturas de eventos para este tópico de parceiro Sem dimensões

Microsoft.EventGrid/systemTopics

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
AdvancedFilterEvaluationCount Sim Avaliações avançadas de filtros Count Total Total de filtros avançados avaliados em assinaturas de eventos para este tópico. EventSubscriptionName
DeadLetteredCount Sim Eventos com letras mortas Count Total Total de eventos com letras mortas correspondentes a esta subscrição de evento DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount Não Eventos de falha na entrega Count Total O total de eventos não foi entregue a esta subscrição de evento Error, ErrorType, EventSubscriptionName
DeliverySuccessCount Sim Eventos Entregues Count Total Total de eventos entregues para esta subscrição 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 Sim Eventos descartados Count Total Total de eventos descartados correspondentes a esta assinatura de evento DropReason, EventSubscriptionName
MatchedEventCount Sim Eventos Correspondentes Count Total Total de eventos correspondentes a esta subscrição de evento EventSubscriptionName
PublishFailCount Sim Publicar eventos com falha Count Total O total de eventos não pôde ser publicado neste tópico ErrorType, Erro
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados neste tópico Sem dimensões
PublishSuccessLatencyInMs Sim Latência de sucesso de publicação Milissegundos Total Publicar latência de sucesso em milissegundos Sem dimensões
UnmatchedEventCount Sim Eventos incomparáveis Count Total Total de eventos que não correspondem a nenhuma das assinaturas de eventos para este tópico Sem dimensões

Microsoft.EventGrid/topics

Métrica Exportável através de configurações de diagnóstico? Nome de exibição da métrica Unit Tipo de agregação Description Dimensões
AdvancedFilterEvaluationCount Sim Avaliações avançadas de filtros Count Total Total de filtros avançados avaliados em assinaturas de eventos para este tópico. EventSubscriptionName
DeadLetteredCount Sim Eventos com letras mortas Count Total Total de eventos com letras mortas correspondentes a esta subscrição de evento DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount Não Eventos de falha na entrega Count Total O total de eventos não foi entregue a esta subscrição de evento Error, ErrorType, EventSubscriptionName
DeliverySuccessCount Sim Eventos Entregues Count Total Total de eventos entregues para esta subscrição 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 Sim Eventos descartados Count Total Total de eventos descartados correspondentes a esta assinatura de evento DropReason, EventSubscriptionName
MatchedEventCount Sim Eventos Correspondentes Count Total Total de eventos correspondentes a esta subscrição de evento EventSubscriptionName
PublishFailCount Sim Publicar eventos com falha Count Total O total de eventos não pôde ser publicado neste tópico ErrorType, Erro
PublishSuccessCount Sim Eventos Publicados Count Total Total de eventos publicados neste tópico Sem dimensões
PublishSuccessLatencyInMs Sim Latência de sucesso de publicação Milissegundos Total Publicar latência de sucesso em milissegundos Sem dimensões
UnmatchedEventCount Sim Eventos incomparáveis Count Total Total de eventos que não correspondem a nenhuma das assinaturas de eventos para este tópico Sem dimensões

Registos do recurso

As configurações de diagnóstico permitem que os usuários da Grade de Eventos capturem e visualizem logs de falha de publicação e entrega em uma conta de armazenamento, um hub de eventos ou um espaço de trabalho do Log Analytics. Este artigo fornece esquema para os logs e uma entrada de log de exemplo.

Esquema para logs de falha de publicação/entrega

Nome da propriedade Tipo de dados Description
Time 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 do evento

Valor de exemplo: "EVENTSUB1"

Essa propriedade existe apenas 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 explicando o motivo da falha e mais detalhes.
ResourceId String A ID do recurso para o recurso de tópico/domínio

Valores de exemplo: /SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-ID/RESOURCEGROUPS/SAMPLE-RESOURCEGROUP/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/TOPIC1

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, , GenericErrorTimedOut, e Busy. A Grade de Eventos registra todas as informações recebidas do manipulador de eventos no message. Por exemplo, para GenericError, ele registra o código de status HTTP, o código de erro e a mensagem de erro.

Esquema para logs de operações do plano de dados

Nome da propriedade Tipo de dados Description
Acesso à rede String Os valores permitidos são:
- PublicAccess - ao ligar através de IP público
- PrivateAccess - ao conectar-se via link privado
ClientIpAddress String IP de origem dos pedidos recebidos
TlsVersion String A versão de segurança da camada de transporte (TLS) 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 – request usa um token SAS gerado a partir da chave SAS
- AADAccessToken – Microsoft Entra ID emitido JSON Web Token (JWT) token
- Unknown – Nenhum dos tipos de autenticação acima. As solicitações OPTIONS têm este tipo de autenticação
Autenticação/ObjectId String ObjectId da entidade de serviço usada quando o tipo de autenticação é definido como AADAccessToken
OperationResult String Resultado da publicação. Os valores possíveis são:
- Sucesso
- Não autorizado
- Proibido
- RequestEntityTooLarge
- BadRequest
- InternalServerError
Operações totais String Esses rastreamentos não são emitidos para cada solicitação de publicação. Um agregado para cada combinação única de valores acima é emitido 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 é selecionada, os recursos da DataPlaneRequests Grade de Eventos começam a publicar rastreamentos de auditoria para operações de plano de dados, incluindo operações de acesso público e privado. Esse rastreamento pode registrar uma ou mais solicitações, se necessário.

Próximos passos

Para saber como habilitar logs de diagnóstico para tópicos ou domínios, consulte Habilitar logs de diagnóstico.