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 VMware Aria Operations for Logs 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.

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

Procédure

  1. Développez le menu principal et accédez à Configuration > Webhooks.
  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 type de point de terminaison auquel vous souhaitez envoyer la notification :
    • Slack
    • Pager Duty
    • Orchestrator
    • Personnalisé

    Selon le type de point de terminaison que vous sélectionnez, l'interface utilisateur fournit des options d'entrée supplémentaires.

    L'interface utilisateur renseigne également 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 Webhook pour chaque résultat correspondant à la requête d'alerte correspondante ou une notification de Webhook unique pour tous les résultats correspondants.
    • Pour envoyer une notification Webhook unique pour tous les résultats correspondants, sélectionnez Flux de journaux.
    • Pour envoyer une notification Webhook pour chaque résultat correspondant, sélectionnez Journaux individuels.
    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 VMware Aria Automation Orchestrator, vous devez inclure l'ID du workflow correspondant créé dans VMware Aria Automation 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. VMware Aria Operations for Logs envoie des notifications Webhook au point de terminaison via le proxy sélectionné.
    Clé d'intégration Si vous sélectionnez Pager Duty comme point de terminaison, entrez une clé d'intégration pour les demandes de Webhook.
    Paramètres avancés Si vous sélectionnez Orchestrator ou Personnalisé comme type de point de terminaison, vous devez fournir plus d'informations.

    Pour le type de point de terminaison Orchestrator, vous pouvez effectuer les opérations suivantes :

    • Entrez le nom et la valeur de l'option En-tête personnalisé pour autoriser les demandes VMware Aria Automation Orchestrator. 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.
    • Sélectionnez le type de contenu. La valeur par défaut de Type de contenu est JSON. Si nécessaire, vous pouvez la remplacer par XML. La charge utile de Webhook est générée en fonction du type de contenu sélectionné.

    Pour le type de point de terminaison Personnalisé, vous pouvez effectuer les opérations suivantes :

    • Sélectionnez une Action, telle que POST et PUT. L'action par défaut est POST.
    • Cochez la case Ajouter l'authentification de base et entrez le nom d'utilisateur et le mot de passe pour authentifier les informations d'identification auprès du serveur.
    • Ajoutez des en-têtes à la demande sous En-têtes personnalisés pour fournir des informations supplémentaires, le cas échéant.
    Charge utile de Webhook

    Cette zone est renseignée automatiquement en fonction de votre sélection dans le menu déroulant Type de 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 le type de point de terminaison Orchestrator, les paramètres doivent correspondre aux paramètres d'entrée ou de sortie du workflow correspondant créé dans VMware Aria Automation Orchestrator.
    Paramètres Utilisez la liste de paramètres pour créer ou modifier la charge utile de 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.
    Le webhook est créé. Vous pouvez cliquer sur l'icône Actions disponibles devant le nom du Webhook pour afficher, modifier ou supprimer le Webhook.

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 VMware Aria Automation Orchestrator, 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.