でイベントの宛先へのルーティングを設定するIBM Cloud Event Notifications

IBM Cloud Event Notificationsへの通知をIBM Cloud Logsから有効にし、IBM Cloud Logsでアラートを構成したら、Event Notificationsでトピックとサブスクリプションを作成して、構成したサブスクリプションに基づいてアラートを宛先に転送できるようにします。

次の図は、アラートに必要なコンポーネントの関係を示している： ![アラートに必要なコンポーネントの関係](../images/event-notification-resources.svg "アラートに必要なコンポーネントの関係*" caption-side="bottom"}に必要なコンポーネントの"){: caption="アラートに必要なコンポーネントの関係アラートに必要なコンポーネントの関係

IBM Cloud Event Notificationsインスタンスを構成して、IBM Cloud Logsでアラートがトリガーされたときにイベント通知をターゲット宛先にルーティングするには、以下の手順を実行する必要があります：

前提条件

1つ以上のトピックを定義する

トピックは、パブリッシュ・モデルとサブスクリプション・モデルに基づいています。 トピックは、設定した条件に基づいてイベントデータをサブスクライブします。 Event Notificationsサービスは、設定したサブスクリプションに基づいて、アラートのルーティングと正しい宛先への配信を確実に処理します。

  • 各トピックは、登録されたソースの下に作成されます。
  • 各トピックは、独自のルール・セットを保持できます。このルール・セットによって、着信ペイロードがそれぞれのトピックにルーティングされます。

トピックを構成するときは、イベントがサブスクリプション基準に適合するかどうかを確認するためにトピッ クが監視する条件を定義します。 例えば、IBM Cloud Logsインスタンスに複数のアラート定義があり、それが同じスラックチャンネルを通して通知される場合、同じトピック内でこれらのアラートを構成することができます。

また、複数のIBM Cloud Logsアラート定義があり、異なるスラックチャンネルに通知する場合は、スラックチャンネルごとに1つのトピックを設定する必要があります。 そして、各トピックの設定に、関連するslackチャンネルに通知するアラートを含める必要がある。

トピックを作成するには、以下の手順に従ってください：

  1. コンソールで、ナビゲーションメニューアイコン Navigation Menu icon > Resource list >Developer Tools をクリックします。

  2. IBM Cloud Event Notifications のインスタンスを選択します。

  3. IBM Cloud Event Notificationsナビゲーションで、「トピックス」を選択してください。

  4. 「作成」 をクリックします。

  5. トピックの名前と説明を入力してください。

  6. ソースを選択します。

    ソースとは、Event Notificationsインスタンスで送信統合を構成するときに、IBM Cloud Logsインスタンスで自動的に構成されるリソースです。

  7. トピックにルールを追加して、アラートによって生成されるイベントをトピックの範囲に定義します。

    以下のオプションのいずれかを選択して、トピックがサブスクライブするイベント データを フィルタリングするルールを構成します：

    • オプション1：イベントタイプ、イベントサブタイプ、またはイベントの重大度を設定します。

      イベントの種類を選ぶことができます。 サポートされているタイプのリストは、[Event types/docs/cloud-logs]?topic=cloud-logs-cl-events-for-en#cl-events-for-en-typesを参照のこと）。

      イベントのサブタイプを選択できる。 サポートされているサブタイプのリストは、イベント・サブタイプ を参照のこと。

      重大度の値を選ぶことができる。 サポートされている深刻度のリストは、イベントの深刻度 を参照してください。

    • オプション2：JSONpath仕様に従わなければならない高度な条件を定義することができます。 正しく記述されたルールは、入力されたリクエストペイロードから適切なデータを抽出します。Event Notificationsは、JSONPath評価の == 演算子をサポートしています。

    • オプション3：イベント・タイプ、イベント・サブタイプまたはイベントの重大度、および詳細条件を構成する。

    ルールを選択しない場合は、デフォルトのルールが追加されます。これは、すべての通知がデフォルトでトピックにルーティングされることを意味します。 トピックがすべてのイベントデータをサブスクライブしないように、ルールを構成する必要がある。 このルールがない場合、サブスクライバは、インスタンスによって生成されたすべてのアラートのアラートと関連するデータを受信できます。

  8. 「作成」 をクリックします。

1つ以上の目的地を定義する

宛先は、アラートがトリガーされたときに通知するために使用できる通知チャネルを定義します。

宛先は、サービスまたはユーザー到達可能エンティティーのいずれかであるカスタム・プロトコルです。 サポートされる目的地の詳細については、サポートされる目的 地を参照してください。

宛先の作成方法については、IBM Cloud Event Notifications宛先を作成する を参照してください。

1つ以上のサブスクリプションを定義する

サブスクリプションは、1つのトピックと1つの宛先をリンクします。

サブスクリプションを追加して、トピックで構成されたイベントを宛先にルーティングするイベントを定義する必要があります。

サブスクリプションの作成方法については、IBM Cloud Event Notificationsサブスクリプションを作成する を参照してください。