Delivery Retry

A tela Delivery Retry lista as entregas de eventos que não foram bem sucedidas e oferece a possibilidade de re-tentativa manual de entrega.

delivery retry

Lista de envios com falha e filtros

Por padrão, a lista de entregas com falha retorna até 50 itens referentes ao dia atual, mas é possível utilizar os filtros disponíveis para alargar ou refinar os retornos. Além dos três campos de filtragem que sempre aparecem na tela (Period, Status e Max Results), o ícone icon search abre filtros adicionais. Ao todo, temos:

delivery retry filters
  • Period: campo referente à data da tentativa de entrega. Opções: hoje (Today), últimos três dias (Last three days) ou última semana (Last week). O campo sempre deve estar preenchido, a menos que o filtro Event ID seja utilizado para busca. Nesse caso, o campo Period será automaticamente desmarcado.

  • Status: filtrar entre códigos de estado retornados, que podem ser: sucesso, mas diferente do esperado (Success (Different from expected)), erro de cliente (Client Error) ou erro de servidor (Server Error).

  • Max Results: número máximo de resultados retornados (que serão devidamente paginados). Opções: 50, 100, 300, 500.

  • Event ID: campo para filtrar por identificador do evento, que é gerado sempre que uma requisição é recebida de um publicador e é exibido na tela Event Status. Quando selecionado, o campo Period é desmarcado automaticamente.

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

  • Contexts: campo para filtrar por contexto, sendo possível selecionar mais de um ao mesmo tempo.

É possível usar combinações entre os campos para refinar a busca, mas é necessário que ou Period ou Event ID estejam sempre selecionados. Ou seja, buscando por data, só serão exibidas as tentativas de entregas com falha de até sete dias atrás. No entanto, é possível buscar tentativas anteriores ao filtrar por Event ID.

O retorno máximo para cada consulta é de 500 itens, conforme definido no campo Max Results. Se você estiver tentando encontrar uma entrega com falha mas ela não está entre os 500 primeiros retornos, pode buscar o evento na tela Event Status e, por lá, encaminhar o evento para re-tentativa manual clicando no botão VIEW IN DELIVERY RETRY. Alternativamente, pode copiar o ID do evento e pesquisá-lo aqui no campo Event ID.

A lista de entregas com falha contém uma linha para cada subscritor. Por meio da coluna SELECT é possível selecionar itens para que uma tentativa de entrega manual seja feita. É possível selecionar itens individualmente ou todos ao mesmo tempo, marcando a opção Select All acima da tabela. Após a seleção dos envios a serem re-tentados, basta clicar no botão RETRY SELECTED.

Quanto às informações exibidas na tabela de listagem de entregas com falhas, há 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:

delivery retry table
Observações
  • A coluna SELECT permite selecionar os itens para que seja feita uma tentativa de entrega manual. Também é possível selecionar todos os itens retornados marcando a opção Select All acima da tabela.

  • A data e horário na coluna DATE referem-se à tentativa de entrega aos subscritores 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. Como os itens da tabela são segregados por envio a subscritor, não por evento, pode haver mais de uma linha com o mesmo event ID. O ícone icon copy copia o ID para a área de transferência do usuário. Esse ID pode ser utilizado na tela Event Status para consultar detalhes da mensagem enviada pelo publicador e ver o histórico de tentativas de entrega aos subscritores.

  • A coluna SUBSCRIBER mostra o nome do subscritor e SUBSCRIBER URL exibe a URL para a qual o evento foi enviado.

  • A coluna EXPECTED STATUS exibe o código HTTP de retorno que o Events Hub esperava ao enviar o evento ao subscritor e a coluna DELIVERY STATUS exibe o código HTTP que foi recebido. O código esperado é definido no processo de registro ou edição de subscritores.

    Se o código de retorno esperado para o envio for alterado no registro de subscritores, essa modificação será aplicada a novos eventos recebidos pelo Events Hub. Eventos recebidos antes da modificação não utilizarão o novo código esperado para tentativas manuais de envio.
  • A coluna ENABLED TOPICS contém o ícone icon expand, que exibe informações a respeito do evento que foi recebido pelo Events Hub:

    delivery retry expand

    • A data e horário na coluna DATE referem-se ao recebimento do evento pelo Events Hub.

    • As colunas HANDLER, TOPIC, PUBLISHER e POLICY exibem o handler, tópico, publicador, e política aplicada ao handler. Se nenhuma política estiver aplicada ao handler, a coluna estará vazia. 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).

As tentativas de entrega mal-sucedidas são exibidas por subscritor. Isso significa que, se uma tentativa de entrega houver falhado para mais de um subscritor, haverá um item para cada subscritor na lista, mas todos com o mesmo event ID, e você poderá reenviar o evento para somente um subscritor ou para todos eles ao mesmo tempo:
delivery retry multiple subs

Tentativas manuais de entrega

É possível selecionar quantos itens forem desejados da lista de envios mal-sucedidos para uma tentativa manual de entrega. Após selecionar os itens desejados, basta clicar no botão RETRY SELECTED. Se o envio manual for bem-sucedido, o item será removido da lista de Delivery Retry quando uma nova consulta for feita. Se o retorno recebido for novamente diferente do esperado, ele populará novamente a lista de não-entregas e poderá ser re-tentado.

Exemplo de entrega manual

No exemplo abaixo, vemos o histórico de envios para um subscritor (Event Status  Delivery Retry  History), que compreende a tentativa inicial de entrega e mais três tentativas automáticas ocasionadas pela política aplicada ao handler:

event status history2

Na tela Delivery Retry, selecionamos o item referente à entrega ao subscritor para uma tentativa manual de envio:

delivery retry ex

Após sucesso na tentativa manual, o histórico de envios é repopulado:

event status history3
Thanks for your feedback!
EDIT
How useful was this article to you?