本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
监控亚马逊中的 Amazon One Enterprise 事件 EventBridge
您可以在中监控 Amazon One Enterprise 事件 EventBridge,它会提供来自您自己的应用程序、 software-as-a-service (SaaS) 应用程序和 AWS 服务的实时数据流。 EventBridge将该数据路由到目标,例如 AWS Lambda 和 Amazon 简单通知服务。这些事件提供了近乎实时的系统事件流,这些事件描述了 AWS 资源的变化。
订阅 Amazon One 企业版活动
Amazon One 设备和用户个人资料状态更改事件使用发布 EventBridge,也可以通过创建新规则在 EventBridge 控制台中启用。尽管事件不是有序的,但它们有时间戳,允许您使用数据。尽最大努力发出事件。
订阅 Amazon One Enterprise 活动
-
登录您的 AWS 控制台,网址为https://console.aws.amazon.com/events/
。 -
打开 EventBridge 控制台,网址为https://console.aws.amazon.com/events/
。 -
在导航窗格中的总线下,选择规则。
-
选择创建规则。
-
在默认规则详细信息页面上,为规则指定名称。
-
选择 Rule with an event pattern(具有事件模式的规则),然后选择 Next(下一步)。
-
在 “生成事件模式” 页面的 “事件源” 下,确认已选择AWS 事件或 EventBridge 合作伙伴事件。
-
在示例事件类型下,选择 AWS 事件。
-
对于创建方法,选择自定义图案。
-
在事件模式部分中,添加一个 JSON,事件源为
aws:one
和所需的详细信息类型:" source": ["aws.one"], "detail-type": ["New Successful Enrollment", "New Successful Un-enrollment", "Unsuccessful Enrollment", "Unsuccessful Un-enrollment", "Successful Recognition", "Unsuccessful Recognition", "New Alert(s) Detected", "Some Alert(s) Cleared"] }
您可以从上面的列表中选择所需的详细信息类型,然后删除不需要的内容。
选择下一步。
-
在选择目标页面上,选择您选择的目标,其中包括 Lambda 函数、SQS 队列或 SNS 主题。有关配置目标的信息,请参阅 Amazon EventBridge 目标。
例如,要查看某人何时进入时钟,请选择 “成功识别”。然后查看活动详情(见附录),看看谁在计时。
要完成工作流程,您可以执行外部 API 或其他目标。
-
或者,您可以配置标签。
-
请在审核和创建页面,选择创建。有关配置规则的更多信息,请参阅 EventBridge《 EventBridge 用户指南》中的规则。
设备状态更改事件类型
设备状态更改事件以 JSON 格式生成。对于每种事件类型,都会按照规则中的配置向您选择的目标发送一个 JSON blob。以下详细信息类型可用:
- 已清除部分警报
-
设备通过了一项或多项运行状况检查。
- 检测到新警报
-
设备未通过一项或多项运行状况检查。
事件对象
- resources
-
包含已发布设备状态更改事件的 DeviceInstance arn 列表。
- 数据
-
已清除警报
-
表示设备实例之前失败的运行状况检查。
-
由警报类型的状态代码和 reportedAt 时间戳组成。
-
可能的状态码值:, NetworkDisconnected USBDisconnected
当前警报
-
表示设备实例的当前状态。
-
由警报类型的状态代码和 reportedAt 时间戳组成。
-
可能的状态码值:, NetworkDisconnected USBDisconnected
NewAlerts
-
表示最近未通过的 deviceInstance 运行状况检查。
-
由警报类型的状态代码和 reportedAt 时间戳组成。
-
可能的状态码值:, NetworkDisconnected USBDisconnected
currentAlertsCount
-
设备实例当前失败的运行状况检查计数。
assetTagId
-
与设备实例关联的设备的。 assetTagId
deviceInstanceName
-
发布设备状态事件的设备实例的名称。
siteName
-
设备实例所在站点的名称。
SiteArn
-
设备实例所在网站的 Arn。
-
用户个人资料事件类型
与用户个人资料相关的事件详细信息类型有:
- 新成功注册
-
当用户成功注册时。
- 新成功取消注册
-
当用户成功取消注册时。
- 注册失败
-
当用户注册失败时。
- 取消注册失败
-
当用户无法取消注册时。
- 成功认可
-
当用户成功扫描 palm 进行身份验证时。
- 识别失败
-
当手掌扫描识别失败时。
事件对象
- resources
-
包含发布用户个人资料事件的用户个人资料 arn 列表。
- 数据
-
accountId
-
发起请求的设备的相关 AWS 账户。
请求来源
-
这是发起请求 deviceInstanceId 的设备。
已创建时间戳
-
事件的创建时间。
用户状态
-
用户的当前状态。
-
可能的值:“活动”、“已删除”
关联的 ID
-
用户的关联 ID,例如徽章 ID。
reason
-
对于不成功的事件,将显示此值。它包含事件失败的原因。
-
示例事件
以下示例显示了 Amazon One Enterprise 的事件。
设备运行状况更改为健康
设备通过了所有运行状况检查。
{ "version": "0", "id": "51e022b4-7ce6-34e0-264b-370948fc1123", "detail-type": "Some Alert(s) Cleared", "source": "aws.one", "account": "123456789012", "time": "2025-07-17T19:32:42Z", "region": "us-east-1", "resources": [ "arn:aws:one:us-east-1:123456789012:deviceInstance/F5JRte5Jz21Tqx" ], "detail": { "version": "1.0.0", "data": { "clearedAlerts": [ { "statusCode": "USBDisconnected", "reportedAt": "Thu Jul 17 19:32:42 UTC 2025" } ], "currentAlerts": [], "currentAlertsCount": 0, "assetTagId": "0000123456", "deviceInstanceName": "device_name", "siteName": "site_name", "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234" } } }
设备运行状况更改为严重
设备未通过一项或多项运行状况检查。
{ "version": "0", "id": "07af4893-ef9f-965a-d245-3f0c8bd3c123", "detail-type": "New Alert(s) Detected", "source": "aws.one", "account": "123456789012", "time": "2025-07-17T19:26:58Z", "region": "us-east-1", "resources": [ "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234" ], "detail": { "version": "1.0.0", "data": { "newAlerts": [ { "statusCode": "USBDisconnected", "reportedAt": "Thu Jul 17 19:26:58 UTC 2025" } ], "currentAlerts": [ { "statusCode": "USBDisconnected", "reportedAt": "Thu Jul 17 19:26:58 UTC 2025" } ], "currentAlertsCount": 1, "assetTagId": "0000123456", "deviceInstanceName": "device_name", "siteName": "site_name", "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234" } } }
设备连接已更改为在线
设备现已连接到互联网。
{ "version": "0", "id": "e6ecea28-dd60-5061-29f8-dfbc902f4123", "detail-type": "Some Alert(s) Cleared", "source": "aws.one", "account": "123456789012", "time": "2025-07-17T18:28:23Z", "region": "us-east-1", "resources": [ "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234" ], "detail": { "version": "1.0.0", "data": { "clearedAlerts": [ { "statusCode": "NetworkDisconnected", "reportedAt": "Thu Jul 17 18:28:23 UTC 2025" } ], "currentAlerts": [], "currentAlertsCount": 0, "assetTagId": "0000123456", "deviceInstanceName": "device_name", "siteName": "site_name", "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234" } } }
设备连接已更改为离线
设备不再连接到互联网。
{ "version": "0", "id": "e6ecea28-dd60-5061-29f8-dfbc902f4123", "detail-type": "New Alert(s) Detected", "source": "aws.one", "account": "123456789012", "time": "2025-07-17T18:28:23Z", "region": "us-east-1", "resources": [ "arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234" ], "detail": { "version": "1.0.0", "data": { "newAlerts": [ { "statusCode": "NetworkDisconnected", "reportedAt": "Thu Jul 17 18:28:23 UTC 2025" } ], "currentAlerts": [ { "statusCode": "NetworkDisconnected", "reportedAt": "Thu Jul 17 18:28:23 UTC 2025" } ], "currentAlertsCount": 1, "assetTagId": "0000123456", "deviceInstanceName": "device_name", "siteName": "site_name", "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234" } } }