문제 해결 - AWS HealthOmics
워크플로 문제 해결통화 캐싱 문제 해결데이터 스토어 문제 해결Amazon Q CLI를 사용한 문제 해결

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

문제 해결

다음 주제는 HealthOmics 워크플로 및 데이터 스토어를 사용할 때 발생하는 문제를 해결하는 데 도움이 될 수 있습니다.

워크플로 문제 해결

실패한 실행 문제를 해결하려면 어떻게 해야 합니까?

GetRun API 작업을 사용하여 실패 이유를 검색합니다. 자세한 내용은 실행 실패 이유 단원을 참조하십시오.

실패한 작업의 문제를 해결하려면 어떻게 해야 합니까?

작업 실패 메시지의 오류 코드를 검토하여 실패를 이해합니다. CloudWatch의 작업 로그를 검토하여 작업에 대한 자세한 로깅 메시지를 확인합니다. 자세한 로그 메시지가 표시되지 않는 경우 워크플로를 수정하여 추가 로그 문을 출력할 수 있습니다. 자세한 내용은 CloudWatch Logs를 사용하여 HealthOmics 모니터링 단원을 참조하십시오.

성공적으로 완료된 실행에 대한 엔진 로그는 어디에서 찾을 수 있습니까?

HealthOmics는 실패한 실행에 대해서만 CloudWatch에 로그를 게시합니다. 실행이 성공적으로 완료되면 HealthOmics는 엔진 로그를 Amazon S3 버킷에 전송합니다. 자세한 내용은 Amazon S3의 로그 단원을 참조하십시오.

워크플로의 입력 파라미터 크기를 줄이려면 어떻게 해야 하나요?

워크플로에 대해 최대 50KB의 입력 파라미터를 지정할 수 있습니다. 디렉터리 가져오기 또는 샘플 시트를 사용하여이 크기 제약 내에서 유지할 수 있습니다. 자세한 내용은 실행 파라미터 크기 관리 단원을 참조하십시오.

실행이 완료되지 않는 이유는 무엇인가요?

코드에 문제가 있고 프로세스가 제대로 종료되지 않은 경우 실행이 응답하지 않거나 “멈출” 수 있습니다. 응답하지 않는 실행을 방지하고 포착하는 방법에 대한 자세한 내용은 섹션을 참조하세요응답하지 않는 실행에 대한 지침.

통화 캐싱 문제 해결

다음 주제는 통화 캐싱에서 발생하는 문제를 해결하는 데 도움이 될 수 있습니다.

실행이 캐시에 저장되지 않는 이유는 무엇인가요?

  1. GetRun API 작업 응답에서 cacheId 필드를 확인하여 실행이 캐시를 사용하도록 구성되어 있는지 확인합니다. CLI를 사용하여 명령을 실행합니다aws omics get-run —id <run_id>.

  2. 실행에 성공한 경우 GetRun 응답에 반환된 캐시 동작이 CACHE_ALWAYS인지 확인합니다. 캐시 동작이 CACHE_ON_FAILURE로 설정된 경우 실행은 실패할 때만 캐시에 저장됩니다.

작업이 캐시 항목을 사용하지 않는 이유는 무엇입니까?

/aws/omics/WorkflowLog CloudWatch 로그 그룹에서 실행 캐시의 로그 스트림을 엽니다. runCache/<cache_id>/<cache_uuid>.

  1. 이전 실행이 캐시될 것으로 예상한 작업에 대한 캐시 항목을 생성했는지 확인합니다. 캐시에 저장된 실행은 CACHE_ENTRY_CREATED 로그 메시지와 함께 기록됩니다.

  2. 작업에 대한 CACHE_MISS 로그를 찾아 완료된 로그를 실행합니다. 로그 항목이 없는 경우 실행이 캐시를 사용하도록 구성되었는지 확인합니다.

  3. 캐시 항목이 생성된 경우 CPU, 메모리 CPUs, GPUs 및 컨테이너 다이제스트가 두 태스크에 대해 동일한지 확인합니다. 캐시 항목을 생성한 태스크의 태스크 ARN은 로그 메시지에 있습니다.

  4. 두 작업의 컴퓨팅 요구 사항이 일치하는 경우 작업 간에 입력이 변경되지 않았는지 확인합니다. 이렇게 하려면 엔진 로그를 엽니다. 실행 상태가 FAILED인 경우 로그는 Cloudwatch Log Group /aws/omics/WorkflowLog에 있습니다. 그렇지 않으면 실행의 출력 디렉터리에서 엔진 로그를 찾을 수 있습니다.

