Ajoutez un plug-in REST afin d'envoyer des alertes vRealize Operations Cloud à une autre application REST hébergeant un service Web REST pour accepter ces messages. Vous pouvez également utiliser votre proxy Cloud pour communiquer.

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>
Note : 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.

Conditions préalables

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.

Procédure

  1. Dans le menu, cliquez sur Administration, puis dans le volet de gauche, cliquez sur Gestion.
  2. Cliquez sur Paramètres sortants, puis sur Ajouter.
  3. Dans le menu déroulant Type de plug-in, sélectionnez Plug-in notification REST.
    La boîte de dialogue se développe pour inclure vos paramètres REST.
  4. Vous pouvez aussi cliquer sur la case à cocher Utiliser le proxy, puis sélectionner le proxy Cloud dans le menu déroulant Collecteur/groupe pour établir une connexion.
    Note : Vous devez utiliser un proxy Cloud si votre serveur de messagerie ou Rest se trouve en dehors d'AWS.
  5. 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.
  6. 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. L'algorithme SHA1 ou SHA256 peut être utilisé.
    Note : Il est obligatoire d'ajouter l'empreinte numérique de certificat dans vRealize Operations Cloud.
    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.

  7. Cliquez sur Enregistrer.
  8. 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 Cloud.