Konfiguration einer ausgehenden Integration zur Verbindung von IBM Cloud Logs mit IBM Cloud Event Notifications

Um Ereignisse zu senden, die erzeugt werden, wenn ein Alarm in einer IBM Cloud Logs Instanz ausgelöst wird, müssen Sie Ihre IBM Cloud Logs Instanz mit Event Notifications verbinden, indem Sie eine ausgehende Integration konfigurieren.

Voraussetzungen

  • Erfahren Sie mehr über Warnmeldungen in IBM Cloud Logs. Weitere Informationen finden Sie unter Alarmierung.
  • Erfahren Sie mehr über IBM Cloud Event Notifications. Weitere Informationen finden Sie unter Was ist IBM Cloud Event Notifications?
  • Bevor Sie Benachrichtigungen für IBM Cloud Logs aktivieren können, müssen Sie sicherstellen, dass Sie über eine Instanz Event Notifications und die Berechtigung zur Konfiguration von Ressourcen in der Instanz Event Notifications verfügen.

Schritt 1. Definieren Sie eine Dienst-zu-Dienst-Berechtigung

Eine Dienst-zu-Dienst-Autorisierung wird im Konto IBM Cloud verwendet, um den Dienst IBM Cloud Logs zu autorisieren, Ereignisse an den Dienst Event Notifications zu senden.

Sie müssen einen Dienst für die Autorisierung zwischen der Instanz IBM Cloud Logs und der Instanz Event Notifications konfigurieren. Weitere Informationen finden Sie unter Erstellen einer S2S für die Arbeit mit dem IBM Cloud Event Notifications Service.

Schritt 2. Konfigurieren einer ausgehenden Integration über die API

Sie können eine ausgehende Integration mit Hilfe der API erstellen. Weitere Informationen über die API-Methode finden Sie unter Erstellen einer ausgehenden Integration.

Sie können über die API nur die Integration zwischen einer IBM Cloud Logs-Instanz und einer Event Notifications-Instanz konfigurieren, die sich in unterschiedlichen Konten befinden.

Sie können zum Beispiel den folgenden Befehl cURL verwenden, um eine Integration über die API zu erstellen:

curl -X POST "https://API-ENDPOINT/v1/outgoing_webhooks" \
 -H "Authorization: ${IAM_TOKEN}" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \
 -d '{
  "type": "ibm_event_notifications",
  "name": "<NAME>",
  "ibm_event_notifications": {
   "event_notifications_instance_id": "<EventNotificationsInstanceID>",
   "region_id": "<Region-of-EventNotifications-Instance>",
   "endpoint_type": "default_or_public"
  }
 }'

Wo

  • API-ENDPOINT: Legen Sie den API-Endpunkt für die Instanz IBM Cloud Logs fest.

  • type: Bestimmt die Art der Integration. Auf ibm_event_notifications eingestellt.

  • name: Geben Sie einen Namen für diese Ressourcendefinition ein.

  • IAM_TOKEN: Geben Sie den IAM_TOKEN ein. Sie können den folgenden Befehl ausführen, um das IAM-Token zu erhalten:

    export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
    
  • event_notifications_instance_id: Wird auf die Event Notifications Instanz-ID gesetzt.

  • region_id: Legen Sie die Region fest, in der die Instanz Event Notifications verfügbar ist.

  • endpoint_type: Legen Sie fest, ob die Integration über das öffentliche oder das private Netz erfolgt. Gültige Werte sind: default_or_public,oder private

