에서 EventBridge 사용 AWS HealthOmics - AWS HealthOmics
HealthOmics용 EventBridge 설정HealthOmics의 EventBridge 이벤트이벤트 메시지 구조이벤트 메시지 예제

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

에서 EventBridge 사용 AWS HealthOmics

HealthOmics는 리소스 상태가 변경될 때 Amazon EventBridge로 이벤트를 전송합니다. 리소스에는 가져오기 작업, 내보내기 작업, 리소스 공유, 워크플로, 작업 및 실행이 포함됩니다. 각 리소스 유형에는 이벤트를 생성하는 상태 변경 목록이 있습니다.

이벤트 버스는 이벤트를 수신하여 대상으로 전송하는 라우터입니다. 계정에는 AWS 서비스에서 이벤트를 자동으로 수신하는 기본 이벤트 버스가 포함되어 있습니다. 추가 사용자 지정 이벤트 버스를 생성할 수 있습니다.

이벤트 버스가 이벤트를 수신할 때 수행할 작업을 지정하는 EventBridge 규칙을 생성합니다. 예를 들어 리소스의 상태 변경에 대해 알리는 규칙을 생성할 수 있습니다.

이벤트 사용에 대한 일반적인 시나리오는 다음과 같습니다.

  • 사용자가 리소스를 공유하거나 공유를 취소하는 시기를 모니터링합니다.

  • 실행이 실패하는지 또는 성공적으로 완료되었는지 모니터링합니다.

EventBridge 사용에 대한 자세한 내용은 Amazon EventBridge란 무엇입니까?를 참조하세요.

HealthOmics용 EventBridge 설정

EventBridge 이벤트를 모니터링하려면 먼저 EventBridge 버스를 생성하고 관심 이벤트에 대한 규칙을 생성합니다.

EventBridge 버스 구성

에 기본 이벤트 버스를 사용하거나 사용자 지정 이벤트 버스를 AWS 계정 구성할 수 있습니다. 사용자 지정 이벤트 버스를 구성하려면 다음 단계를 따릅니다.

  1. EventBridge 콘솔: https://console.aws.amazon.com/events/ 엽니다.

  2. 왼쪽 탐색 창에서 이벤트 버스를 선택합니다.

  3. Create event bus(이벤트 버스 생성)를 선택하세요.

  4. 이벤트 버스 생성 양식에 버스의 이름을 입력합니다.

  5. 생성을 선택하여 버스를 생성합니다.

EventBridge 규칙 생성

다음 절차에서는 간단한 규칙을 생성하는 방법을 보여줍니다. 규칙에 대한 자세한 내용은 EventBridge의 규칙을 참조하세요.

  1. EventBridge 콘솔: https://console.aws.amazon.com/events/ 엽니다.

  2. 왼쪽 탐색 창에서 규칙을 선택합니다.

  3. 규칙 생성을 선택합니다. 콘솔에서 규칙 생성 양식이 열립니다.

  4. 규칙 세부 정보 정의에서 규칙의 이름을 입력합니다.

    • 이름에 버스의 이름을 입력합니다.

    • 이벤트 버스에서이 규칙의 버스를 선택합니다.

    • 다음을 선택합니다.

  5. 빌드 이벤트 패턴의 이벤트 소스에서 AWS 이벤트 또는 EventBridge 파트너 이벤트를 선택합니다.

  6. 이벤트 패턴까지 아래로 스크롤합니다.

    1. 이벤트 소스에서 AWS 서비스를 선택합니다.

    2. AWS 서비스의 경우 텍스트 필터에 omics를 입력하고 서비스로 AWS HealthOmics를 선택합니다.

    3. 이벤트 유형에서 관심 있는 이벤트(또는 모든 이벤트)를 선택합니다.

    4. 다음을 선택합니다.

  7. 대상 선택(Select target)에서 이벤트의 대상을 선택합니다. 예를 들어 AWS 서비스, 선택한 CloudWatch 로그 그룹을 선택하고 로그 그룹을 구성합니다.

    여러 대상 유형에 대해 EventBridge에서는 대상에 이벤트를 보낼 권한이 필요합니다. 콘솔에서 이러한 권한을 생성합니다.

  8. (선택 사항) 태그 구성에서 태그를 규칙과 연결합니다.

  9. 검토 및 업데이트에서 구성을 검토하고 규칙 생성을 선택합니다.

