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的事件通知发送给相关利益方。 您还可以按严重程度过滤警报，并选择最合适的通信渠道，例如，短信或推送用于紧急优先警报，电子邮件用于次优先警报。

过滤的源事件

将传入事件过滤为一个或多个主题。 使用过滤器可微调主题内容以调整您需要的事件集。 将多个主题连接到一个源，或将多个源连接到单个主题。

内置通信提供程序

Event Notifications 随附内置到服务中的基本电子邮件和 SMS 功能。 将 IBM Cloud 电子邮件或 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服务实例中的注册实体。 Several services on IBM Cloud are set to be integrated to send notifications to 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.一个信息源可以发布多个主题。 在其他情况下，信息来源被确定为制作者或出版商。

发送通知请求的大小限制为 64 KB。

过滤

一种有选择地将事件通知从源传递到主题的机制。每个主题都有一个独立的过滤器，用于与之相连的每个源。

条件

可使用多种筛选条件之一。Event Notifications的属性如果符合条件，就会传递到主题。属性不符合条件的通知将被丢弃。

摄入事件通知

  • 由过滤器评估的事件通知。 摄入事件是主要的计费指标。 所有来源的摄入事件价格相同。 如果没有为源定义过滤器，则不会摄取该源的任何事件。

  • 如果为源代码定义了过滤器，但没有事件通知通过，则跳过的通知数量仍被视为“摄取”，因为它们已被过滤器分析过。

主题

  • 过滤事件的落脚点。主题存放一组关联的传入事件通知。 每个源都通过用户定义的过滤器连接到一个主题。 传递到主题的通知将推送给所有预订的目标。 一个主题可以连接到多个源。

  • 最终进入主题的事件通知会被路由到目的地。一个主题可以连接多个来源。 虽然通过使用筛选器，主题与来源有了天生的联系，但它们与目的地却没有天生的联系。 这种耦合是通过订阅实现的。

目标

Event Notifications的发送目标。在其他情况下，目的地也被称为通道、汇、消费者或用户。

  • 人类目的地：设备、服务器或应用程序为人类提供通知。 人类目的地的例子包括电子邮件服务器、SMS 文本提供商和推送通知服务。

    特定的电子邮件地址、电话号码和设备 ID 可以是目的地订阅的一部分，但它们不是目的地本身的一部分。

  • 服务目的地：以编程方式消费通知的云服务或应用程序。 指向后端微服务的 Webhook 就是服务目的地的一个例子。

服务对服务

描述从云服务发送到服务目的地的通知的一种方法。 在其他情况下，“服务对服务”也被归类为“应用对应用”。

服务于人

描述从云服务向人类目的地发送通知的一种方式。在其他情况下，“服务到人”也被归类为“应用到人”。

预订

一个主题与一个目的地的关联。如果目的地需要额外信息才能正常运行（例如，电子邮件目的地的电子邮件地址），则该信息将包含在订阅中。

订户

订阅所针对的实体。对于网络钩子，网络钩子主机就是订阅者。 对于人类目的地来说，电子邮件地址和电话号码（或拥有这些地址和电话号码的人）就是订阅者。

一个订阅只能有一个目的地，但该目的地内可以有多个订阅者。

外发数字信息

从Event Notifications服务向订阅者发送的事件通知。出站数字信息是Event Notifications服务的主要计费指标。出站数字信息的价格因目的地而异（例如，发送到 SMS 的出站数字信息与发送到电子邮件的出站数字信息的价格不同）。 在大多数情况下，无论发送是否成功，派送（尝试发送）都被视为外发数字报文。

数字信息来源

短信的发端电话号码或发端 ID，电子邮件的发端域名或 IP 地址。在大多数国家，法律规定发件人有义务对数字信息的来源保持透明。 如果您选择IBM短信服务或IBM电子邮件服务作为订阅的目的地，则用户收到的文本信息的来源归IBM 所有。

SMS 消息

简单信息服务格式的文本信息。

短信信息段

SMS 短信中的一组 160 个字符。 一个报文可以包含多个片段。 在计费时，每个信息段都算作一条外发数字信息。

短信单元

SMS 短信的定价单位。

Event Notifications关系模型

Event Notifications包括来源、筛选器、主题、目的地和订阅。 这些要素之间的关系如图 1 所示。

Event Notifications flow
Figure 1. Event Notifications relationship model

事件源自Event Notifications 以外，例如来自IBM Cloud服务。 Event Notifications中的“事件源”表示Event Notifications与这些事件生成服务之一之间的连接。

主题具有相关的筛选器，可决定发布哪些源事件。 主题可以有多个来源，每个来源都有自己的过滤器。 主题从各种来源中分离出感兴趣的事件，并将其汇总为一个实体。

订阅将主题与目的地绑定。 虽然单个主题或目的地可以与多个订阅相关联，但订阅是一对一的，这意味着它将一个主题与一个目的地联系在一起。 对于“服务对人”渠道，一个订阅可以包含多个收件人。 例如，订阅电子邮件目的地并不只限于一个电子邮件地址，而是有一个可能包含许多地址的收件人列表。

事件通知流程

注册源发生事件时，源会向Event Notifications服务发送事件通知。 根据在源上定义的筛选器或条件，传入的通知将针对一个或多个主题。 通知会发送到订阅了目标主题的所有目的地。

事件通知格式

发送至Event Notifications服务的通知必须符合 CNCF CloudEvents 格式。

有关过滤器的更多内容

筛选器是一个条件语句，它将信息源与主题连接起来。 编写过滤器的目的是将感兴趣的通知发送到特定主题。 所有通过过滤器进入主题的通知都会转发给主题订阅者。 在主题和目的地之间没有过滤功能。

为了简化过滤，信息源可能会在通知中包含事件类别。 事件类别是标准过滤键，其层次结构如下：事件类别 -> 事件类型 -> 严重程度。 事件类别简化了筛选过程，因为在Event Notifications中创建主题和筛选器时，它们会显示为下拉选择框。用户界面。 要进行更高级的过滤，请在 Custom Filter 字段中使用 JSONPath。 有关 JSONPath 的更多信息，请参阅 JSONPath 在线评估器。