Handlers

Handlers funcionan como agregadores de tópicos. Ayudan a crear los canales de publicación de eventos de forma más organizada y rápida. Las políticas de seguridad y reintentos automáticos de envío también son definidas por el handler.

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

URL de publicación de eventos

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

Esta URL se forma por URL base + context + handler + topic:

• 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).
• Contexto, handler y tópico: son creados por usted. Ayudan a organizar y gestionar diferentes canales de publicación.
  • Tópico es el nivel más específico.
  • Handlers son los agregadores de tópicos, sirviendo como una capa lógica de agrupamiento.
  • Contextos añaden un nivel más de agrupamiento, permitiendo usar el mismo tópico en diferentes situaciones.

Listado de handlers

En la página Handlers, usted visualiza todos los handlers existentes. En ella, puede optar por organizarlos en cards, haciendo clic en el ícono o en tablas, haciendo clic en el ícono .

Filtros

Por defecto, los handlers se listan por orden de creación. En el campo Order by, usted selecciona el orden deseado 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, del final al principio.

• Name (asc): lista los handlers en orden alfabético, del principio al final.

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

Detalles

Si desea verificar los eventos enviados a los tópicos de un handler, haga clic en el ícono . Será dirigido a la página Event Status.

Para visualizar detalles de un handler, haga clic sobre el nombre del card. Será dirigido a la pantalla de Overview. En ella, puede ver y editar la información del handler en 4 pestañas:

Topics

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

• Al hacer clic en el ícono , usted visualiza la lista de contextos registrados. Para habilitar/deshabilitar, use los botones de la columna Available.

• Para editar un tópico, haga clic en el ícono del lápiz.

• Para eliminar un tópico, haga clic en el ícono de la papelera.

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

Ejemplo

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

Crear un handler llamado "Alerts", con el path /alerts.

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.

Crear un contexto para pruebas (por ejemplo, testing) y habilitarlo para el tópico que desea probar, haciendo que los suscriptores no reciban alertas.

• Para registrar suscriptores en el contexto de prueba, debe vincularlos al tópico y habilitarlos solo para el contexto testing.
• Si no registra ningún contexto, el Events Hub define "Default" como predeterminado, y no se añade ningún marcador a la URL de publicación. Por lo tanto, las solicitudes para el tópico latency o api-update serán enviadas a url-base/alerts/latency o url-base>/alerts/api-update y todos los suscriptores activos en él recibirán los eventos.

TIP

La mayor ventaja de usar contextos diferentes es poder reutilizar las configuraciones de políticas de seguridad y reintentos de entrega definidas en el handler, sin necesidad de crear nuevos tópicos. Y como los endpoints de autorización son definidos por contexto, puede usar un mock de autorización para pruebas mientras mantiene la autorización del contexto predeterminado inalterada.

Policy

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

• Al hacer clic en el ícono , usted ve las definiciones de reintento automático, request timeout, códigos de estado que activan nuevos intentos y los interceptores de seguridad habilitados para el handler.
• Haciendo clic en el ícono , puede reemplazar la política aplicada. La pantalla Change Policy permite seleccionar una nueva política en el listado o registrarla a través del botón Create Policy.

TIP

Acceda a la documentación de políticas y entienda cómo funcionan.

Publishers

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

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

• Haciendo clic en el ícono , usted visualiza para qué tópicos y contextos el publisher está habilitado. En la columna Path, está descrita la URL formada por <context>/<handler>/<topic>.

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

Subscribers

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

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

• Haciendo clic en el ícono , usted visualiza para qué tópicos y contextos el suscriptor está habilitado para recibir eventos.

  • En la columna Path, está descrita la URL formada por <context>/<handler>/<topic>.

  • En la columna Subscriber URL, está la URL donde los eventos serán publicados.

• Al hacer clic en el nombre del subscriptor, será dirigido a la pantalla de Subscribers, donde podrá editarlo.

TIP

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

• Editar el handler con el botón EDIT HANDLER.
• Hacer clic en el ícono de la lupa para visualizar los eventos enviados a los tópicos del handler en la pantalla Event Status.
• Eliminar el handler haciendo clic en el ícono de la papelera.

Vea más sobre handlers

• Cómo crear handlers.

• Políticas de seguridad y reintentos de envío aplicados por handler.

• Usar handlers para filtrar el listado de eventos recibidos y distribuidos por el Events Hub en la pantalla Event Status.