데이터 스토어 문제 해결

읽기 세트에서 S3 GetObject가 실패하는 이유는 무엇인가요?

가장 일반적으로 실패는 누락된 권한으로 인한 것입니다. 시퀀스 스토어 S3 읽기 권한은 시퀀스 스토어 S3 액세스 정책이 액세스를 허용하고 IAM 보안 주체가 액세스를 허용하는 정책을 연결해야 하는 양방향 구성입니다. 정책 요구 사항에 대한 자세한 내용은 섹션을 참조하세요Amazon S3 URIs를 사용한 데이터 액세스 권한. 다음 구성이 있는지 확인합니다.

  • 시퀀스 스토어 S3 액세스 정책은 IAM 보안 주체 또는 보안 주체 계정의 루트에 대한 액세스를 명시적으로 허용했습니다.

  • IAM 보안 주체에 액세스 중인 리소스에 대한 권한을 명시적으로 제공하는 정책이 있는지 확인합니다. IAM 보안 주체 정책은 권한을 정의할 때 액세스 포인트 별칭 기반 경로가 아닌 액세스 포인트 ARN을 사용해야 하며 ARN은 조건에 있고 리소스를 지정하는 데 사용되지 않습니다.

  • 스토어에서 고객 관리형 키(CMK-KMS)를 사용하는 경우 IAM 보안 주체에 키에 대한 kms:decrypt 권한이 있는지 확인합니다. 계정 간 사용을 구성하려면 KMS 교차 계정 액세스 가이드를 참조하세요.

태그 기반 액세스 제어를 사용하는 정책이 있는 경우 다음을 확인하세요.

  • 시퀀스 스토어가 태그 동기화를 완료했는지 확인합니다. 이렇게 하려면 스토어의 상태가 active가 아닌 여야 합니다updating.

  • 읽기 세트 및 정책의 태그 키 또는 키 값에 오타가 없는지 확인합니다.

Athena에서 주석 저장소 또는 변형 저장소를 볼 수 없는 이유는 무엇인가요?

Lake Formation에서 공유된 스토어를 기반으로 리소스 링크를 생성해야 합니다. 액세스 권한이 있는 리소스 링크를 생성하면 Athena에 스토어가 표시됩니다. 자세한 내용은 HealthOmics를 사용하도록 Lake Formation 구성 단원을 참조하십시오.

Athena의 데이터 스토어에 액세스할 수 없는 이유는 무엇인가요?

주석 또는 변형 저장소가 표시되지만 액세스가 거부되었다는 오류 메시지가 표시되는 경우 사용 중인 쿼리 엔진 버전을 확인합니다. 엔진 버전 3을 사용하여 실행되는 쿼리만 지원됩니다. Athena 쿼리 엔진 버전에 대한 자세한 내용은 Amazon Athena 설명서를 참조하세요.

Amazon Q CLI를 사용한 문제 해결

Amazon Q CLI는 다음을 통해 문제 해결 프로세스를 간소화하는 데 도움이 될 수 있습니다.

  • 워크플로 실행 분석 및 작업 실패 디버깅

  • 관련 로그 및 오류 메시지 수집

  • 필요한 모든 디버깅 로그가 연결된 AWS 지원 사례 생성

  • AWS Support에 제출된 정보에서 개인 식별 정보(PII)를 수정합니다.

문제 해결 및 지원 사례 생성을 AWS HealthOmics 위해에서 Amazon Q CLI를 사용하는 방법에 대한 자세한 내용은 GitHub의 HealthOmics Agentic 생성형 AI 자습서를 참조하세요.

주의

Amazon Q CLI로 작업할 때는 계속하기 전에 생성된 모든 콘텐츠와 제안된 작업을 검토합니다. 응답 품질을 개선하고 워크플로의 요구 사항에 맞는 피드백을 제공합니다. 자세한 내용은 Amazon Q의 보안 고려 사항 및 모범 사례를 참조하세요.