Ajoutez un plug-in REST afin d'envoyer des alertes vRealize Operations Manager à une autre application REST hébergeant un service Web REST pour accepter ces messages.

Avant de commencer

Vous devez savoir où et comment les alertes envoyées à l'aide du plug-in REST sont consommées et traitées dans votre environnement, et garder à portée de main les informations de connexion appropriées.

Pourquoi et quand exécuter cette tâche

Bien que le plug-in REST prenne en charge l'activation d'une intégration, il ne la fournit pas. Selon votre application cible, il se peut que vous ayez besoin d'un service REST intermédiaire ou d'un autre mécanisme qui mettra en corrélation l'alerte et les identificateurs d'objets inclus dans la sortie de l'alerte REST avec les identificateurs de votre application cible.

Déterminez le type de contenu que vous fournissez à votre application cible. Si vous sélectionnez application/json, le corps des appels POST ou PUT envoyés est au format suivant. Des exemples de données sont inclus.

{
   "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 vous sélectionnez application/xml, le corps des appels POST ou PUT envoyés est au format suivant.

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

Remarque :

Si l'alerte est déclenchée par une violation autre qu'un dépassement de mesure, le attributeKeyID n'est pas ajouté à la sortie REST est n'est pas envoyé.

Si la demande est traitée comme un appel POST, pour JSON ou XML, le service Web retourne le code d'état HTTP de 201, qui indique que l'alerte a été correctement créée sur la cible. Si la demande est traitée comme un appel PUT, le service Web retourne le code d'état HTTP de 202, qui indique que l'alerte a été correctement acceptée sur la cible.

Procédure

  1. Dans le volet gauche de vRealize Operations Manager, cliquez sur l'icône Administration.
  2. Cliquez sur Paramètres sortants et sur le signe plus pour ajouter un plug-in.
  3. Dans le menu déroulant Type de plug-in, sélectionnez Plug-in de notification REST.

    La boîte de dialogue se développe pour inclure vos paramètres REST.

  4. Entrez un Nom d'instance.

    Il s'agit du nom qui identifie l'instance que vous sélectionnerez lorsque vous configurerez les règles de notification ultérieurement.

  5. Configurez les options Rest adaptées à votre environnement.

    Option

    Description

    URL

    URL à laquelle vous envoyez les alertes. L'URL doit prendre en charge HTTPS. Lorsqu'une alerte est envoyée au serveur Web REST, le plug-in ajoute /{alertID} à l'appel POST ou PUT.

    Nom d'utilisateur

    Compte d'utilisateur sur le système REST cible.

    Mot de passe

    Mot de passe du compte d'utilisateur.

    Type de contenu

    Spécifiez le format de la sortie de l'alerte.

    • application/json. Les données de l'alerte sont transmises à l'aide de JavaScript Object Notation (JSON) sous la forme d'un texte lisible.

    • application/xml. Les données de l'alerte sont transmises à l'aide de XML qui est un contenu lisible par l'utilisateur et lisible par une machine.

    Empreinte du certificat

    Empreinte du certificat public pour votre service HTTPS.

    Nombre de connexions

    Limite le nombre d'alertes simultanées qui sont envoyées au serveur REST cible. Utilisez ce nombre pour vous assurer que votre serveur REST n'est pas submergé de demandes.

  6. Cliquez sur Enregistrer.
  7. Pour démarrer le service d'alerte sortante pour ce plug-in, sélectionnez l'instance dans la liste et cliquez sur Activer dans la barre d'outils.

Résultats

Cette instance du plug-in REST pour les alertes sortantes est configurée et en cours d'exécution.

Que faire ensuite

Créez des règles de notification qui utilisent le plug-in REST pour envoyer des alertes à une application ou un service compatible avec REST dans votre environnement. Reportez-vous à Scénario utilisateur : créer une notification d'alerte REST vRealize Operations Manager.