SD-WAN Orchestrator permite configurar alertas para notificar a los operadores, administradores empresariales u otros usuarios de soporte cada vez que se produce un evento.

Nota: Si inició sesión como usuario con privilegios de soporte al cliente, puede ver las alertas y otros objetos, pero no puede configurarlos.

En el portal de empresas, haga clic en Configurar (Configure) > Alertas y notificaciones (Alerts & Notifications) para configurar las alertas.

Seleccione los eventos para los que es necesario enviar alertas e introduzca el tiempo de demora de notificación en minutos en Seleccionar alertas (Select Alerts).

Puede utilizar el evento EDIT_ALERT_CONFIGURATION para registrar los cambios en las configuraciones de las alertas empresariales.

Configurar alertas y notificaciones

En Clientes (Customers), se muestran los detalles de contacto de los usuarios administradores existentes. Puede seleccionar las casillas de verificación de Correo electrónico (Email) y SMS para enviar alertas a los usuarios correspondientes.

Las alertas se envían a los clientes y al equipo de operadores que administra la instancia completa de SD-WAN Orchestrator.

Las alertas que se dirigen a los operadores se denominan alertas previas a la notificación, ya que se envían inmediatamente. Las alertas empresariales o que se envían a los clientes están sujetas a demoras, según la configuración del administrador empresarial.

Por ejemplo, una alerta de vínculo inactivo puede dirigirse a un destino configurado por el operador y a los destinos configurados por el cliente. Supongamos que un vínculo está inactivo durante 1 minuto y el cliente configura la demora de la alerta de vínculo inactivo en 2 minutos. Si las alertas previas a la notificación están habilitadas para este vínculo, Orchestrator enviará una alerta de operador sobre el vínculo inactivo, pero el cliente no recibirá una alerta, ya que se encuentra dentro de la demora configurada.

Capturas de SNMP

Las capturas de protocolo simple de administración de redes (Simple Network Management Protocol, SNMP) son notificaciones que se envían a un agente SNMP para indicar que se produjo un evento. SD-WAN Orchestrator envía las capturas de SNMP correspondientes a las alertas existentes, como Instancia de Edge inactiva (Edge Down) e Instancia de Edge activa (Edge up). Puede seleccionar la versión de SNMP e introducir los detalles correspondientes en Capturas de SNMP (SNMP Traps).
Nota: Actualmente, solo se admiten algoritmos SHA-1 y AES-128 para capturas de SNMP v3.

Webhooks

Activados por determinadas alertas, los webhooks envían datos a otras aplicaciones mediante HTTP POST. Cada vez que se produce una alerta, el origen envía una solicitud HTTP a la aplicación de destino configurada para el webhook.

SD-WAN Orchestrator admite los webhooks que envían automáticamente mensajes a través de HTTP POST a las aplicaciones de destino cuando se produce un evento. Es posible establecer la dirección URL de destino en el portal de empresas y automatizar las acciones en respuesta a las alertas activadas por SD-WAN Orchestrator. Los destinatarios de los webhooks deben admitir HTTPS y deben tener certificados válidos para garantizar la privacidad de las cargas de alertas potencialmente confidenciales. Esto también evita la alteración de las cargas útiles.

Configurar webhooks

En la ventana Configuración de alertas (Alert Configuration), puede introducir los siguientes detalles en Webhooks.

Opción Descripción
Dirección URL (URL) Introduzca una dirección URL HTTPS válida. Esta funciona como la aplicación de destino para los webhooks.
Código

Introduzca un código de estado de respuesta HTTP esperado para cada destinatario de webhook. De forma predeterminada, SD-WAN Orchestrator espera que los destinatarios de webhooks respondan a las solicitudes HTTP POST con un código de estado como HTTP 200.

Cuando SD-WAN Orchestrator recibe un código de estado inesperado de un servidor de destinatario o un servidor proxy, considera que se produjo un error en la entrega de la alerta y genera un evento de cliente ALERT_DELIVERY_FAILED. Este evento ayuda a identificar cuándo es posible que un servidor de destinatario de webhook no funcione según lo esperado.

