添加 REST 插件后,可向启用 REST 的其他应用程序发送 vRealize Operations Cloud 警示,您已在此应用程序中构建了 REST Web 服务以接受这些消息。或者,您也可以使用云代理进行通信。

REST 插件支持启用集成,但并不提供集成。根据您的目标应用程序,可能需要中间 REST 服务或其他某些机制,将 REST 警示输出中包含的警示和对象标识符与目标应用程序中的标识符相关联。

确定您正向目标应用程序发送的内容类型。如果选择 application/json,则发送的 POST 或 PUT 调用的正文采用以下格式。将包含示例数据。
{
   "startDate":1369757346267,
   "criticality":"ALERT_CRITICALITY_LEVEL_WARNING",
   "Risk":4.0,
   "resourceId":"sample-object-uuid",
   "alertId":"sample-alert-uuid",
   "status":"ACTIVE",
   "subType":"ALERT_SUBTYPE_AVAILABILITY_PROBLEM",
   "cancelDate":1369757346267,
   "resourceKind":"sample-object-type",
   "alertName":"Invalid IP Address for connected Leaf Switch",
   "attributeKeyID":5325,
   "Efficiency":1.0,
   "adapterKind":"sample-adapter-type",
   "Health":1.0,
   "type":"ALERT_TYPE_APPLICATION_PROBLEM",
   "resourceName":"sample-object-name",
   "updateDate":1369757346267,
   "info":"sample-info"
}
如果选择 application/xml,则发送的 POST 或 PUT 调用的正文采用以下格式:
<alert>
  <startDate>1369757346267</startDate>
  <criticality>ALERT_CRITICALITY_LEVEL_WARNING</criticality>
  <Risk>4.0</Risk>
  <resourceId>sample-object-uuid</resourceId>
  <alertId>sample-alert-uuid</alertId>
  <status>ACTIVE</status>
  <subType>ALERT_SUBTYPE_AVAILABILITY_PROBLEM</subType>
  <cancelDate>1369757346267</cancelDate>
  <resourceKind>sample-object-type</resourceKind>
  <alertName>Invalid IP Address for connected Leaf Switch</alertName>
  <attributeKeyId>5325</attributeKeyId>
  <Efficiency>1.0</Efficiency>
  <adapterKind>sample-adapter-type</adapterKind>
  <Health>1.0</Health>
  <type>ALERT_TYPE_APPLICATION_PROBLEM</type>
  <resourceName>sample-object-name</resourceName>
  <updateDate>1369757346267</updateDate>
  <info>sample-info</info>
</alert>
注: 如果警示由非衡量指标冲突触发,则 attributeKeyID 不会出现在 REST 输出中,也不会被发送。

如果以 POST 形式处理请求,则对于 JSON 或 XML 来说,Web 服务将返回 HTTP 状态代码 201,表示已在目标上成功创建警示。如果以 PUT 形式处理请求,则将返回 HTTP 状态代码 202,表示已在目标上成功接受警示。

前提条件

确保您知道使用 REST 插件发送的警示在您的环境中是在何处以何种方式使用和处理的,同时确保相应的连接信息可用。

过程

  1. 从左侧菜单中,单击配置 > 警示,然后在右侧窗格中单击出站设置
  2. 单击添加,然后从插件类型下拉菜单中,选择 REST 通知插件
    此时将展开对话框以包括您的 REST 设置。
  3. (可选)单击使用代理复选框,然后从收集器/组下拉菜单中选择云代理以建立连接。
    注: 如果您的邮件或 REST 服务器位于 AWS 之外,则必须使用云代理。
  4. 输入实例名称
    此名称用于标识您以后配置通知规则时选择的实例。
  5. 配置适用于您环境的 Rest 选项。
    选项 描述
    URL

    将向其发送警示的 URL。此 URL 必须支持 HTTPS。当向 REST Web 服务器发送警示时,插件会在 POST 或 PUT 调用后附加 /{alertID}

    用户名

    目标 REST 系统上的用户帐户。

    密码

    用户帐户密码。

    内容类型

    指定警示输出的格式。

    • application/json。使用 JavaScript Object Notation 传输人工可读文本格式的警示数据。
    • application/xml。使用 XML 传输人工可读和机器可读内容格式的警示数据。
    证书指纹
    您的 HTTPS 服务的公共证书的指纹。可以使用 SHA1 或 SHA256 算法。
    注: 必须在 vRealize Operations Cloud 中添加证书指纹。
    连接计数

    限制同时发送到目标 REST 服务器的警示数目。使用此数目可确保 REST 服务器不会因请求过多而崩溃。

  6. 单击保存
  7. 要为此插件启动出站警示服务,请在列表中选择实例并单击工具栏上的启用

结果

出站警示的此 REST 插件实例已配置且正在运行。

下一步做什么

创建使用 REST 插件向您环境中启用 REST 的应用程序或服务发送警示的通知规则。请参见用户方案:创建 vRealize Operations Cloud REST 警示通知