Event Status

Na tela Event Status você encontra a lista dos eventos que foram enviados por publicadores para o Events Hub e pode checar o estado das tentativas de distribuição desses eventos aos subscritores.

event status

Lista de eventos e filtros

De forma padrão, a lista de eventos vem filtrada com o dia atual, mas você pode utilizar outros filtros para exibir os eventos.

Limitações de listagem de eventos

O limite de exibição da tela Event Status é de 10.000 eventos por consulta, devidamente paginados e com um máximo de 50 resultados por página. Além disso, a cada consulta pode-se utilizar um intervalo de tempo de no máximo 31 dias (os intervalos não precisam terminar na data atual).

Se você não encontrar o evento que deseja porque ele não é um dos 10.000 primeiros eventos da busca atual, pode utilizar mais filtros para refinar a busca.

Além dos campos de intervalo de data (From e To) e Status, o ícone icon search abre mais filtros de pesquisa. Ao todo, temos:

event status filters
  • From e To: filtros para pesquisar por data inicial e final de recebimento do evento pelo Events Hub.

  • Status: campo para filtrar por status do recebimento do evento pelo Events Hub (ou seja, o código de retorno do Events Hub aos publicadores) entre Success (sucesso) e Error (erro), com a possibilidade de discriminar entre tipos de erro — Client Error (erro de cliente) e Server Error (erro de servidor).

    A exibição dos eventos com erro depende, naturalmente, das requisições dos publicadores terem sido recebidas pelo Events Hub. Por exemplo, se um publicador enviar uma requisição utilizando credenciais incorretas, a requisição terá sido recebida e o evento será exibido na lista com o código de erro 401, mas não será distribuído aos subscritores.
  • Contexts: para filtrar por contextos, sendo possível selecionar mais de um ao mesmo tempo.

  • Handlers: para filtrar por handler, sendo possível selecionar mais de um ao mesmo tempo.

  • Publishers: para filtrar por publicador, sendo possível selecionar mais de um ao mesmo tempo.

  • Subscribers: para filtrar por subscritor, sendo possível selecionar mais de um ao mesmo tempo.

  • Event ID: campo para filtrar por identificador do evento, que é gerado pelo Events Hub sempre que uma requisição é recebida de um publicador (e é exibido na lista de eventos).

A lista de eventos retornados contém uma série de colunas. Por padrão todas as colunas são exibidas, mas é possível selecionar quais devem ser mostradas clicando no ícone icon more, que exibe todas as opções:

event status table
Observações
  • A data e horário na coluna DATE referem-se ao recebimento do evento pelo Events Hub.

  • A coluna EVENT ID exibe um identificador único de evento que é gerado sempre que o Events Hub recebe uma requisição de um publicador. O ícone icon copy copia o ID para a área de transferência do usuário. Esse ID pode ser utilizado na tela Delivery Retry para buscar pelo evento e distribuí-lo manualmente a subscritores que não tenham recebido o evento por tentativa de envio automática.

  • As colunas HANDLER, TOPIC e CONTEXT podem ter células vazias no caso de um evento ter sido enviado ao Events Hub mas com os marcadores da URL referentes a handler, tópico e/ou contexto errados. Como é impossível identificar o caminho de subscrição de eventos, o retorno ao publicador é de erro 404 e não há distribuição de eventos aos subscritores.

  • A coluna PUBLISHER exibe o publicador que enviou a requisição. O publicador só é identificado e exibido se houver um interceptor que valide client ID na política aplicada ao handler (Client ID Validation ou OAuth Validation).

  • A coluna POLICY exibe a política aplicada ao handler. Ela conterá células vazias se não houver política aplicada.

  • SUBSCRIBER QTY exibe a quantidade de subscritores para o evento, com base nos subscritores inscritos no tópico utilizado e que têm o contexto para o qual o evento foi enviado habilitado.

  • A coluna STATUS CODE exibe o código HTTP que o Events Hub retornou ao publicador. Um código de sucesso significa que o Events Hub recebeu o evento e vai tentar entregá-lo aos subscritores, mas não informa sobre o sucesso do envio.

  • A coluna VIEW MESSAGE contém o ícone icon magnifier, que exibe os headers e body da requisição enviada pelo publicador:
    event status message details

  • A coluna DELIVERY RETRY contém o ícone icon expand para ver detalhes sobre as tentativas de entrega do evento aos subscritores. Veja mais sobre isso abaixo.

Dados de entrega de eventos

O ícone icon expand da coluna DELIVERY RETRY exibe detalhes sobre as tentativas de entrega do evento aos subscritores.

Caso não exista um subscritor cadastrado para o evento, o ícone estará desabilitado.

Caso a coluna STATUS exiba um código de erro, isso significa que o envio do evento ao Events Hub não foi bem-sucedido (isso acontece, por exemplo, se um publicador passar credenciais inválidas). Nesse caso, o Event Hub não faz nenhuma tentativa de distribuição do evento aos subscritores e não há dados a serem exibidos ao clicar no ícone icon expand:

event status no delivery

Caso o evento tenha sido recebido com sucesso pelo Events Hub, o ícone abrirá uma aba que mostra a última tentativa de envio do evento a cada subscritor, exibindo data e hora do envio, nome do subscritor, URL do subscritor, código de retorno esperado na envio ao subscritor (coluna EXPECTED STATUS) e código recebido na última tentativa (coluna DELIVERY STATUS):

event status delivery details
A URL do subscritor e o código de retorno esperado são configurados durante a criação ou edição de um subscritor. Veja mais sobre isso aqui.

A coluna HISTORY contém o ícone icon magnifier, que exibe todas as tentativas de envio para o subscritor selecionado. Veja exemplos abaixo.

Caso a última tentativa de envio a um subscritor tenha sido mal-sucedida, a aba que se abre a partir do ícone icon expand conterá o botão VIEW IN DELIVERY RETRY, que redireciona o usuário à página Delivery Retry, já filtrada com o ID do evento em questão. Nela, é possível tentar um envio manual do evento ao subscritor. Após uma tentativa manual bem sucedida, o evento será repopulado, como no exemplo abaixo (referente à imagem anterior):

event status delivery details1

Histórico de tentativas de entrega — coluna History

Na aba aberta clicando sobre o ícone icon expand, a coluna HISTORY contém o ícone icon magnifier, que leva à página de histórico de tentativas de envio do evento ao subscritor.

A página de histórico exibe a data e hora da tentativa de envio, nome e URL do subscritor, o tipo de envio — que pode ser a tentativa inicial (Initial Delivery), re-tentativa automática devido à política aplicada ao handler (Policy Retry), ou uma re-tentativa manual (Manual Retry) — e o código de retorno recebido.

No exemplo abaixo, o evento foi entregue de forma bem-sucedida na primeira tentativa:

event status history1

Neste exemplo, após a tentativa inicial, houve três tentativas automáticas com base na política aplicada ao handler, todas com retorno de erro:

event status history2

O próximo exemplo traz o mesmo evento da imagem anterior. Após as três tentativas automáticas, houve uma tentativa manual bem-sucedida:

event status history3
Podem ser feitas até 10 tentativas automáticas de entrega, mas o número a ser seguido em cada caso é configurado na tela Policies, ao criar ou editar uma política que deverá ser aplicada ao handler no processo de criação/edição de handlers.
Thanks for your feedback!
EDIT
How useful was this article to you?