Event Notifications とは何ですか?

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

Event Notifications
Event Notifications

フィーチャー

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

1つのダッシュボードから、 IBM Cloud Compliance Manager、 IBM Cloud Secrets Manager、または IBM Cloud Monitoring からのイベント通知を、関連する関係者に転送することができます。 また、アラートを深刻度で絞り込み、最も適切な連絡手段を選択することもできます。例えば、緊急度の高いアラートにはSMSやプッシュ通知を、緊急度の低いアラートにはメールを選択するなどです。

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

着信イベントを 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 の概念 (フィルター、条件、トピックなど) について学習します。

Event

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

イベント通知

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

イベント・ソース

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

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

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

フィルター

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

条件

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

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

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

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

トピック

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

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

宛先

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

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

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

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

サービス間

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

サービスから人間

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

サブスクリプション

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

サブスクライバー

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

1つのサブスクリプションに設定できる宛先は1つだけですが、その宛先内には複数のサブスクライバーを設定することができます。

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

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

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

発信元の電話番号またはテキスト・メッセージの起点 ID と、E メールの発信元ドメインまたは IP アドレス。ほとんどの国では、送信者は法律により、デジタルメッセージの出所について透明性を確保する義務を負っています。 購読先の宛先として「 IBM 」SMSサービスまたは「 IBM 」メールサービスを選択した場合、ユーザーが受信するテキストメッセージの送信元は、 IBM が所有するものです。

SMS メッセージ

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

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

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

SMS 単位

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

Event Notifications 関係モデル

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

Event Notifications flow flow 関係モデル
Event Notifications

イベントは、 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 オンライン・エバリュエーターを参照してください。