Sie können einen Webhook konfigurieren, um Warnungsbenachrichtigungen an einen entfernten Webserver zu senden. Webhooks stellen Benachrichtigungen über HTTP POST/PUT bereit.

Voraussetzungen

  • Vergewissern Sie sich, dass Sie bei der VMware Aria Operations for Logs-Web-Benutzeroberfläche als Super-Admin-Benutzer oder als Benutzer mit einer Rolle angemeldet sind, die über die entsprechenden Berechtigungen verfügt. Weitere Informationen finden Sie unter Erstellen und Ändern von Rollen. Das URL-Format der Web-Benutzeroberfläche lautet https://operations-for-logs-host, wobei operations-for-logs-host die IP-Adresse oder der Hostname der virtuellen VMware Aria Operations for Logs-Appliance ist.

  • Wenn Sie einen Webhook mit einem VMware Aria Automation Orchestrator-Endpoint erstellen, stellen Sie sicher, dass Sie einen Workflow in VMware Aria Automation Orchestrator erstellt haben. Weitere Informationen finden Sie unter Erstellen von Workflows im VMware Aria Automation Orchestrator-Client.

Prozedur

  1. Erweitern Sie das Hauptmenü und navigieren Sie zu Konfiguration > Webhooks.
  2. Klicken Sie auf Neuer Webhook.
  3. Geben Sie im Textfeld Name einen Namen für den Webhook ein.
  4. Geben Sie die folgenden Informationen ein.
    Option Beschreibung
    Endpoint Wählen Sie den Endpoint-Typ aus, an den Sie die Benachrichtigung senden möchten:
    • Slack
    • Pager Duty
    • Orchestrator
    • Benutzerdefiniert

    Je nach ausgewähltem Endpoint-Typ bietet die Benutzeroberfläche zusätzliche Eingabeoptionen.

    Die Benutzeroberfläche füllt auch die Webhook-Nutzlast mit einer vordefinierten Vorlage, die Sie entsprechend Ihren Anforderungen anpassen können.

    Protokollnutzlast Wählen Sie aus, ob Sie eine Webhook-Benachrichtigung für jedes Ergebnis, das mit der entsprechenden Warnungsabfrage übereinstimmt, oder eine einzelne Webhook-Benachrichtigung für alle übereinstimmenden Ergebnisse senden möchten.
    • Zum Senden einer einzigen Webhook-Benachrichtigung für alle übereinstimmenden Ergebnisse wählen Sie Protokoll-Stream aus.
    • Zum Senden einer Webhook-Benachrichtigung für jedes übereinstimmende Ergebnis wählen Sie Einzelne Protokolle aus.
    Webhook-URL Geben Sie die URL für den Remote-Webserver ein, auf dem Sie die Webhook-Benachrichtigungen veröffentlichen möchten. Das URL-Format ändert sich basierend auf der Auswahl des Endpoints. Das Beispielformat wird im Textfeld bereitgestellt.
    Hinweis: In der VMware Aria Automation Orchestrator-Endpoint-URL müssen Sie die ID des entsprechenden Workflows angeben, der in VMware Aria Automation Orchestrator erstellt wurde.

    Klicken Sie nach Eingabe der URL auf Testwarnung, um die Verbindung zu überprüfen.

    Sie können mehrere Webhook-URLs getrennt durch ein Leerzeichen eingeben.

    Webproxy Wenn Sie einen oder mehrere HTTP-Proxys konfiguriert haben, wählen Sie einen Proxy aus dem Dropdown-Menü aus. VMware Aria Operations for Logs sendet Webhook-Benachrichtigungen an den Endpoint über den ausgewählten Proxy.
    Integrationsschlüssel Wenn Sie Pager Duty als Endpoint-Typ auswählen, geben Sie einen Integrationsschlüssel für Webhook-Anforderungen ein.
    Erweiterte Einstellungen Wenn Sie Orchestrator oder Benutzerdefiniert als Endpoint-Typ auswählen, müssen Sie weitere Informationen angeben.

    Für den Endpoint-Typ Orchestrator können Sie:

    • Den Namen und den Wert der Benutzerdefinierte Kopfzeile zur Autorisierung von VMware Aria Automation Orchestrator-Anforderungen eingeben. Zu den Autorisierungsoptionen gehören:
      • Standardauthentifizierung – Beibehalten des Standardwerts Autorisierung im ersten Textfeld. Geben Sie im zweiten Textfeld einen Wert im Format Basic Base64_encoded_string_for_username_and_password ein.
      • Bearer-Token-Authentifizierung – Beibehalten des Standardwerts Autorisierung im ersten Textfeld. Geben Sie im zweiten Textfeld einen Wert im Format Bearer bearer_token ein.
    • Wählen Sie den Inhaltstyp. Der Standardwert für Inhaltstyp ist JSON. Sie können den Wert bei Bedarf in XML ändern. Die Webhook-Nutzlast wird entsprechend dem ausgewählten Inhaltstyp generiert.

    Für den Endpoint-Typ Benutzerdefinierter können Sie:

    • Eine Aktion auswählen, z. B. POST und PUT. Die Standardaktion ist POST.
    • Aktivieren Sie das Kontrollkästchen Standardauthentifizierung hinzufügen und geben Sie den Benutzernamen und das Kennwort ein, um die Anmeldedaten beim Server zu authentifizieren.
    • Fügen Sie der Anforderung unter Benutzerdefinierte Kopfzeilen Kopfzeilen hinzu, um ggf. zusätzliche Informationen anzugeben.
    Webhook-Nutzlast

    Dieser Bereich wird basierend auf Ihrer Auswahl im Dropdown-Menü Endpoint-Typ automatisch ausgefüllt. Sie können die Nutzlast anpassen, die als Vorlage für den Text dient, der als Teil der POST/PUT-Webhook-Benachrichtigungsanforderung gesendet wird. Der Text kann im XML- oder JSON-Format vorliegen.

    Die Parameter in der Nutzlast werden beim Senden der Webhook-Benachrichtigung durch die tatsächlichen Werte ersetzt. Der Parameter $(AlertName) wird beispielsweise durch den Namen der Warnung ersetzt.

    Hinweis: Für den Endpoint-Typ Orchestrator müssen die Parameter mit den Eingabe- oder Ausgabeparametern im entsprechenden in VMware Aria Automation Orchestrator erstellten Workflow übereinstimmen.
    Parameter Verwenden Sie die Liste der Parameter, um die Webhook-Nutzlast zu erstellen oder zu ändern:
    • 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
    Hinweis: Mit Ausnahme von messagesString haben alle anderen Zeichenfolgenparameter-Typen denselben Inhalt.
  5. Klicken Sie auf Speichern.
    Der Webhook wird erstellt. Sie können vor dem Webhook-Namen auf das Symbol Verfügbare Aktionen klicken, um den Webhook anzuzeigen, zu bearbeiten oder zu löschen.

Nächste Maßnahme

Konfigurieren Sie eine Warnung, um Webhook-Benachrichtigungen an den ausgewählten Endpoint zu senden. Weitere Informationen finden Sie unter Hinzufügen einer Warnung zum Senden von Webhook-Benachrichtigungen.

Nach der Konfiguration der Warnung können Sie die Webhook-Benachrichtigungen im Endpoint anzeigen. In VMware Aria Automation Orchestrator werden die Webhook-Benachrichtigungen beispielsweise als Workflow-Ausführungen aufgelistet. In jeder Workflow-Ausführung werden die Werte für die Nutzlastparameter im Abschnitt „Variablen“ angezeigt.