IBM Cloud Docs
Event Notifications とは何ですか?

Event Notifications とは何ですか?

IBM Cloud® Event Notificationsは、IBM Cloudアカウントで発生した重要なイベントに関する情報を提供したり、Webhookを使用して自動化されたアクションをトリガーするルーティングサービスです。 モニタリングなどのIBM Cloudサービスからのイベント通知をフィルタリングして、電子メール、SMS、Webhookなどの通信チャネルにルーティングできます。

Event Notifications
Event Notifications

フィーチャー

集中アラート・ルーティング

単一のダッシュボードから、IBM Cloud Security and Compliance Center IBM Cloud Secrets ManagerまたはIBM Cloud Monitoringからのイベント通知を関連する利害関係者にルーティングできます。 また、重要度によってアラートをフィルタリングし、緊急の優先度の高いアラートにはSMSやプッシュ、優先度の低いアラートにはEメールなど、最適な通信チャネルを選択することもできます。

フィルタリングされたソース・イベント

着信イベントを 1 つ以上のトピックにフィルタリングします。 フィルターを使用してトピック・コンテンツを微調整し、必要なイベント・セットを調整します。 複数のトピックを 1 つのソースに接続したり、複数のソースを単一のトピックに接続したりします。

組み込み通信プロバイダー

Event Notificationsは、基本的な電子メールとSMSの機能がサービスに組み込まれています。 IBM Cloud E メールまたは IBM Cloud SMS の宛先を、即時接続のための任意の Event Notifications サブスクリプションに追加します。 さらにいくつかのステップを実行することで、プッシュ通知宛先をソース・リストに追加し、その宛先にサブスクライブすることもできます。

Webhook

イベント通知をいずれかの Webhook 宛先に送信します。 Webhook を使用して、アウトバウンド通知を管理ツールやコラボレーション・ツール、または独自のアプリケーションに統合します。

ファンアウト

数回のクリックだけで、単一のイベント通知を多くの宛先にルーティングします。 個人、アプリケーション、および自動化スイートのすべてに、一度で通知を送信します。

ガバナンス

Event Notificationsユーザと通知のアクティビティは、IBM Cloud Activity Trackerと IBM Cloud Logsを通して追跡できるので、いつ何が起こったかを知ることができます。

コンセプト

IBM Cloud® Event Notifications の概念 (フィルター、条件、トピックなど) について学習します。

イベント

IBM Cloud プラットフォーム、またはそのプラットフォーム上で実行されるサービスおよびアプリに関連する、何らかの関係のある事象の発生。

イベント通知

イベントの発生時にトリガーされるデジタル化されたメッセージ。イベント通知は、イベント・ソースから Event Notifications サービスに着信します。 Event Notifications サービスのコンテキストでは、「イベント通知」は「イベント」または「通知」に短縮して呼ばれることがあります。

イベント・ソース

イベント通知を送信し、それを IBM Cloud サービス内のトピックにパブリッシュする Event Notifications 上のサービスまたはアプリケーション。ソースは、Event Notifications サービス・インスタンス内の登録済みエンティティーです。 IBM Cloudのいくつかのサービスは、Event Notificationsに通知を送るように統合されるように設定されています。

IBM Cloud Monitoring, IBM Cloud Security and Compliance Center, IBM Cloud Secrets Manager Platform Notifications for IBM Cloud, IBM Cloud Resource Lifecycle Events, IBM Cloud Projects, and Toolchain are enabled.1 つのソースは複数のトピックにパブリッシュできます。 その他のコンテキストでは、ソースはプロデューサーまたはパブリッシャーとして識別されます。

送信通知リクエストのサイズ制限は64KBまでです。

フィルター

ソースからトピックにイベント通知を選択的に渡すためのメカニズム。トピックには、そのトピックに接続されているソースごとに独立したフィルターがあります。

条件

フィルタリングには多くの条件のうちの1つを使用することができます。属性が条件に一致するEvent Notificationsは、トピックに渡されます。属性が条件と一致しない通知は除去されます。

取り込まれたイベント通知

  • フィルターで評価されるイベント通知。 取り込まれたイベントは、1 次請求メトリックです。 取り込まれたイベントの料金は、すべてのソースで同一です。 ソースに対してフィルターが定義されていない場合、そのソースからのイベントはいずれも取り込まれません。

  • ソースに対してフィルターが定義されているが、イベント通知が渡されない場合、バウンスされた通知の数は、フィルターによって分析されたため、「取り込まれた」と見なされます。

トピック

  • フィルター処理されたイベントが到着する場所。トピックは、対象となる一連の着信イベント通知を保持します。 各ソースは、ユーザー定義のフィルターを介してトピックに接続されます。 トピックに渡される通知は、サブスクライブされたすべての宛先にプッシュされます。 1 つのトピックは、複数のソースに接続できます。

  • トピックに到着したイベント通知は、宛先に送信されます。1 つのトピックを、複数のソースに接続できます。 トピックはフィルタを使うことで生来ソースと結合しているが、目的地とは生来結合していない。 この結合は、サブスクリプションを介して行われます。

宛先

Event Notificationsの配信先。その他のコンテキストでは、宛先はチャネル、シンク、コンシューマー、またはサブスクライバーとも呼ばれます。

  • ヒューマン宛先: デバイス、サーバー、またはアプリケーションは、人間による使用のための通知を提示します。 ヒューマン宛先の例として、E メール・サーバー、SMS テキスト・プロバイダー、プッシュ通知サービスなどがあります。

    特定の E メール・アドレス、電話番号、およびデバイス ID は、宛先へのサブスクリプションの一部にすることができますが、宛先自体の一部にはなりません。

  • サービス宛先: 通知がプログラマチックにコンシュームされるクラウド・サービスまたはアプリケーション。 サービス宛先の例として、バックエンド・マイクロサービスへの Webhook があります。

