Handlers

Los handlers funcionan como agregadores de tópicos. Ayudan a crear canales de publicación de eventos de manera más organizada y rápida. Las políticas de seguridad y los intentos automáticos de entrega también se definen por handler.

Para comprender cómo funcionan los handlers, es importante saber cómo el Events Hub habilita la URL de publicación de eventos:

Para publicar eventos, es necesario crear una ruta (URL) que sirva como canal de envío de eventos desde un publicador hasta el Events Hub.

Esta URL se compone de la URL base + context + handler + topic:

  1. URL base: es definida por el Events Hub. Incluye la dirección de la interfaz de cada cliente + event-receiver + un código único (hash).

  2. Contexto, handler y tópico: son creados por usted. Le ayudan a organizar y gestionar los diferentes canales de publicación.

    • El tópico es el nivel más específico.

    • Los handlers son los agregadores de tópicos y sirven como una capa lógica de agrupamiento.

    • Los contextos añaden otro nivel de agrupamiento, lo que permite utilizar el mismo tópico en diferentes situaciones.

Listado de handlers

En la página Handlers, puede ver todos los handlers existentes. Allí, puede optar por organizarlos en tarjetas haciendo clic en el icono icon view card o en tablas haciendo clic en el icono icon view table.

handler screen

Filtros

Por defecto, los handlers se listan por orden de creación. En el campo Order by, puede seleccionar el orden que prefiera entre:

  • Creation (desc): por defecto. Lista los handlers desde la fecha de creación más reciente hasta la más antigua.

  • Creation (asc): lista los handlers desde la fecha de creación más antigua hasta la más reciente.

  • Name (desc): lista los handlers en orden alfabético, de la Z a la A.

  • Name (asc): lista los handlers en orden alfabético, de la A a la Z.

En el campo Keywords, puede buscar términos utilizados en el nombre o descripción de los handlers.

Topics

Muestra los tópicos agrupados en el handler, identificados por nombre y descripción.

  • Al hacer clic en el icono icon expand, puede ver la lista de contextos registrados.

    • Para activar/desactivar, utilice los botones de la columna Available;

  • Para editar un tópico, haga clic en el icono icon edit;

  • Para eliminar un tópico, haga clic en el icono icon delete;

  • Para agregar un nuevo tópico, haga clic en el botón ADD TOPIC e introduzca el nombre y la descripción.

topic handler

Imagina que deseas crear un flujo de publicación de varios tipos de alerta y probarlo sin notificar a los suscriptores. Para hacerlo, puede:

  1. crear un handler llamado "Alerts" con el path /alerts;

  2. registrar tópicos agrupados en el handler. Por ejemplo: /latency para alertas de latencia y api-update para alertas de actualización de las APIs;

  3. crear un contexto de prueba (por ejemplo, testing) y habilitarlo para el tópico que deseas probar, evitando que los suscriptores reciban alertas.

    • Para registrar suscriptores en el contexto de prueba, debe vincularlos al tópico y habilitarlos solo para el contexto testing.

    • Si no registras ningún contexto, el Events Hub establece "Default" como predeterminado y no se agrega ningún marcador a la URL de publicación.
      Por lo tanto, las solicitudes para el tópico latency o api-update se enviarán a <url-base>/alerts/latency/ <url-base>/alerts/api-update y todos los suscriptores activos en él recibirán los eventos.
La principal ventaja de utilizar diferentes contextos es que puede reutilizar las configuraciones de políticas de seguridad y de entrega definidas en el handler, sin necesidad de crear nuevos tópicos. Dado que los endpoints de autorización se definen por contexto, puede usar un mock de autorización para pruebas mientras mantienes inalterada la autorización del contexto predeterminado.

Policy

Muestra la política de seguridad y los intentos de entrega aplicados al handler.

  • Al hacer clic en el icono icon expand, puede ver las configuraciones de intento automático, request timeout, códigos de estado que desencadenan nuevos intentos y los interceptores de seguridad habilitados para el handler.

  • Haciendo clic en el icono change policy, puede reemplazar la política aplicada.

    • La pantalla Change Policy le permite seleccionar una nueva política de la lista o registrarla utilizando el botón Create Policy.

policy handler
Vaya a la documentación de Policies y comprenda cómo funcionan.

Publishers

Lista los publicadores registrados para enviar eventos a los tópicos del handler.

  • Para encontrar un publicador específico, utiliza el campo de búsqueda por nombre.

  • Al hacer clic en el icono icon expand, puede ver para qué tópicos y contextos el publicador está habilitado.

    • En la columna Path, se describe la URL formada por <context>/<handler>/<topic>.

  • Al hacer clic en el nombre del publicador, pasará a la pantalla de Publishers, donde podrá editarlo.

publisher handler

Subscribers

Lista los suscriptores registrados para recibir eventos de los tópicos del handler.

  • Para encontrar un suscriptor específico, utiliza el campo de búsqueda por nombre.

  • Al hacer clic en el icono icon expand, puede ver para qué tópicos y contextos el suscriptor está habilitado para recibir eventos.

    • En la columna Path, se describe la URL formada por <context>/<handler>/<topic>.

    • En la columna Subscriber URL, se encuentra la URL donde se publicarán los eventos.

  • Al hacer clic en el nombre del suscriptor, pasará a la pantalla de Subscribers, donde podrá editarlo.

subscriber handler

En la parte superior de las pestañas, puede:

  • Editar el handler utilizando el botón EDIT HANDLER;

  • Hacer clic en el icono icon magnifier para ver los eventos enviados a los tópicos del handler en la pantalla Event Status;

  • Eliminar el handler haciendo clic en el icono icon delete.

Ver más sobre los handlers

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]