Añada un complemento de REST para poder enviar alertas de vRealize Operations Manager a otra aplicación con REST habilitado en la que ha creado un servicio web REST para aceptar estos mensajes.

Antes de empezar

Asegúrese de que sabe cómo y dónde se consumen y se procesan las alertas enviadas mediante el complemento de REST en su entorno y de que dispone de la información de conexión correspondiente.

Por qué y cuándo se efectúa esta tarea

El complemento de REST permite que se habilite una integración, pero no proporciona una. En función de su aplicación de destino, es posible que necesite un servicio REST intermediario o algún otro mecanismo que correlacione los identificadores de alerta y de objeto incluidos en la salida de la alerta de REST con los identificadores de su aplicación de destino.

Determine el tipo de contenido que proporciona a su aplicación de destino. Si selecciona aplicación/json, el cuerpo de las llamadas POST o PUT que se envían presentan el siguiente formato. Se incluyen datos de muestra.

{
   "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"
}

Si selecciona aplicación/xml, el cuerpo de las llamadas POST o PUT que se envían presentan el siguiente formato:

<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>

Nota:

Si la alerta se activa a causa de una infracción no relacionada con una métrica, attributeKeyID se omite de la salida REST y no se envía.

Si se procesa la solicitud como POST, ya sea JSON o XML, el servicio web devuelve un código de estado HTTP de 201, que indica que la alerta se ha creado correctamente en el destino. Si se procesa la solicitud como PUT, el código de estado HTTP es 202, que indica que la alerta se ha aceptado correctamente en el destino.

Procedimiento

  1. En el panel izquierdo de vRealize Operations Manager, haga clic en el icono Administración.
  2. Haga clic en Configuración de salida y haga clic en el signo de más para añadir un complemento.
  3. En el menú desplegable Tipo de complemento, seleccione Complemento de notificación de Rest.

    El cuadro de diálogo se expande para incluir su configuración de REST.

  4. Introduzca un Nombre de instancia.

    Este es el nombre que identifica la instancia que seleccionará cuando configure las reglas de notificación.

  5. Configure las opciones de Rest correspondientes a su entorno.

    Opción

    Descripción

    URL

    URL a la que envía las alertas. La URL debe ser compatible con HTTPS. Cuando se envía una alerta al servidor web REST, el complemento agrega /{alertID} a la llamada POST o PUT.

    Nombre de usuario

    Nombre de usuario en el sistema REST de destino.

    Contraseña

    Contraseña de la cuenta de usuario.

    Tipo de contenido

    Especifique el formato de salida de la alerta.

    • aplicación/json. Los datos de alertas se transmiten mediante notación de objetos JavaScript como texto en lenguaje natural.

    • aplicación/xml. Los datos de alertas se transmiten mediante XML, que incluye contenido en lenguaje natural y en lenguaje de programación.

    Huella digital de certificado

    Huella digital del certificado público para su servicio HTTPS.

    Número de conexiones

    Limita el número de alertas simultáneas que se envían al servidor REST de destino. Utilice este número para garantizar que su servidor REST no se sobrecargue con solicitudes.

  6. Haga clic en Guardar.
  7. Para iniciar el servicio de alertas de salida para este complemento, seleccione la instancia en la lista y haga clic en Habilitar en la barra de herramientas.

Resultados

Esta instancia del complemento REST para alertas de salida está configurada y en ejecución.

Qué hacer a continuación

Cree reglas de notificación que utilicen el complemento de REST para enviar alertas a una aplicación o servicio con REST habilitado de su entorno. Consulte Escenario del usuario: creación de una notificación de alerta de REST de vRealize Operations Manager.