

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon EventBridge를 사용하여 HealthLake 이벤트 모니터링
<a name="monitoring-eventbridge"></a>

Amazon EventBridge는 이벤트를 사용하여 애플리케이션 구성 요소를 서로 연결하는 서버리스 서비스로, 확장 가능한 이벤트 기반 애플리케이션을 더 쉽게 구축할 수 있습니다. EventBridge의 기본은 [이벤트를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) [대상으로](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) 라우팅하는 [규칙을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) 생성하는 것입니다. AWS HealthLake 는 상태 변경을 EventBridge로 지속적으로 전달합니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) 섹션을 참조하세요.

**참고**  
HealthLake 이벤트를 Amazon EventBridge로 보내는 방법을 알아보려면 *AWS for Industry* 블로그의 [용 Amazon EventBridge 통합 AWS HealthLake](https://aws.amazon.com/blogs/industries/amazon-eventbridge-integration-for-aws-healthlake)을 참조하세요.

**Topics**
+ [EventBridge로 전송된 HealthLake 이벤트](#event-notifications-listing)
+ [HealthLake 이벤트 구조](#event-notifications-structure)

## EventBridge로 전송된 HealthLake 이벤트
<a name="event-notifications-listing"></a>

다음 표에는 처리를 위해 EventBridge로 전송된 모든 HealthLake 이벤트가 나열되어 있습니다.

<a name="event-notifications-table"></a>
<table>
<thead>
  <tr><th>HealthLake 이벤트 유형</th><th>State</th></tr>
</thead>
<tbody>
  <tr><td colspan="2"> 데이터 스토어 이벤트 </td></tr>
  <tr><td>     데이터 스토어 생성</td><td>CREATING</td></tr>
  <tr><td>     데이터 스토어 활성</td><td>ACTIVE</td></tr>
  <tr><td>     데이터 스토어 삭제</td><td>DELETING</td></tr>
  <tr><td>     데이터 스토어 삭제됨</td><td>DELETED</td></tr>
  <tr><td>     데이터 스토어 생성 실패</td><td>CREATE\_FAILED</td></tr>
  <tr><td colspan="2">자세한 내용을 알아보려면 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DatastoreProperties.html#HealthLake-Type-DatastoreProperties-DatastoreStatus](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_DatastoreProperties.html#HealthLake-Type-DatastoreProperties-DatastoreStatus) 섹션을 참조하세요.</td></tr>
  <tr><td colspan="2"> 작업 이벤트 가져오기 </td></tr>
  <tr><td>     가져오기 작업 제출됨</td><td>SUBMITTED</td></tr>
  <tr><td>     가져오기 작업 진행 중</td><td>IN\_PROGRESS</td></tr>
  <tr><td>     오류로 완료된 가져오기 작업</td><td>COMPLETED\_WITH\_ERRORS</td></tr>
  <tr><td>     가져오기 작업 완료</td><td>COMPLETED</td></tr>
  <tr><td>     가져오기 작업 실패</td><td>FAILED</td></tr>
  <tr><td colspan="2">자세한 내용을 알아보려면 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ImportJobProperties.html#HealthLake-Type-ImportJobProperties-JobStatus](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ImportJobProperties.html#HealthLake-Type-ImportJobProperties-JobStatus) 섹션을 참조하세요.</td></tr>
  <tr><td colspan="2"> 작업 이벤트 내보내기 </td></tr>
  <tr><td>     내보내기 작업 제출됨</td><td>SUBMITTED</td></tr>
  <tr><td>     내보내기 작업 진행 중</td><td>IN\_PROGRESS</td></tr>
  <tr><td>     오류로 완료된 내보내기 작업</td><td>COMPLETED\_WITH\_ERRORS</td></tr>
  <tr><td>     내보내기 작업 완료</td><td>COMPLETED</td></tr>
  <tr><td>     내보내기 작업 실패</td><td>FAILED</td></tr>
  <tr><td colspan="2">자세한 내용을 알아보려면 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ExportJobProperties.html#HealthLake-Type-ExportJobProperties-JobStatus](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_ExportJobProperties.html#HealthLake-Type-ExportJobProperties-JobStatus) 섹션을 참조하세요.</td></tr>
</tbody>
</table>


## HealthLake 이벤트 구조
<a name="event-notifications-structure"></a>

HealthLake 이벤트는 메타데이터 세부 정보도 포함하는 JSON 구조의 객체입니다. 메타데이터를 입력으로 사용하여 이벤트를 다시 생성하거나 자세한 내용을 알아볼 수 있습니다. 연결된 모든 메타데이터 필드는 다음 메뉴의 코드 예제 아래 테이블에 나열됩니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [AWS 서비스 이벤트 메타데이터](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

**참고**  
HealthLake 이벤트를 Amazon EventBridge로 보내는 방법을 알아보려면 for *AWS Industry* 블로그의 [용 Amazon EventBridge 통합 AWS HealthLake](https://aws.amazon.com/blogs/industries/amazon-eventbridge-integration-for-aws-healthlake)을 참조하세요.

### 데이터 스토어 이벤트
<a name="event-notifications-data-store"></a>

------
#### [ Data Store Creating ]

**상태 - `CREATING`**

```
{
    "version": "0",
    "id": "514ad836-bb8a-4523-a10b-fa2756c3bdb0",
    "detail-type": "Data Store Creating",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T08:58:12Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Active ]

**상태 - `ACTIVE`**

```
{
    "version": "0",
    "id": "d57105bc-0d2d-4009-b34d-453e2567c599",
    "detail-type": "Data Store Active",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T09:16:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Deleting ]

**상태 - `DELETING`**

```
{
    "version": "0",
    "id": "d135ee1f-e14a-4730-8766-7b98f822c94a",
    "detail-type": "Data Store Deleting",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T12:44:47Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Deleted ]

**상태 - `DELETED`**

```
{
    "version": "0",
    "id": "6d880b86-e115-4947-81a9-494db704571a",
    "detail-type": "Data Store Deleted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-05-12T12:58:03Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------


**데이터 스토어 이벤트 - 메타데이터 설명**  

| 이름 | Type | 설명 | 
| --- | --- | --- | 
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. | 
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. | 
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. | 
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. | 
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. | 
| time | 문자열 | 이벤트가 발생한 시간입니다. | 
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. | 
| resources | 배열(문자열) | 데이터 스토어의 ARN을 포함하는 JSON 배열입니다. | 
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. | 
| detail.datastoreId | 문자열 | 상태 변경 이벤트와 연결된 데이터 스토어 ID입니다. | 
| detail.datastoreName | 문자열 | 데이터 스토어 이름입니다. | 
| detail.datastoreTypeVersion | 문자열 | 데이터 스토어 FHIR 버전입니다. | 
| detail.datastoreEndpoint | 문자열 | 데이터 스토어 엔드포인트입니다. | 

### 작업 이벤트 가져오기
<a name="event-notifications-import-jobs"></a>

------
#### [ Import Job Submitted ]

**상태 - `SUBMITTED`**

```
{
    "version": "0",
    "id": "25e606f7-800c-da41-45df-0e68587250c9",
    "detail-type": "Import Job Submitted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:50:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job In Progress ]

**상태 - `IN_PROGRESS`**

```
{
    "version": "0",
    "id": "cc886b49-2737-19c4-7c4e-84ac9429ab73",
    "detail-type": "Import Job In Progress",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:51:23Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Completed ]

**상태 - `COMPLETED`**

```
{
    "version": "0",
    "id": "36c865ef-da41-76ef-c882-3ba8dad8656b",
    "detail-type": "Import Job Completed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Completed With Errors ]

**상태 - `COMPLETED_WITH_ERRORS`**

```
{
    "version": "0",
    "id": "b61387d7-bffe-4f01-8291-65dc4be52cc1",
    "detail-type": "Import Job Completed With Errors",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Failed ]

**상태 - `FAILED`**

```
{
    "version": "0",
    "id": "c4d65575-d1a7-4040-9c6c-c225bf6723c5",
    "detail-type": "Import Job Failed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------


**작업 이벤트 가져오기 - 메타데이터 설명**  

| 이름 | Type | 설명 | 
| --- | --- | --- | 
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. | 
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. | 
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. | 
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. | 
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. | 
| time | 문자열 | 이벤트가 발생한 시간입니다. | 
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. | 
| resources | 배열(문자열) | 데이터 스토어의 ARN을 포함하는 JSON 배열입니다. | 
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. | 
| detail.jobId | 문자열 | 상태 변경 이벤트와 연결된 가져오기 작업 ID입니다. | 
| detail.submitTime | 문자열 | 가져오기 작업이 제출된 시간입니다. | 
| detail.datastoreId | 문자열 | 상태 변경 이벤트를 생성한 데이터 스토어입니다. | 
| detail.inputDataConfig | 문자열 | 가져올 FHIR 파일이 포함된 Amazon S3 버킷의 입력 접두사 경로입니다. | 

### 작업 이벤트 내보내기
<a name="event-notifications-export-jobs"></a>

------
#### [ Export Job Submitted ]

**상태 - `SUBMITTED`**

```
{
    "version": "0",
    "id": "f8af7d04-2221-4f02-a01a-6fc3ae403bab",
    "detail-type": "Export Job Submitted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:50:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job In Progress ]

**상태 - `IN_PROGRESS`**

```
{
    "version": "0",
    "id": "7bb7e39c-707d-4a83-8532-cee015299100",
    "detail-type": "Export Job In Progress",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:51:23Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Completed ]

**상태 - `COMPLETED`**

```
{
    "version": "0",
    "id": "d7629aa7-e63a-4b84-858c-96a62b57ebc8",
    "detail-type": "Export Job Completed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Completed With Errors ]

**상태 - `COMPLETED_WITH_ERRORS`**

```
{
    "version": "0",
    "id": "5fa50bc5-50e3-4bc4-b66a-1b1d2f7b07a7",
    "detail-type": "Export Job Completed With Errors",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Failed ]

**상태 - `FAILED`**

```
{
    "version": "0",
    "id": "49fce45e-7e02-4846-8582-e7f19ca039cb",
    "detail-type": "Export Job Failed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------


**작업 이벤트 내보내기 - 메타데이터 설명**  

| 이름 | Type | 설명 | 
| --- | --- | --- | 
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. | 
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. | 
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. | 
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. | 
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. | 
| time | 문자열 | 이벤트가 발생한 시간입니다. | 
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. | 
| resources | 배열(문자열) | 데이터 스토어의 ARN을 포함하는 JSON 배열입니다. | 
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. | 
| detail.jobId | 문자열 | 상태 변경 이벤트와 연결된 내보내기 작업 ID입니다. | 
| detail.submitTime | 문자열 | 내보내기 작업이 제출된 시간입니다. | 
| detail.datastoreId | 문자열 | 상태 변경 이벤트를 생성한 데이터 스토어입니다. | 
| detail.outputDataConfig | 문자열 | 내보낼 FHIR 파일이 포함된 Amazon S3 버킷의 출력 접두사 경로입니다. | 