Delivery Retry

La pantalla Delivery Retry lista los eventos que no se entregaron con éxito y permite el reintento manual de entrega.

Reintentos: automático vs manual

• Cuando el primer intento de entrega de un evento a un suscriptor falla, el Events Hub intenta reenviar automáticamente, siguiendo las configuraciones registradas en la política.

• Si todos los intentos automáticos fallan, el evento pasa a la cola de reintento en la pantalla Delivery Retry, donde usted puede intentar reenviar manualmente.

Filtros

Por defecto, la lista muestra hasta 50 entregas no realizadas para el día actual, pero usted puede usar los filtros disponibles para ampliar o refinar la búsqueda. Estos son:

• From: para elegir la fecha inicial de la búsqueda. Usted puede seleccionar hasta 14 días antes de la fecha actual.

• To: para elegir la fecha final de la búsqueda. Usted puede seleccionar el día de hoy o hasta 14 días atrás.

• Status: filtra los códigos de estado retornados, que pueden ser:

  • Éxito, pero diferente al esperado (Success, different from expected).
  • Error de cliente (Client Error).
  • O error de servidor (Server Error).

• Max Results: número máximo de resultados por página, pudiendo ser 50, 100, 300, o 500.

• Event ID: filtra por identificador único del evento, generado siempre que una solicitud es recibida del publicador. Este identificador se muestra en la pantalla Event Status.

• Subscribers: filtra por suscriptor, permitiendo seleccionar varios al mismo tiempo.

• Contexts: filtra por contexto, pudiendo seleccionar varios al mismo tiempo.

TIP

La consulta puede devolver hasta 500 elementos, según lo definido en el campo Max Results. Si la entrega que busca no está entre los primeros 500 elementos, usted puede localizarla en la pantalla Event Status y reenviarla manualmente haciendo clic en el botón VIEW IN DELIVERY RETRY. Otra opción es copiar el ID del evento y buscarlo en el campo Event ID.

Reenvío manual

En la lista de entregas con fallas, cada suscriptor está en una fila. En la columna SELECT, usted puede seleccionar elementos para intentar entregarlos manualmente. Si prefiere, seleccione todos a la vez marcando la opción Select All encima de la tabla. Después de elegir los eventos que desea reenviar, haga clic en el botón RETRY SELECTED.

Si el envío manual tiene éxito, el elemento será eliminado de la lista de Delivery Retry en la próxima consulta. Si el retorno recibido es diferente al esperado, el elemento volverá a la lista de fallos y podrá ser reenviado nuevamente.

Usted puede eliminar uno o más eventos de la pantalla de Delivery Retry. Para hacerlo:

Seleccione la unidad o el lote de eventos para eliminar.

Haga clic en el botón DELETE SELECTED.

Confirme la acción.

Haciendo clic en el ícono , usted puede elegir qué columnas desea mostrar en la pantalla de Delivery Retry. Vea las columnas a continuación:

• La fecha y hora en la columna DATE se refieren al intento de entrega a los suscriptores por el Events Hub.
• La columna EVENT ID muestra el identificador único del evento. La lista muestra los elementos por suscriptor y, por lo tanto, puede haber más de una fila con el mismo event ID. El ícono copia el ID a su portapapeles.

Este ID puede ser utilizado en la pantalla Event Status para consultar detalles del mensaje enviado por el publicador y ver el historial de intentos de entrega a los suscriptores.

• Las columnas EXPECTED STATUS y DELIVERY STATUS muestran los códigos de retorno HTTP esperados y recibidos por el Events Hub al enviar el evento a los suscriptores. El código esperado se define en el registro o edición de suscriptores.

WARNING

Si el código de retorno esperado se modifica en el registro de suscriptores, esta modificación se aplicará solo a nuevos eventos recibidos por el Events Hub. Eventos recibidos antes de la modificación no utilizarán el nuevo código esperado para intentos manuales de envío.

• La columna ENABLED TOPICS contiene el ícono , que muestra información sobre el evento recibido por el Events Hub. El publicador solo es identificado y mostrado si hay un interceptor que valide el client ID en la política aplicada al handler (Client ID Validation o OAuth Validation).

NOTE

Los intentos de entrega con falla se muestran por suscriptor. Esto significa que, si un intento de entrega falla para más de un suscriptor, habrá un elemento para cada suscriptor en la lista, pero todos tendrán el mismo event ID. Usted puede reenviar el evento a un suscriptor específico o a todos ellos al mismo tiempo.

Reenvío automático

Eventos que pasan a la cola de intento manual pueden ser reenviados automáticamente mediante la API Event Status. Para acceder a ella, vaya a Sensedia API Platform > API Design > API Catalog y busque por "Event Status".

A continuación, siga sugerencias de buenas prácticas para el reenvío automático de eventos utilizando la API.

Operación de la API

La única operación esencial de esta API para el reenvío automático es la /deliveries.

• A través del endpoint GET /deliveries, usted lista todos los eventos con fallo en el envío.
• A través del endpoint POST /deliveries, usted reenvía a los suscriptores los eventos con fallo en el envío.

Listado de eventos no enviados

El endpoint GET /deliveries permite listar todos los eventos que no se enviaron con éxito, donde el código HTTP retornado difiere del esperado. Para evitar sobrecarga en el sistema, usted puede limitar la cantidad de eventos retornados en una única solicitud. La solicitud es paginada y usted puede elegir entre 10, 25, 50, 100 y 500 eventos por página.

NOTE

El límite predeterminado de eventos por solicitud es 500.

Para facilitar la ordenación de los resultados, usted puede incluir los siguientes parámetros en la solicitud del GET:

• _sortBy: define por qué campo se realiza la ordenación de los registros. Valores aceptados:
  • date
  • eventId
  • contextName
  • subscriberName
  • subscriberUrl
  • expectedStatusCode
  • httpStatus

Por defecto, el valor es date.

• _direction: define si la ordenación se realiza en orden descendente (DESC) o ascendente (ASC). Por defecto, el valor es DESC.

• _limit: identifica el número de registros a ser retornados. Cuando no se informa, el valor predeterminado es 50.

• _offset: identifica el registro inicial a ser retornado. Cuando no se informa, el valor predeterminado es 0.

Filtrado por fechas

Para encontrar eventos específicos, usted puede usar los siguientes parámetros:

• beginDate: filtra eventos con base en una fecha de inicio dentro de un intervalo de fechas. Puede ser de hasta 14 días antes de la fecha actual.

• endDate: filtra eventos con base en una fecha de fin dentro de un intervalo de fechas. Puede ser el día de hoy o hasta 14 días atrás.

Reenvío automático

El endpoint POST /deliveries permite que usted envíe el evento nuevamente utilizando los parámetros:

• eventId
• subscriberId

IMPORTANT

El número máximo de elementos permitidos en la solicitud es de 500 eventos con fallo en el envío. Si el total de elementos es mayor que 500, envíe el valor máximo (500) en una primera solicitud, espere y use el endpoint GET /deliveries nuevamente para los demás eventos.