Schritt 2. Konfigurieren einer ausgehenden Integration in der Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine ausgehende Integration zu konfigurieren:

  1. Klicken Sie in der Konsole auf das Navigationsmenü-Symbol Navigationsmenü-Symbol > Ressourcenliste.
  2. Wählen Sie Ihre Instanz von IBM Cloud Logs aus.
  3. Klicken Sie in der Navigation IBM Cloud Logs auf das Integrationssymbol Integrationssymbol > Ausgehende Integrationen.
  4. Suchen Sie im Abschnitt ausgehende Integrationen nach Event Notifications und klicken Sie auf Hinzufügen.
  5. Klicken Sie auf der Seite Integrationen auf Neu hinzufügen.
  6. Wenn eine IAM-Berechtigung zwischen IBM Cloud Logs und Event Notifications in Ihrem Konto nicht vorhanden ist, müssen Sie eine konfigurieren, indem Sie auf IAM-Berechtigungen klicken. Befolgen Sie die Eingabeaufforderungen, um den Zugriff zwischen den Services zu erteilen. Weitere Informationen finden Sie unter Erstellen einer S2S für die Arbeit mit dem IBM Cloud Event Notifications Service.
  7. Geben Sie einen Namen für die Integration ein.
  8. Wählen Sie die Event Notifications Service-Instanz, die Sie mit Ihrer IBM Cloud Logs Instanz verbinden wollen.
  9. Wählen Sie den Endpunkttyp als öffentlich oder privat. Weitere Informationen finden Sie unter Dienstendpunkte für Event Notifications
  10. Um die Verbindung zu bestätigen, klicken Sie auf Speichern.

Es wird eine IBM Cloud Event Notifications -Quelle mit dem folgenden Namen erstellt:

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

Zum Beispiel sieht der Quellenname in IBM Cloud Event Notifications wie folgt aus:

IBM Cloud Logs - rfdt3147-484f-4dee-b3c7-ab0c85a8e5c7

Der Name der Ausgangsintegration wird nicht zur Benennung der Quelle in der Instanz IBM Cloud Event Notifications verwendet.

Verbindung testen

Nachdem Sie die Benachrichtigungen für IBM Cloud Logs aktiviert haben, testen Sie Ihre Verbindung, um sicherzustellen, dass die Ereignisse, die von IBM Cloud Logs erzeugt werden, an Event Notifications weitergeleitet werden.

Führen Sie zunächst die folgenden Schritte in Event Notifications aus:

  1. Überprüfen Sie, ob die Quelle mit dem Namen IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>, der mit Ihrem Integrationsnamen übereinstimmt, in IBM Cloud Event Notifications erstellt wurde.

    1. Quellen auswählen.
    2. Suchen Sie nach der Quelle mit dem Namen IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>.
  2. Erstellen Sie ein Thema, das diese Cloud Logs-Instanz als Quelle angibt und den "Event type" auf "Test Event" beschränkt.

    1. Wählen Sie Topics aus. Klicken Sie anschließend auf Erstellen.
    2. Geben Sie einen Themennamen ein, z. B. CloudLogsInstance-test.
    3. Wählen Sie die Quelle IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> für die Instanz aus, deren Integration Sie testen möchten.
    4. Wählen Sie als Veranstaltungstyp "Testveranstaltung" aus.
    5. Wählen Sie "Bedingung hinzufügen" > "Quelle speichern ".
    6. Klicken Sie auf Erstellen.
  3. Erstellen Sie ein Ziel und überprüfen Sie, ob das Ziel konfiguriert ist. Sie können beispielsweise ein Slack-Ziel oder eine E-Mail konfigurieren.

  4. Erstellen Sie ein Abonnement, das das Thema und das Ziel miteinander verbindet.

    1. Geben Sie einen Namen ein, z. B. Test integration.
    2. Wählen Sie das Thema CloudLogsInstance-test.
    3. Wählen Sie ein Ziel aus.
    4. Klicken Sie auf Erstellen.

Führen Sie als Nächstes in IBM Cloud Logs die folgenden Schritte aus:

  1. Bearbeiten Sie die ausgehende Integration.
  2. Klicken Sie auf Testen.
  3. Überprüfen Sie Ihr ausgewähltes Ziel und vergewissern Sie sich, dass der Testlauf gesendet wurde.