SD-WAN Orchestrator allows to configure alerts that notify the Operators, Enterprise Administrators or other support users, whenever an event occurs.

Note: If you are logged in as a user with Customer support privileges, you can view the Alerts and other objects but cannot configure them.

In the Enterprise portal, click Configure > Alerts & Notifications to configure the alerts.

Select the events for which the alerts need to be sent, and enter the notification delay time in minutes under Select Alerts.

You can use the EDIT_ALERT_CONFIGURATION event to record the changes to the enterprise alert configurations.

Configure Alerts and Notifications

Under Customers, the contact details of existing admin users are displayed. You can select the checkboxes for Email and SMS to send alerts to the corresponding users.

The alerts are sent to both the operators team managing the entire SD-WAN Orchestrator and to the customers.

Alerts that go to operators are called Pre-Notification Alerts as they are sent immediately. Customer or Enterprise alerts are subject to delays as configured by the Enterprise Admin.

For example, a Link Down alert may go to both an operator configured destination and to customer configured destinations. Assume that a link is down for a minute and the customer configures the Link Down Alert delay for 2 minutes. If the Pre-Notification Alerts are enabled for this link, the Orchestrator will send an Operator alert for Link Down, but the customer would not get an alert as it fell under the configured delay.

SNMP Traps

Simple Network Management Protocol (SNMP) Traps are notifications sent to an SNMP Agent to indicate that an event has occurred. SD-WAN Orchestrator sends SNMP Traps corresponding to the existing alerts like Edge Down and Edge Up. You can select the SNMP version and enter the corresponding details under SNMP Traps.
Note: Currently, only SHA-1 and AES-128 algorithms are supported for SNMP v3 Trap.

Webhooks

Webhooks deliver data to other applications, triggered by certain alerts using HTTP POST. Whenever an alert occurs, the source sends an HTTP request to the target application configured for the webhook.

SD-WAN Orchestrator supports Webhooks that automatically send messages through HTTP POST to target apps when an event occurs. You can set the target URL in the Enterprise portal and automate actions in response to the alerts triggered by SD-WAN Orchestrator. The webhook recipients must support HTTPS and must have valid certificates, to ensure the privacy of potentially sensitive alert payloads. This also prevents the tampering of payloads.

Configure Webhooks

In the Alert Configuration window, you can enter the following details under Webhooks.

Option Description
URL Enter a valid HTTPS URL. This serves as the target application for the webhooks.
Code

Enter an expected HTTP response status code for each webhook recipient. By default, the SD-WAN Orchestrator expects webhook recipients to respond to HTTP POST requests with a status code as HTTP 200.

When SD-WAN Orchestrator receives an unexpected status code from a recipient server or a proxy server, it considers that the alert delivery has failed, and generates an ALERT_DELIVERY_FAILED customer event. This event helps to identify when a webhook recipient server may fail to function as expected.

Secret

Specify a secret token for each configured webhook recipient, which is used to compute an HMAC for each Webhook request sent to the corresponding recipient. The HMAC is embedded in a X-Webhook-Signature HTTP header, along with a version parameter, which identifies the signature algorithm and a timestamp.

X-Webhook-Signature: v=<signature-version>&t=<timestamp>&s=<hmac> 
The recipient interprets the components as follows:
  • v: Version of the algorithm used to produce the signature. The only supported value is 1.
  • t: Millisecond-precision epoch timestamp corresponding to the time at which the request is issued.
  • s: HMAC computed by SD-WAN Orchestrator. The HMAC is computed as follows: HMAC-SHA256(request-body + '.' + timestamp, secret).

The message used to compute the HMAC is formed by concatenating the request body, a single period, and the value of the timestamp parameter that appears in the signature header. The specific HMAC algorithm used to produce the code is HMAC-SHA256.

After receiving a Webhook request, the listening server can verify the authenticity of the request by computing its own HMAC-SHA256 signature according to the same algorithm and compare the newly-computed signature with the one generated by the SD-WAN Orchestrator.

JSON Payload Template

This is a required field.

SD-WAN Orchestrator delivers alert notifications to each webhook recipient, through a JSON payload contained within the body of an outgoing HTTP POST request.

SD-WAN Orchestrator generates payload content dynamically, as notifications are sent by performing variable interpolation. The supported placeholder variables in the user-configured payload template are replaced with alert-specific values.

Webhook payload templates support the following placeholder variables:
  • alertTime - Time at which the alert got triggered.
  • alertType - The type of the alert, like EDGE_DOWN, LINK_UP, VNF_VM_DEPLOYED.
  • customer - Name of the customer to whom the notification is sent.
  • customerLogicalId - The logical ID of the customer to whom the notification is sent.
  • deviceLogicalId - The logical ID of the Edge to which the alert is applied.
  • entityAffected - Name of the entity, like Edge or link or VNF, to which the alert is applied.
  • lastContact - The time at which the affected Edge most recently communicated with the SD-WAN Orchestrator. This is applicable only for the Edge alerts.
  • message - A brief message describing the event that triggered the alert.
  • VCO - Hostname or public IP of the SD-WAN Orchestrator from which the notification is sent.
  • deviceName - The name of the Edge to which the alert is applied.
  • deviceDescription - A brief message describing the Edge to which the alert is applied.
  • deviceSerialNumber - The serial number of the Edge to which the alert is applied.

The following example shows a sample JSON payload template:

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

You can click the plus (+) Icon to add more target URLs and the corresponding details.

Click Test to check the Webhook alerts.

Whenever an alert is triggered, an alert message along with relevant information is sent to the target URL.