Aller au contenu principal

Acheminement des événements vers un service Web REST

Vous pouvez configurer Lenovo XClarity Orchestrator pour l'acheminement d'événements spécifiques vers un service Web REST.

Avant de commencer

Avertissement
Aucune connexion sécurisée n’est établie lors du réacheminement des données vers ce service. Les données sont envoyées via un protocole texte en clair.

À propos de cette tâche

Si le contrôle d’accès basé sur les ressources est activé, les données sont transférées uniquement pour les ressources auxquelles vous pouvez accéder à l’aide de listes de contrôle d’accès. Si vous n’êtes pas membre d’un groupe auquel le rôle Superviseur prédéfini est attribué, vous devez attribuer une ou plusieurs listes de contrôle d’accès aux réexpéditeurs que vous créez. Si vous souhaitez envoyer des données pour toutes les ressources auxquelles vous pouvez accéder, sélectionnez toutes les listes de contrôle d’accès associées disponibles. Si vous êtes membre d’un groupe auquel le rôle Superviseur prédéfini est attribué, vous pouvez choisir d’envoyer des données pour toutes les ressources ou d’affecter des listes de contrôle afin de limiter les ressources.

Des filtres de réacheminement de données courants sont utilisés pour définir la portée des événements que vous souhaitez acheminer, en fonction de codes d'événement, de classes d'événement, de gravités d'événement, de types de maintenance et de ressources qui ont généré l'événement. Assurez-vous que les filtres de ressources et d’appareils que vous souhaitez utiliser ce réexpéditeur sont déjà créés (voir Création de filtres de réacheminement des données).

L'exemple suivant illustre le format par défaut pour les données acheminées vers un service Web REST. Les mots entre crochets doubles sont les attributs qui sont remplacés par des valeurs réelles lors de l'acheminement des données.
{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

Procédure

Pour transmettre les données d'un service Web REST, procédez comme suit.

  1. Dans la barre de menus deXClarity Orchestrator cliquez sur Surveillance (Icône Surveillance) > Acheminement, puis cliquez sur Réexpéditeurs de données dans la navigation de gauche pour afficher la carte Réexpéditeurs de données.
  2. Cliquez sur l'icône Créer (Icône Ajouter) pour afficher la boîte de dialogue Créer un réexpéditeur de données.
  3. Indiquez le nom de réexpéditeeur et une description facultative.
  4. Choisissez d'activer ou de désactiver le réexpéditeur en cliquant sur le commutateur État.
  5. Sélectionnez le type de réexpéditeur REST.
  6. Cliquez sur Configuration, puis indiquez les informations spécifiques au protocole.
    • Entrez le nom d'hôte ou l'adresse IP du serveur REST.
    • Entrez le port à utiliser pour l'acheminement des événements. La valeur par défaut est 80.
    • Entrez le chemin d’accès aux ressources sur lequel le réexpéditeur doit publier les événements (par exemple, /rest/test).
    • Sélectionnez la méthode REST. Les valeurs possibles sont les suivantes.
      • PUT
      • POST
    • Sélectionnez le protocole à utiliser pour l'acheminement des événements. Les valeurs possibles sont les suivantes.
      • HTTP
      • HTTPS
    • Entrez le délai d’attente (en secondes) pour la demande. La valeur par défaut est 30 secondes.
    • Si l'authentification est requise, sélectionnez l'un des types d'authentification suivants.
      • Base. Effectue l'authentification auprès du serveur spécifié à l'aide de l'ID utilisateur et du mot de passe spécifiés.
      • Jeton. Effectue l'authentification auprès du serveur spécifié à l'aide du nom d'en-tête du jeton et de la valeur.
  7. Cliquez sur Filtres, puis sélectionnez les filtres d’événements que vous souhaitez utiliser pour ce réexpéditeur.

    Vous pouvez sélectionner un filtre d’événements et un filtre de la ressource maximum.

    Si vous ne sélectionnez pas de filtre, les données sont transférées pour tous les événements générés par toutes les ressources (appareils, gestionnaires de ressources et XClarity Orchestrator).

    À partir de cet onglet, vous pouvez également choisir d’acheminer l’événement exclu en définissant Événements exclus sur Oui.

  8. Cliquez sur Listes de contrôle d’accès, puis sélectionnez une ou plusieurs listes de contrôle d’accès que vous souhaitez associer à ce réexpéditeur.

    Si l’accès basé sur les ressources est activé, vous devez sélectionner au moins une liste de contrôle d’accès.

    Conseil
    les utilisateurs qui font partie d’un groupe auquel le rôle Superviseur prédéfini est attribué peuvent, en option, sélectionner Faire correspondre tous les éléments au lieu de sélectionner des listes de contrôle d’accès afin que les données transférées ne soient pas restreintes.
  9. Cliquez sur Créer pour créer le réexpéditeur.

Après avoir terminé

Vous pouvez effectuer les actions suivantes à partir de la carte Réexpéditeurs de données.

  • Activer ou désactiver un réexpéditeur sélectionné en sélectionnant le bouton bascule dans la colonne État
  • Modifier un réexpéditeur sélectionné en cliquant sur l'icône Éditer (Icône Editer).
  • Retirer un réexpéditeur sélectionné en cliquant sur l'icône Supprimer (Icône Supprimer).