Vous pouvez configurer un Webhook pour envoyer des notifications d'alerte à un serveur Web distant. Les Webhooks fournissent des notifications sur HTTP POST/PUT.

Conditions préalables

  • Vérifiez que vous êtes connecté à l'interface utilisateur Web de vRealize Log Insight en tant qu'utilisateur super administrateur ou en tant qu'utilisateur associé à un rôle disposant des autorisations appropriées. Pour plus d'informations, reportez-vous à la section Créer et modifier des rôles. Le format de l'URL de l'interface utilisateur Web est https://log-insight-host, où log-insight-host est l'adresse IP ou le nom d'hôte du dispositif virtuel vRealize Log Insight.

  • Si vous créez un Webhook avec un point de terminaison vRealize Orchestrator (vRO), assurez-vous d'avoir créé un workflow dans vRealize Orchestrator. Pour plus d'informations, reportez-vous à la section Créer des workflows dans vRealize Orchestrator Client.

Procédure

  1. Développez le menu principal et accédez à Alertes > Webhook.
  2. Cliquez sur Nouveau Webhook.
  3. Dans la zone de texte Nom, entrez un nom pour le Webhook.
  4. Entrez les informations suivantes.
    Option Description
    Point de terminaison Sélectionnez le point de terminaison vers lequel vous souhaitez envoyer la notification, par exemple, Slack, PagerDuty, vRO ou un point de terminaison personnalisé. Selon le type de point de terminaison sélectionné:
    • L'interface utilisateur fournit des options d'entrée supplémentaires.
    • L'interface utilisateur renseigne la charge utile de Webhook avec un modèle prédéfini, que vous pouvez personnaliser en fonction de vos besoins.
    Charge utile de journaux Indiquez si vous souhaitez envoyer une notification de Webhook pour chaque résultat correspondant à la requête d'alerte correspondante ou une notification pour tous les résultats correspondants.
    • Pour envoyer une notification de Webhook pour chaque résultat correspondant, sélectionnez Journaux individuels.
      Note : Si vous sélectionnez cette option, vous pouvez envoyer jusqu'à 10 notifications.
    • Pour envoyer une notification de Webhook pour tous les résultats correspondants, sélectionnez Flux de journaux.
    URL de Webhook Entrez l'URL du serveur Web distant sur lequel vous souhaitez publier les notifications Webhook. Le format de l'URL change en fonction de votre sélection de point de terminaison. L'exemple de format est fourni dans la zone de texte.
    Note : Dans une URL de point de terminaison vRO, vous devez inclure l'ID du workflow correspondant créé dans vRealize Orchestrator.

    Après avoir entré l'URL, cliquez sur Alerte de test pour vérifier la connexion.

    Vous pouvez entrer plusieurs URL de Webhook séparées par un espace vide.
    Proxy Web Si vous avez configuré un ou plusieurs proxys HTTP, sélectionnez un proxy dans le menu déroulant. vRealize Log Insight envoie des notifications de Webhook au point de terminaison via le proxy sélectionné.
    Clé d'intégration Si vous sélectionnez un point de terminaison PagerDuty, entrez une clé d'intégration pour les demandes de Webhook.
    Paramètres avancés Si vous sélectionnez un point de terminaison vRO ou personnalisé, entrez des informations supplémentaires telles que le type de contenu, l'autorisation, etc.
    • Pour un point de terminaison vRO, la valeur par défaut pour Type de contenu est JSON. Si nécessaire, vous pouvez la remplacer par XML. La charge utile du Webhook est générée en fonction du type de contenu sélectionné.
      Fournissez un en-tête d'autorisation pour autoriser les demandes vRO. Exemples d'options d'autorisation :
      • Authentification de base : conservez la valeur par défaut Authorization dans la première zone de texte. Dans la deuxième zone de texte, entrez une valeur au format Basic Base64_encoded_string_for_username_and_password.
      • Authentification par jeton du porteur : conservez la valeur par défaut Authorization dans la première zone de texte. Dans la deuxième zone de texte, entrez une valeur au format Bearer bearer_token.
    • Pour un point de terminaison personnalisé, la valeur par défaut de Type de contenu est JSON et celle d'Action est POST. Vous pouvez personnaliser ces options et ajouter des en-têtes supplémentaires à la demande sous En-têtes personnalisés. Si le serveur Web distant configuré nécessite une autorisation de POST/PUT de la notification de Webhook, entrez le nom d'utilisateur et le mot de passe pour vous authentifier sur le serveur dans les zones de texte Utilisateur d'autorisation et Mot de passe d'autorisation.
    Charge utile de Webhook Cette zone est renseignée automatiquement en fonction de votre sélection dans le menu déroulant Point de terminaison. Vous pouvez personnaliser la charge utile, qui est le modèle du corps envoyé dans le cadre de la demande de notification de Webhook POST/PUT. Le corps peut être au format XML ou JSON. Les paramètres de la charge utile sont remplacés par les valeurs réelles lors de l'envoi de la notification Webhook. Par exemple, le paramètre $(AlertName) est remplacé par le nom de l'alerte.
    Note : Pour un point de terminaison vRO, les paramètres doivent correspondre aux paramètres d'entrée ou de sortie du workflow correspondant créé dans vRealize Orchestrator.
    Paramètres Vous pouvez utiliser la liste des paramètres pour construire ou modifier la charge utile du Webhook.
    • AlertName
    • AlertNameString
    • AlertType
    • AlertTypeString
    • SearchPeriod
    • SearchPeriodString
    • HitOperator
    • HitOperatorString
    • messages
    • messagesString
    • HasMoreResults
    • HasMoreResultsString
    • Url
    • UrlString
    • EditUrl
    • EditUrlString
    • Info
    • InfoString
    • Recommendation
    • RecommendationString
    • NumHits
    • NumHitsString
    • TriggeredAt
    • TriggeredAtString
    • SourceInfo
    • SourceInfoString
    Note : À l'exception de messagesString, tous les autres types de paramètres de chaîne présentent le même contenu.
  5. Cliquez sur Enregistrer.

Que faire ensuite

Configurez une alerte pour envoyer des notifications Webhook au point de terminaison sélectionné. Pour plus d'informations, reportez-vous à la section Ajouter une alerte pour envoyer des notifications Webhook.

Après avoir configuré l'alerte, vous pouvez afficher les notifications Webhook dans le point de terminaison. Par exemple, dans vRO, les notifications Webhook sont répertoriées en tant qu'exécutions de workflow. Dans chaque exécution de workflow, vous pouvez consulter les valeurs des paramètres de charge utile dans la section des variables.