SD-WAN Orchestrator 允许配置警示,以便在每次发生事件时通知操作员、企业管理员或其他支持用户。

注: 如果以具有客户支持特权的用户身份登录,您可以查看警示和其他对象,但无法对其进行配置。

在企业门户中,单击配置 (Configure) > 警示和通知 (Alerts & Notifications) 以配置警示。

选择需要发送警示的事件,然后在选择警示 (Select Alerts) 下面输入通知延迟时间(以分钟为单位)。

您可以使用 EDIT_ALERT_CONFIGURATION 事件记录对企业警示配置所做的更改。

配置警示和通知

客户 (Customers) 下面,显示现有管理员用户的联系人详细信息。您可以选中“电子邮件”(Email) 和“短信”(SMS) 复选框,以向相应的用户发送警示。

这些警示将发送给管理整个 SD-WAN Orchestrator 的操作员团队和客户。

发送给操作员的警示称为预先通知警示,因为它们是立即发送的。客户或企业警示可能会出现延迟,该延迟是由企业管理员配置的。

例如,链路关闭警示可能会发送到操作员配置的目标和客户配置的目标。假设某个链路关闭一分钟,并且客户将链路关闭警示延迟配置为 2 分钟。如果为该链路启用了预先通知警示,Orchestrator 将向操作员发送链路关闭警示,但客户不会收到警示,因为它低于配置的延迟。

SNMP 陷阱

简单网络管理协议 (Simple Network Management Protocol, SNMP) 陷阱是发送到 SNMP 代理的通知,以指示发生了事件。 SD-WAN Orchestrator 发送与现有警示(如“Edge 已关闭”(Edge Down) 和“Edge 已启动”(Edge Up))对应的 SNMP 陷阱。您可以在 SNMP 陷阱 (SNMP Traps) 下面选择 SNMP 版本并输入相应的详细信息。
注: 目前,SNMP v3 陷阱仅支持 SHA-1 和 AES-128 算法。

Webhook

Webhook 将数据传送到其他应用程序,这由使用 HTTP POST 的特定警示触发。每次发生警示时,源将会向为 Webhook 配置的目标应用程序发送 HTTP 请求。

SD-WAN Orchestrator 支持 Webhook,在发生事件时,它自动通过 HTTP POST 向目标应用程序发送消息。您可以在企业门户中设置目标 URL,并自动执行操作以响应 SD-WAN Orchestrator 触发的警示。Webhook 接收方必须支持 HTTPS 并具有有效的证书,以确保潜在敏感的警示负载的保密性。这也会防止对负载进行篡改。

配置 Webhook

警示配置 (Alert Configuration) 窗口中,您可以在 Webhook 下面输入以下详细信息。

选项 描述
URL 输入有效的 HTTPS URL。这将用作 Webhook 的目标应用程序。
代码 (Code)

为每个 Webhook 接收方输入预期的 HTTP 响应状态代码。默认情况下,SD-WAN Orchestrator 要求 Webhook 接收方提供状态代码 HTTP 200 以响应 HTTP POST 请求。

如果 SD-WAN Orchestrator 从接收方服务器或代理服务器收到意外的状态代码,则认为警示传送失败并生成一个 ALERT_DELIVERY_FAILED 客户事件。该事件有助于确定 Webhook 接收方服务器何时无法正常工作。

密钥 (Secret)

为每个配置的 Webhook 接收方指定一个密钥令牌,该令牌用于计算发送到相应接收方的每个 Webhook 请求的 HMAC。HMAC 以及版本参数嵌入在 X-Webhook-Signature HTTP 标头中,该参数指定签名算法和时间戳。

X-Webhook-Signature: v=<signature-version>&t=<timestamp>&s=<hmac> 
接收方按以下方式解释这些组件:
  • v:用于生成签名的算法的版本。唯一支持的值为 1
  • t:与发出请求的时间对应的毫秒精度纪元时间戳。
  • s:由 SD-WAN Orchestrator 计算的 HMAC。HMAC 的计算方法如下所示:HMAC-SHA256(request-body + '.' + timestamp, secret)

用于计算 HMAC 的消息的组成方式是,将请求正文、单个句点以及签名标头中显示的时间戳参数值串联在一起。用于生成代码的特定 HMAC 算法为 HMAC-SHA256。

在收到 Webhook 请求后,侦听服务器可以根据相同的算法计算自己的 HMAC-SHA256 签名,并将新计算的签名与 SD-WAN Orchestrator 生成的签名进行比较以验证请求的真实性。

JSON 负载模板 (JSON Payload Template)

这是必填字段。

SD-WAN Orchestrator 通过出站 HTTP POST 请求正文中包含的 JSON 负载将警示通知发送到每个 Webhook 接收方。

SD-WAN Orchestrator 动态地生成负载内容,因为通知是通过执行变量插值发送的。用户配置的负载模板中支持的占位符变量将替换为警示特定的值。

Webhook 负载模板支持以下占位符变量:
  • alertTime - 触发警示的时间。
  • alertType - 警示类型,如 EDGE_DOWN、LINK_UP、VNF_VM_DEPLOYED。
  • customer - 将通知发送到的客户的名称。
  • customerLogicalId - 将通知发送到的客户的逻辑 ID。
  • deviceLogicalId - 将应用警示的 Edge 的逻辑 ID。
  • entityAffected - 将警示应用到的实体(如 Edge、链路或 VNF)的名称。
  • lastContact - 受影响的 Edge 最近与 SD-WAN Orchestrator 进行通信的时间。这仅适用于 Edge 警示。
  • message - 描述触发警示的事件的简短消息。
  • VCO - 从中发送通知的 SD-WAN Orchestrator 的主机名或公用 IP。
  • deviceName - 将应用警示的 Edge 的名称。
  • deviceDescription - 描述将应用警示的 Edge 的简短消息。
  • deviceSerialNumber - 将应用警示的 Edge 的序列号。

下面显示了一个示例 JSON 负载模板:

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

您可以单击加号 (+) 图标以添加更多目标 URL 和相应的详细信息。

单击测试 (Test) 以检查 Webhook 警示。

每次触发警示时,将向目标 URL 发送一条警示消息以及相关的信息。