サービス間

クラウド・サービスからサービス宛先に送信される通知を説明する用語。 その他のコンテキストでは、サービス間もアプリケーション間として分類されます。

サービスから人間

クラウド・サービスからヒューマン宛先に送信される通知を説明する用語。その他のコンテキストでは、サービスから人間 も アプリケーションから人間 として分類されます。

サブスクリプション

1 つのトピックの 1 つの宛先への関連付け。宛先が正しく動作するために追加情報 (例えば、E メール宛先の E メール・アドレス) を必要とする場合、その情報はサブスクリプションに含まれます。

サブスクライバー

サブスクリプションのターゲットとなる項目。Webhook の場合、サブスクライバーは Webhook ホストです。 ヒューマン宛先の場合は、E メール・アドレスおよび電話番号 (またはそれらを所有する人) がサブスクライバーです。

一つのサブスクリプションは一つのデスティネーションしか持つことができないが、そのデスティネーション内に多くのサブスクライバーを持つことができる。

アウトバウンド・デジタル・メッセージ

Event Notificationsサービスからサブスクライバに送信されるイベント通知。アウトバウンド・デジタル・メッセージは、Event Notifications サービスの基本請求メトリックです。アウトバウンド・デジタル・メッセージの料金は宛先によって異なります (例えば、SMS へのアウトバウンド・デジタル・メッセージの料金は、E メールへのアウトバウンド・デジタル・メッセージの料金とは異なります)。 ほとんどの場合、配信が正常に行われたかどうかに関係なく、ディスパッチ (配信の試行) はアウトバウンド・デジタル・メッセージと見なされます。

デジタル・メッセージの起点

発信元の電話番号またはテキスト・メッセージの起点 ID と、E メールの発信元ドメインまたは IP アドレス。ほとんどの国では、送信者はデジタル・メッセージの出所について透明性を保つことが法律で義務付けられている。 IBMSMS Service またはIBMEmail Service をサブスクリプションの宛先として選択した場合、ユーザーが受信するテキスト・メッセージは、IBM が所有するオリジンを持ちます。

SMS メッセージ

Simple Messaging Service 形式のテキスト・メッセージ。

SMS メッセージ・セグメント

SMS テキスト・メッセージ内の 160 文字からなる 1 つのグループ。 1 つのメッセージは複数のセグメントを含めることができます。 各メッセージ・セグメントは、請求処理では 1 つのアウトバウンド・デジタル・メッセージとしてカウントされます。

SMS 単位

SMS テキスト・メッセージの価格設定単位。

Event Notifications 関係モデル

Event Notifications には、ソース、フィルター、トピック、宛先、およびサブスクリプションが含まれます。 これらの要素間の関係を図 1 に示されています。

Event Notifications flow
Figure 1. Event Notifications relationship model

イベントはEvent Notificationsの外部、例えばIBM Cloudサービスから発生する。 Event Notifications 内の「イベント・ソース」は、Event Notifications とこれらのイベント生成サービスの 1 つとの間の接続を表します。

トピックには、パブリッシュするソース・イベントを決定するフィルターが関連付けられています。 トピックは、それぞれ独自のフィルターを持つ複数のソースを持つことができます。 トピックは、関心のあるイベントをさまざまなソースから分離し、それらを 1 つのエンティティーに集約します。

サブスクリプションによって、トピックを宛先に結合します。 単一のトピックまたは宛先を複数のサブスクリプションに関連付けることができますが、サブスクリプションは 1 対 1 になります。これは、1 つのトピックを 1 つの宛先に結び付けることを意味します。 サービス・ツー・ヒューマン・チャネルの場合、1 つのサブスクリプションに複数の受信者を含めることができます。 例えば、E メール宛先へのサブスクリプションは、1 つの E メール・アドレスのみに制限されるのではなく、多数のアドレスを保持する可能性がある受信者リストを持ちます。

イベント通知フロー

登録されたソースでイベントが発生すると、ソースにより、Event Notifications サービスに対してイベント通知が送信されます。 ソースで定義されているフィルターまたは条件に基づいて、この着信通知は 1 つ以上のトピックをターゲットとします。 通知は、ターゲット・トピックにサブスクライブされているすべての宛先に送信されます。

イベント通知フォーマット

Event Notificationsサービスに送られる通知は、CNCF CloudEvents フォーマットに準拠する必要があります。

フィルターの詳細

フィルターは条件ステートメントであり、ソースをトピックに接続します。 フィルターは、関係する通知を特定のトピックに経路指定するために作成されます。 フィルターを通過してトピックに渡される通知すべては、その後、トピック・サブスクライバーに経路指定されます。 トピックと宛先の間にはフィルタリングはありません。

フィルタリングを簡略化するため、ソースでは通知にイベント・カテゴリーを含めることができます。 イベント・カテゴリーは、イベント・カテゴリー-> イベント・タイプ-> 重大度の階層を持つ標準フィルター・キーです。 イベント・カテゴリーによって、ユーザーがトピックおよびフィルターを Event Notifications UI で作成するときにドロップダウン選択ボックスが表示されるので、フィルタリングが容易になります。 より高度なフィルタリングを行うには、Custom Filterフィールドで JSONPath を使用します。 JSONPath について詳しくは、JSONPath オンライン・エバリュエーターを参照してください。