기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 콘솔에서 활성화할 수 있습니다. 이벤트는 순서가 정해져 있지는 않지만 데이터를 사용할 수 있는 타임스탬프가 있습니다. 이벤트는 최상의 노력에 따라 전송됩니다.
Amazon One Enterprise 이벤트를 구독하려면
-
https://console.aws.amazon.com/events/
AWS 콘솔에 로그인합니다. -
https://console.aws.amazon.com/events/
에서 EventBridge 콘솔을 엽니다. -
탐색 창의 버스 아래에서 규칙을 선택합니다.
-
규칙 생성을 선택합니다.
-
기본 규칙 세부 정보 페이지에서 규칙에 이름을 할당합니다.
-
이벤트 패턴이 있는 규칙을 선택한 후다음을 선택합니다.
-
이벤트 패턴 작성 페이지의 이벤트 소스에서 AWS 이벤트 또는 EventBridge 파트너 이벤트가 선택되어 있는지 확인합니다.
-
샘플 이벤트 유형에서 AWS 이벤트를 선택합니다.
-
생성 방법에서 사용자 지정 패턴을 선택합니다.
-
이벤트 패턴 섹션에서 이벤트 소스가
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"] }위 목록에서 필수 세부 정보 유형을 선택하고 필요하지 않은 항목을 제거할 수 있습니다.
다음을 선택합니다.
-
대상 선택(Select target) 페이지에서 Lambda 함수, SQS 대기열 또는 SNS 주제가 포함된 원하는 대상을 선택합니다. 대상 구성에 대한 자세한 내용은 Amazon EventBridge 대상을 참조하세요.
예를 들어, 누군가가 클럭인하는 시점을 보려면 “성공 인식”을 선택합니다. 그런 다음 이벤트 세부 정보(부록에 나와 있음)를 보고 누가 클럭인했는지 확인합니다.
워크플로를 완료하려면 외부 API 또는 다른 대상을 실행할 수 있습니다.
-
선택적으로 태그를 구성할 수 있습니다.
-
검토 및 생성 페이지에서 규칙 생성을 선택합니다. 규칙 구성에 대한 자세한 내용은 EventBridge 사용 설명서의 EventBridge 규칙을 참조하세요. EventBridge
디바이스 상태 변경 이벤트 유형
디바이스 상태 변경 이벤트는 JSON으로 생성됩니다. 각 이벤트 유형에 대해 규칙에 구성된 대로 선택한 대상에 JSON 블롭이 전송됩니다. 다음 세부 정보 유형을 사용할 수 있습니다.
- 일부 알림(들) 삭제됨
-
디바이스가 하나 이상의 상태 확인을 통과했습니다.
- 새 알림(들) 감지됨
-
디바이스가 하나 이상의 상태 확인에 실패했습니다.
이벤트 객체
- 리소스
-
디바이스 상태 변경 이벤트가 게시된 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입니다.
-
사용자 프로필 이벤트 유형
사용자 프로필 관련 이벤트 세부 정보 유형은 다음과 같습니다.
- 새로운 등록 성공
-
사용자가 성공적으로 등록한 경우.
- 새로운 등록 취소 성공
-
사용자가 성공적으로 등록을 취소한 경우.
- 등록 실패
-
사용자가 등록에 실패한 경우.
- 등록 취소 실패
-
사용자가 등록을 취소하지 못한 경우.
- 성공적인 인식
-
사용자가 인증을 위해 바람을 스캔하는 경우.
- 인식 실패
-
팔목 스캔 인식에 실패한 경우.
이벤트 객체
- 리소스
-
사용자 프로필 이벤트가 게시된 사용자 프로필 ARN 목록을 포함합니다.
- 데이터
-
accountId
-
요청을 시작한 디바이스의 관련 AWS 계정입니다.
requestSource
-
요청을 시작한 디바이스의 deviceInstanceId입니다.
createdTimestamp
-
이벤트가 생성되는 시간입니다.
userStatus
-
사용자의 현재 상태입니다.
-
가능한 값: ACTIVE, DELETED
associatedId
-
배지 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" } } }