HealthOmics의 EventBridge 이벤트

다음 표에는 HealthOmics가 EventBridge로 보내는 이벤트와 이벤트의 가능한 상태 값 목록이 나와 있습니다.

이벤트 이름 가능한 상태 값
주석 가져오기 작업 상태 변경 제출됨, 진행 중, 취소됨, 완료됨, 실패함 또는 실패와 함께 완료됨
주석 저장소 공유 상태 변경 보류 중, 활성화, 활성, 삭제, 삭제, 실패
주석 저장소 상태 변경 생성, 생성, 업데이트, 업데이트, 삭제, 삭제 또는 생성 실패
읽기 세트 활성화 작업 상태 변경 제출됨, 진행 중, 완료됨, 실패 또는 실패로 완료됨
읽기 세트 내보내기 작업 상태 변경 제출됨, 진행 중, 완료됨, 실패 또는 실패로 완료됨
읽기 세트 가져오기 작업 상태 변경 제출됨, 진행 중, 완료됨, 실패 또는 실패로 완료됨
읽기 세트 상태 변경 업로드, 업로드 실패, 활성, 아카이브, 활성화 또는 삭제 처리
참조 가져오기 작업 상태 변경 제출됨, 진행 중, 완료됨, 실패 또는 실패로 완료됨
참조 상태 변경 활성 또는 삭제됨
참조 스토어 상태 변경 생성, 업데이트, 활성 또는 삭제됨
실행 상태 변경 보류 중, 시작 중, 실행 중, 중지 중, 완료됨, 삭제됨, 실패 또는 취소됨
시퀀스 스토어 상태 변경 생성, 업데이트, 활성 또는 삭제됨
작업 상태 변경 보류 중, 시작 중, 실행 중, 중지 중, 완료됨, 삭제됨, 실패 또는 취소됨
변형 가져오기 작업 상태 변경 제출됨, 진행 중, 취소됨, 완료됨, 실패함 또는 실패와 함께 완료됨
변형 스토어 공유 상태 변경 보류 중, 활성화, 활성, 삭제, 삭제, 실패
변형 저장소 상태 변경 생성, 생성, 업데이트, 업데이트, 삭제, 삭제 또는 생성 실패
워크플로 공유 상태 변경 보류 중, 활성화, 활성, 삭제, 삭제, 실패
워크플로 상태 변경 생성 성공, 생성 실패, 삭제 성공 또는 삭제 실패

이벤트 메시지 구조

HealthOmics는 상태 변경 이벤트 메시지를 EventBridge로 전송하기 위한 최선의 노력을 제공합니다. 이벤트는 메타데이터 세부 정보도 포함하는 JSON 구조의 객체입니다. 메타데이터를 입력으로 사용하여 이벤트를 다시 생성하거나 자세한 내용을 알아볼 수 있습니다. 이벤트에는 다음 필드가 포함됩니다.

  • version - 현재 모든 이벤트에 대해 0(0)입니다.

  • id - 모든 이벤트에 대해 생성된 버전 4 UUID입니다.

  • detail-type - 전송 중인 이벤트의 유형입니다.

  • account - 버킷 소유자의 12자리 AWS 계정 ID입니다.

  • source - 이벤트를 생성한 서비스를 식별합니다.

  • time - 이벤트가 발생한 시간입니다.

  • region - 버킷 AWS 리전 의를 식별합니다.

  • resources - 버킷의 Amazon 리소스 이름(ARN)을 포함하는 JSON 배열입니다.

  • detail - 이벤트에 대한 정보가 포함된 JSON 객체입니다.

