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でアウトバウンドインテグレーションを設定する
アウトバウンド・インテグレーションを設定するには、以下の手順を実行する:
- コンソールで、 ナビゲーション・メニュー・アイコン
> Resource list をクリックする。
- IBM Cloud Logs のインスタンスを選択します。
- IBM Cloud Logsナビゲーションで、統合アイコン
>アウトバウン統合をドクリックします。
- 送信統合セクションでEvent Notificationsて、追加をクリックします。
- Integrations ページで、 Add newをクリックします。
- IBM Cloud Logsと Event Notificationsの間のIAM権限がアカウントに存在しない場合は、IAM Authorizations をクリックして設定する必要があります。 プロンプトに従って、サービス間のアクセス権限を付与します。 詳細については、IBM Cloud Event Notificationsサービスと連携するためS2S認証の作成を/span>のを参照してください。
- 統合の名前を入力します。
- 自分のインスタンスに接続したいサービスEvent Notificationsインスタンスを選択IBM Cloud Logs。
- エンドポイントタイプをパブリックかプライベートかを選択する。 詳細については、Event Notificationsのサービス・エンドポイント を参照してください
- 接続を確認するには、 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で以下のステップを完了してください
-
ソース名が
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>で、お客様の統合名と一致するものが、 IBM Cloud Event Notifications内に作成されていることを確認してください。- 情報源を選ぶ
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>という名前のソースを探します。
-
このCloud Logsインスタンスをソースとして指定し、「イベントタイプ」を「テストイベント」に限定したトピックを作成します。
- トピックを選択します。 次に**「作成」**をクリックします。
- トピック名を入力します。例えば、
CloudLogsInstance-test。 - 統合テストを行いたいインスタンスのソース
IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>を選択します。 - イベントの種類として テストイベントを選択します。
- 条件を追加 > ソースを保存を選択します。
- 「作成」 をクリックします。
-
宛先を作成し、 宛先が設定されていることを確認します。 例えば、Slackの送信先やメールを設定することができます。
-
トピックと宛先をペアにしてサブスクリプションを作成します。
- 名前を入力します。例えば、
Test integration。 - トピックを選択
CloudLogsInstance-test. - 宛先を選択してください。
- 「作成」 をクリックします。
- 名前を入力します。例えば、
次に、 IBM Cloud Logs で、以下の手順を完了します
- アウトバウンド統合を編集します。
- **「テスト (Test)」**をクリックします。
- 選択した宛先を確認し、テストイベントが送信されたことを確認してください。