기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon EventBridge에서 Amazon One Enterprise 이벤트 모니터링
자체 애플리케이션, software-as-a-service(SaaS) 애플리케이션 및 AWS 서비스의 실시간 데이터 스트림을 제공하는 EventBridge에서 Amazon One Enterprise 이벤트를 모니터링할 수 있습니다. EventBridge는 해당 데이터를 AWS Lambda 및 Amazon Simple Notification Service와 같은 대상으로 라우팅합니다. 이러한 이벤트는 AWS 리소스의 변경 사항을 설명하는 시스템 이벤트의 스트림을 거의 실시간으로 제공합니다.
## Amazon One Enterprise 이벤트 구독
Amazon One 디바이스 및 사용자 프로필 상태 변경 이벤트는 EventBridge를 사용하여 게시되며 새 규칙을 생성하여 EventBridge 콘솔에서 활성화할 수 있습니다. 이벤트는 순서가 정해져 있지는 않지만 데이터를 사용할 수 있는 타임스탬프가 있습니다. 이벤트는 [최상의 노력](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)에 따라 전송됩니다.
**Amazon One Enterprise 이벤트를 구독하려면**
1. [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) AWS 콘솔에 로그인합니다.
1. [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 EventBridge 콘솔을 엽니다.
1. 탐색 창의 **버스** 아래에서 **규칙**을 선택합니다.
1. **규칙 생성**을 선택합니다.
1. **기본 규칙 세부 정보** 페이지에서 규칙에 이름을 할당합니다.
1. **이벤트 패턴이 있는 규칙**을 선택한 후**다음**을 선택합니다.
1. **이벤트 패턴 작성** 페이지의 **이벤트 소스**에서 **AWS 이벤트 또는 EventBridge 파트너 이벤트**가 선택되어 있는지 확인합니다.
1. **샘플 이벤트 유형**에서 **AWS 이벤트를** 선택합니다.
1. **생성 방법**에서 **사용자 지정 패턴을** 선택합니다.
1. **이벤트 패턴** 섹션에서 이벤트 소스가 `aws:one` 및 필수 detail-type인 JSON을 추가합니다.
```
"
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. **대상 선택(Select target)** 페이지에서 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) 참조하세요. EventBridge
## 디바이스 상태 변경 이벤트 유형
디바이스 상태 변경 이벤트는 JSON으로 생성됩니다. 각 이벤트 유형에 대해 규칙에 구성된 대로 선택한 대상에 JSON 블롭이 전송됩니다. 다음 세부 정보 유형을 사용할 수 있습니다.
**일부 알림(들) 삭제됨**
디바이스가 하나 이상의 상태 확인을 통과했습니다.
**새 알림(들) 감지됨**
디바이스가 하나 이상의 상태 확인에 실패했습니다.
**Topics**
**리소스**
디바이스 상태 변경 이벤트가 게시된 deviceInstance arn 목록을 포함합니다.
**데이터**
clearedAlerts
+ deviceInstance가 이전에 실패한 상태 확인을 나타냅니다.
+ 알림 유형에 대한 statusCode와 reportedAt 타임스탬프로 구성됩니다.
+ 가능한 statusCode 값: NetworkDisconnected, USBDisconnected
currentAlerts
+ deviceInstance의 현재 상태를 나타냅니다.
+ 알림 유형에 대한 statusCode와 reportedAt 타임스탬프로 구성됩니다.
+ 가능한 statusCode 값: NetworkDisconnected, USBDisconnected
newAlerts
+ deviceInstance의 새로 실패한 상태 확인을 나타냅니다.
+ 알림 유형에 대한 statusCode와 reportedAt 타임스탬프로 구성됩니다.
+ 가능한 statusCode 값: NetworkDisconnected, USBDisconnected
currentAlertsCount
+ 현재 deviceInstance에서 실패한 상태 확인 수입니다.
assetTagId
+ deviceInstance와 연결된 디바이스의 assetTagId입니다.
deviceInstanceName
+ 디바이스 상태 이벤트가 게시된 deviceInstance의 이름입니다.
siteName
+ deviceInstance가 있는 사이트의 이름입니다.
siteArn
+ deviceInstance가 있는 사이트의 Arn입니다.
## 사용자 프로필 이벤트 유형
사용자 프로필 관련 이벤트 세부 정보 유형은 다음과 같습니다.
**새로운 등록 성공**
사용자가 성공적으로 등록한 경우.
**새로운 등록 취소 성공**
사용자가 성공적으로 등록을 취소한 경우.
**등록 실패**
사용자가 등록에 실패한 경우.
**등록 취소 실패**
사용자가 등록을 취소하지 못한 경우.
**성공적인 인식**
사용자가 인증을 위해 바람을 스캔하는 경우.
**인식 실패**
팔목 스캔 인식에 실패한 경우.
**Topics**
**리소스**
사용자 프로필 이벤트가 게시된 사용자 프로필 ARN 목록을 포함합니다.
**데이터**
accountId
+ 요청을 시작한 디바이스의 관련 AWS 계정입니다.
requestSource
+ 요청을 시작한 디바이스의 deviceInstanceId입니다.
createdTimestamp
+ 이벤트가 생성되는 시간입니다.
userStatus
+ 사용자의 현재 상태입니다.
+ 가능한 값: ACTIVE, DELETED
associatedId
+ 배지 ID와 같은 사용자의 연결된 ID입니다.
reason
+ 실패한 이벤트에 대해이 값이 표시됩니다. 여기에는 이벤트가 실패한 이유가 포함되어 있습니다.
## 샘플 이벤트
다음 예제에서는 Amazon One Enterprise에 대한 이벤트를 보여줍니다.
**Topics**
+ [Amazon One Enterprise 이벤트 구독](#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"
}
}
}
```