监控亚马逊中的 Amazon One Enterprise 事件 EventBridge - Amazon One

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

监控亚马逊中的 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 活动
  1. 登录您的 AWS 控制台,网址为https://console.aws.amazon.com/events/

  2. 打开 EventBridge 控制台,网址为https://console.aws.amazon.com/events/

  3. 在导航窗格中的总线下,选择规则

  4. 选择创建规则

  5. 默认规则详细信息页面上,为规则指定名称。

  6. 选择 Rule with an event pattern(具有事件模式的规则),然后选择 Next(下一步)。

  7. 在 “生成事件模式” 页面的 “事件源” 下,确认已选择AWS 事件或 EventBridge 合作伙伴事件

  8. 示例事件类型下,选择 AWS 事件

  9. 对于创建方法,选择自定义图案

  10. 事件模式部分中,添加一个 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"] }

    您可以从上面的列表中选择所需的详细信息类型,然后删除不需要的内容。

  11. 选择下一步

  12. 选择目标页面上,选择您选择的目标,其中包括 Lambda 函数、SQS 队列或 SNS 主题。有关配置目标的信息,请参阅 Amazon EventBridge 目标

    例如,要查看某人何时进入时钟,请选择 “成功识别”。然后查看活动详情(见附录),看看谁在计时。

    要完成工作流程,您可以执行外部 API 或其他目标。

  13. 或者,您可以配置标签。

  14. 请在审核和创建页面,选择创建。有关配置规则的更多信息,请参阅 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" } } }