Secreto (Secret)

Especifique un token secreto para cada destinatario de webhook configurado. Esto se utiliza para calcular un HMAC para cada solicitud de webhook enviada al destinatario correspondiente. El HMAC se integra en un encabezado HTTP X-Webhook-Signature, junto con un parámetro de versión, para identificar el algoritmo de firma y una marca de tiempo.

X-Webhook-Signature: v=<signature-version>&t=<timestamp>&s=<hmac> 
El destinatario interpreta los componentes de la siguiente manera:
  • v: versión del algoritmo que se utiliza para generar la firma. El único valor admitido es 1.
  • t: marca de tiempo con precisión de milisegundos correspondiente a la hora en la que se emite la solicitud.
  • s: HMAC calculado por SD-WAN Orchestrator. El HMAC se calcula de la siguiente manera: HMAC-SHA256(request-body + '.' + timestamp, secret).

El mensaje que se utiliza para calcular el HMAC es una concatenación del cuerpo de la solicitud, un solo punto y el valor del parámetro de marca de tiempo que se muestra en el encabezado de firma. El algoritmo HMAC específico utilizado para generar el código es HMAC-SHA256.

Después de recibir una solicitud de webhook, el servidor de escucha puede verificar la autenticidad de la solicitud. Para ello, el servidor calcula su propia firma HMAC-SHA256 con el mismo algoritmo y compara la firma recientemente calculada con la generada por SD-WAN Orchestrator.

Plantilla de carga útil de JSON (JSON Payload Template)

Este es un campo obligatorio.

SD-WAN Orchestrator envía notificaciones de alerta a cada destinatario de webhook a través de una carga de JSON contenida en el cuerpo de una solicitud HTTP POST saliente.

SD-WAN Orchestrator genera contenido de carga de forma dinámica, ya que las notificaciones se envían mediante la interpolación de variables. Las variables de marcador de posición admitidas en la plantilla de carga configurada por el usuario se reemplazan por valores específicos de alerta.

Las plantillas de carga de webhook son compatibles con las siguientes variables de marcador de posición:
  • alertTime: hora a la que se activó la alerta.
  • alertType: tipo de alerta, por ejemplo, EDGE_DOWN, LINK_UP, VNF_VM_DEPLOYED.
  • customer: nombre del cliente al que se envía la notificación.
  • customerLogicalId: identificador lógico del cliente al que se envía la notificación.
  • deviceLogicalId: identificador lógico de la instancia de Edge a la que se aplica la alerta.
  • entityAffected: nombre de la entidad (por ejemplo, Edge, vínculo o VNF) a la que se aplica la alerta.
  • lastContact: hora a la que la instancia de Edge afectada se comunicó por última vez con SD-WAN Orchestrator. Esto solo se aplica a las alertas de Edge.
  • message: mensaje breve donde se describe el evento que activó la alerta.
  • VCO: nombre de host o dirección IP pública de la instancia de SD-WAN Orchestrator desde donde se envía la notificación.
  • deviceName: nombre de la instancia de Edge a la que se aplica la alerta.
  • deviceDescription: mensaje breve donde se describe la instancia de Edge a la que se aplica la alerta.
  • deviceSerialNumber: número de serie de la instancia de Edge a la que se aplica la alerta.

En el siguiente ejemplo, se proporciona una plantilla de carga de JSON de muestra:

{
   "alertTime": "alertTime",
   "alertType": "alertType",      
   "customer": "customer",
   "customerLogicalId": "customerLogicalId",
   "entityAffected": "entityAffected",
   "deviceLogicalId": "deviceLogicalId",
   "lastContact": "lastContact",
   "message": "message",
   "vco": "vco",
   "deviceName": "deviceName",
   "deviceDescription": "deviceDescription",
   "deviceSerialNumber": "deviceSerialNumber"
}

Puede hacer clic en el icono de más (+) para agregar más direcciones URL de destino y los detalles correspondientes.

Haga clic en Probar (Test) para comprobar las alertas de webhook.

Cada vez que se active una alerta, se enviará un mensaje de alerta junto con la información relevante a la dirección URL de destino.