IBM Cloud Logsと IBM Cloud Event Notificationsを接続するアウトバウンド統合の設定

IBM Cloud Logs インスタンスでアラートがトリガーされたときに生成されるイベントを送信するには、アウトバウンド・インテグレーションを構成して IBM Cloud Logs インスタンスを Event Notifications に接続する必要があります。

前提条件

  • アラートについてはIBM Cloud Logsを参照してください。 詳細については、アラート を参照してください。
  • IBM Cloud Event Notifications について学習する。 詳しくは IBM Cloud Event Notifications とはをご覧ください。
  • IBM Cloud Logs の通知を有効にする前に、 Event Notifications インスタンスと、 Event Notifications インスタンスでリソースを構成する権限があることを確認してください。

ステップ 1. サービス間の認可を定義する

IBM Cloudアカウントでは、IBM Cloud LogsサービスがEvent Notificationsサービスにイベントを送信することを認可するために、サービス間認可が使用される。

IBM Cloud LogsインスタンスとEvent Notificationsインスタンス間で認可をサービスするサービスを構成する必要があります。 詳細については、IBM Cloud Event Notificationsサービスと連携するためS2S認証の作成を/span>のを参照してください。

ステップ 2 APIを使用したアウトバウンド統合の設定

APIを使用してアウトバウンドの統合を作成できます。 APIメソッドの詳細については、 Create an outbound integrationを参照してください。

API 経由で設定できるのは、異なるアカウントある IBM Cloud Logs インスタンスと Event Notifications インスタンス間の統合のみです。

例えば、以下の cURL コマンドを使って、API経由の統合を作成することができる:

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"
  }
 }'

説明

  • API-ENDPOINT: IBM Cloud Logs インスタンスの API エンドポイントを設定します。

  • type:統合のタイプを定義する。 ibm_event_notifications に設定する。

  • name:このリソース定義の名前を入力する。

  • IAM_TOKEN:IAM_TOKEN を入力します。 以下のコマンドを実行して、IAMトークンを取得することができる:

    export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
    
  • event_notifications_instance_id: Event Notifications インスタンスIDに設定。

  • region_id: Event Notifications インスタンスが利用可能な地域に設定します。

  • endpoint_type:統合がパブリック・ネットワーク経由かプライベート・ネットワーク経由かを定義する。 有効な値は default_or_public または private

ステップ 2 UIでアウトバウンドインテグレーションを設定する

アウトバウンド・インテグレーションを設定するには、以下の手順を実行する:

  1. コンソールで、 ナビゲーション・メニュー・アイコン Navigation Menu icon > Resource list をクリックする。
  2. IBM Cloud Logs のインスタンスを選択します。
  3. IBM Cloud Logsナビゲーションで、統合アイコン統合アイコン >アウトバウン統合をドクリックします。
  4. 送信統合セクションでEvent Notificationsて、追加をクリックします。
  5. Integrations ページで、 Add newをクリックします。
  6. IBM Cloud Logsと Event Notificationsの間のIAM権限がアカウントに存在しない場合は、IAM Authorizations をクリックして設定する必要があります。 プロンプトに従って、サービス間のアクセス権限を付与します。 詳細については、IBM Cloud Event Notificationsサービスと連携するためS2S認証の作成を/span>のを参照してください。
  7. 統合の名前を入力します。
  8. 自分のインスタンスに接続したいサービスEvent Notificationsインスタンスを選択IBM Cloud Logs。
  9. エンドポイントタイプをパブリックかプライベートかを選択する。 詳細については、Event Notificationsのサービス・エンドポイント を参照してください
  10. 接続を確認するには、 Saveをクリックします。

IBM Cloud Event Notifications site.data.keyword.en_full_notm}}ソースは次の名前で作成されます

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

例えば IBM Cloud Event Notificationsのソース名は次のようになります

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

アウトバウンド統合の名前は、 IBM Cloud Event Notifications インスタンスのソース名には使用されない。

接続のテスト

IBM Cloud Logs の通知を有効にした後、 IBM Cloud Logs で生成されたイベントが Event Notifications に転送されていることを確認するため、接続をテストします。

まず、 Event Notificationsで以下のステップを完了してください

  1. ソース名が IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> で、お客様の統合名と一致するものが、 IBM Cloud Event Notifications内に作成されていることを確認してください。

    1. 情報源を選ぶ
    2. IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> という名前のソースを探します。
  2. このCloud Logsインスタンスをソースとして指定し、「イベントタイプ」を「テストイベント」に限定したトピックを作成します。

    1. トピックを選択します。 次に**「作成」**をクリックします。
    2. トピック名を入力します。例えば、 CloudLogsInstance-test
    3. 統合テストを行いたいインスタンスのソース IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> を選択します。
    4. イベントの種類として テストイベントを選択します。
    5. 条件を追加 > ソースを保存を選択します。
    6. 「作成」 をクリックします。
  3. 宛先を作成し、 宛先が設定されていることを確認します。 例えば、Slackの送信先やメールを設定することができます。

  4. トピックと宛先をペアにしてサブスクリプションを作成します。

    1. 名前を入力します。例えば、 Test integration
    2. トピックを選択 CloudLogsInstance-test.
    3. 宛先を選択してください。
    4. 「作成」 をクリックします。

次に、 IBM Cloud Logs で、以下の手順を完了します

  1. アウトバウンド統合を編集します。
  2. **「テスト (Test)」**をクリックします。
  3. 選択した宛先を確認し、テストイベントが送信されたことを確認してください。