실행 이벤트에는 다음 필드가 포함됩니다.

  • uuid - 실행의 범용 고유 식별자입니다.

  • workflowId -이 실행과 연결된 워크플로의 워크플로 식별자입니다.

  • workflowName -이 실행과 연결된 워크플로의 이름입니다.

  • runId - 실행 식별자입니다.

  • runName - 실행 이름입니다.

  • runOutputUri - 실행이 출력 데이터를 쓸 URI입니다.

이벤트 메시지 예제

다음 예제는 추가 필드를 보여주는 실행 상태 변경 이벤트입니다.

{
    "version":"0",
    "id":"c0e540f4-df38-b986-86c1-3e3730f971fe",
    "detail-type":"Run Status Change",
    "source":"aws.omics",
    "account":"123456789012",
    "time":"2022-10-20T22:07:35Z",
    "region":"us-west-2",
    "resources":[
        "arn:aws:omics:us-west-2:123456789012:run/2101313"
    ],
    "detail":{
        "omicsVersion":"1.0.0",
        "arn":"arn:aws:omics:us-west-2:123456789012:run/2101313",
        "status":"COMPLETED",
        "uuid":"153893cd-097a-40ec-aec7-838a97cd2b21",
        "runId": "1234567",
        "runName": "run name",
        "runOutputUri": "s3://amzn-s3-demo-bucket/run-output/2101313",
        "workflowId": "1234567",
        "workflowName": "workflow name"
    }  
}

다음 예제는 작업 상태 변경에 대한 이벤트입니다.

{
    "version": "0",
    "id": "718d6817-c868-26d3-8ef0-0dc9b2ac73f4",
    "detail-type": "Task Status Change",
    "source": "aws.omics",
    "account": "123456789012",
    "time": "2024-10-30T09:05:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:omics:us-west-2:123456789012:task/8888888"],
    "detail": {
        "omicsVersion": "1.0.0",
        "arn": "arn:aws:omics:us-west-2:123456789012:task/8888888",
        "status": "COMPLETED",
        "runArn": "arn:aws:omics:us-west-2:123456789012:run/2101313",
        "runUuid": "153893cd-097a-40ec-aec7-838a97cd2b21",
        "runId": "1234567",
        "runName": "run name",
        "workflowId": "1234567",
        "workflowName": "workflow name"
    }      
}

다음은 읽기 세트 상태 변경에 대한 이벤트의 예입니다.

{
  "version": "0",
  "id": "64ca0eda-9751-dc55-c41a-1bd50b4fc9b7",
  "detail-type": "Read Set Status Change",
  "source": "aws.omics",
  "account": "123456789012",
  "time": "2023-04-04T17:53:06Z",
  "region": "us-west-2",
  "resources": ["arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012"],
  "detail": {
     "omicsVersion": "1.0.0",
     "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012",
     "sequenceStoreId" : "1234567890", 
     "id": "3456789012", 
     "status": "PROCESSING_UPLOAD"
  }
}

변형 저장소 가져오기 작업에 대해 유사한 이벤트가 생성됩니다.

{
    "version": "0",
    "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
    "detail-type": "Variant Store Status Change",
    "source": "aws.omics",
    "account": "123456789012",
    "time": "2015-12-22T18:43:48Z",
    "region": "us-east-1",
    "resources": ["arn:aws:omics:us-east-1:123456789012:myvariantstore2"],
    "detail": {
       "omicsVersion": "1.0.0",
       "arn": "arn:aws:omics:us-east-1:123456789012:myvariantstore2",
       "status": "CREATED",
       "storeId": "6710c5f02610", 
       "storeName": "myvariantstore2"
    }
}

다음은 가져오기 작업 상태 변경에 대한 이벤트입니다.

{
    "version": "0",
    "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
    "detail-type": "Variant Import Job Status Change",
    "source": "aws.omics",
    "account": "123456789012",
    "time": "2015-12-22T18:43:48Z",
    "region": "us-east-1",
    "resources": ["arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9"],
    "detail": {
       "omicsVersion": "1.0.0",
       "arn": "arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9",   
       "status": "COMPLETED",
       "jobId": "b64ea9a3-459f-4b68-92c3-3ddb83209fe9",
       "storeId": "a74869f91e20",
       "storeName": "my_variant_store"
    }
}