本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 监控亚马逊中的 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 控制台中启用。尽管事件不是有序的，但它们有时间戳，允许您使用数据。[尽最大努力](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)发出事件。
**订阅 Amazon One Enterprise 活动**
1. 登录您的 AWS 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。
1. 打开 EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。
1. 在导航窗格中的**总线**下，选择**规则**。
1. 选择 **Create rule**（创建规则）。
1. 在**默认规则详细信息**页面上，为规则指定名称。
1. 选择 **Rule with an event pattern**（具有事件模式的规则），然后选择 **Next**（下一步）。
1. 在 “**生成事件模式**” 页面的 “**事件源**” 下，确认已选择**AWS 事件或 EventBridge 合作伙伴事件**。
1. 在**示例事件类型**下，选择 **AWS 事件**。
1. 对于**创建方法**，选择**自定义图案**。
1. 在**事件模式**部分中，添加一个 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"]
}
```
您可以从上面的列表中选择所需的详细信息类型，然后删除不需要的内容。
1. 选择**下一步**。
1. 在**选择目标**页面上，选择您选择的目标，其中包括 Lambda 函数、SQS 队列或 SNS 主题。有关配置目标的信息，请参阅 [Amazon EventBridge 目标](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。
例如，要查看某人何时进入时钟，请选择 **“成功识别**”。然后查看活动详情（见附录），看看谁在计时。
要完成工作流程，您可以执行外部 API 或其他目标。
1. 或者，您可以配置标签。
1. 请在**审核和创建**页面，选择**创建**。有关配置规则的更多信息，请参阅[ EventBridge《 EventBridge 用户指南》中的规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
## 设备状态更改事件类型
设备状态更改事件以 JSON 格式生成。对于每种事件类型，都会按照规则中的配置向您选择的目标发送一个 JSON blob。以下详细信息类型可用：
**已清除部分警报**
设备通过了一项或多项运行状况检查。
**检测到新警报**
设备未通过一项或多项运行状况检查。
**Topics**
**资源**
包含已发布设备状态更改事件的 DeviceInstance arn 列表。
**数据**
已清除警报
+ 表示设备实例之前失败的运行状况检查。
+ 由警报类型的状态代码和 reportedAt 时间戳组成。
+ 可能的状态码值：， NetworkDisconnected USBDisconnected
当前警报
+ 表示设备实例的当前状态。
+ 由警报类型的状态代码和 reportedAt 时间戳组成。
+ 可能的状态码值：， NetworkDisconnected USBDisconnected
NewAlerts
+ 表示最近未通过的 deviceInstance 运行状况检查。
+ 由警报类型的状态代码和 reportedAt 时间戳组成。
+ 可能的状态码值：， NetworkDisconnected USBDisconnected
currentAlertsCount
+ 设备实例当前失败的运行状况检查计数。
assetTagId
+ 与设备实例关联的设备的。 assetTagId
deviceInstanceName
+ 发布设备状态事件的设备实例的名称。
siteName
+ 设备实例所在站点的名称。
SiteArn
+ 设备实例所在网站的 Arn。
## 用户个人资料事件类型
与用户个人资料相关的事件详细信息类型有：
**新成功注册**
当用户成功注册时。
**新成功取消注册**
当用户成功取消注册时。
**注册失败**
当用户注册失败时。
**取消注册失败**
当用户无法取消注册时。
**成功认可**
当用户成功扫描 palm 进行身份验证时。
**识别失败**
当手掌扫描识别失败时。
**Topics**
**资源**
包含发布用户个人资料事件的用户个人资料 arn 列表。
**数据**
accountId
+ 发起请求的设备的相关 AWS 账户。
请求来源
+ 这是发起请求 deviceInstanceId 的设备。
已创建时间戳
+ 事件的创建时间。
用户状态
+ 用户的当前状态。
+ 可能的值：“活动”、“已删除”
关联的 ID
+ 用户的关联 ID，例如徽章 ID。
reason
+ 对于不成功的事件，将显示此值。它包含事件失败的原因。
## 示例事件
以下示例显示了 Amazon One Enterprise 的事件。
**Topics**
+ [订阅 Amazon One 企业版活动](#subscribe-device-status-events)
+ [设备状态更改事件类型](#device-status-change-event-types)
+ [用户个人资料事件类型](#user-profile-event-types)
+ [示例事件](#sample-event)
+ [设备运行状况更改为健康](#device-health-to-healthy)
+ [设备运行状况更改为严重](#device-health-to-critical)
+ [设备连接已更改为在线](#device-connectivity-to-online)
+ [设备连接已更改为离线](#device-connectivity-to-offline)
## 设备运行状况更改为健康
设备通过了所有运行状况检查。
```
{
"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"
}
}
}
```