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

SageMaker HyperPod 클러스터 이벤트 참조

이 페이지에서는 Amazon SageMaker HyperPod 클러스터에서 발생하는 모든 구조화된 이벤트에 대한 전체 참조를 제공합니다. 이벤트는 프로비저닝, 조정, 패치 적용 및 오케스트레이터별 수명 주기 변경을 포함하여 클러스터, 인스턴스 그룹 및 인스턴스 수준 작업에 대한 가시성을 제공합니다.

클러스터 이벤트는가 로 NodeProvisioningMode 설정된 HyperPod 클러스터에 사용할 수 있습니다Continuous. 이벤트는 ListClusterEvents 및 DescribeClusterEvent APIs, SageMaker AI 콘솔 이벤트 탭 및 Amazon EventBridge를 통해 액세스할 수 있습니다.

클러스터 이벤트 레코드

각 클러스터 이벤트는 식별, 타이밍, 범위, 심각도 및 작업별 메타데이터가 포함된 구조화된 레코드로 표시됩니다. 다음 예제는 DescribeClusterEvent API 및 Amazon EventBridge를 통해 전달된 전체 이벤트 레코드를 보여줍니다.

{
  "version": "0",
  "id": "0bd4a141-0a02-9d8a-f977-3924c3fb259c",
  "detail-type": "SageMaker HyperPod Cluster Event",
  "source": "aws.sagemaker",
  "account": "111122223333",
  "time": "2026-06-01T17:20:25Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:sagemaker:us-west-2:111122223333:cluster/sample-cluster"
  ],
  "detail": {
    "EventDetails": {
      "EventId": "83ea0bb5-be77-45e8-a458-0a87f778a205",
      "ClusterArn": "arn:aws:sagemaker:us-west-2:111122223333:cluster/sample-cluster",
      "ClusterName": "sample-cluster",
      "InstanceGroupName": "p5Inst",
      "InstanceId": "i-0391f86fa0fe0d465",
      "ResourceType": "Instance",
      "EventTime": 1748794825350,
      "EventLevel": "Error",
      "Description": "Instance creation in Cluster sample-cluster and InstanceGroup p5Inst failed",
      "EventDetails": {
        "EventMetadata": {
          "Instance": {
            "FailureMessage": "We currently do not have sufficient capacity to launch new ml.p5.48xlarge instances. Please try again.",
            "NodeLogicalId": "df268d19-f035-4f28-9b80-b956b92ae21e"
          }
        }
      }
    }
  }
}

이벤트 레코드 필드

detail.EventDetails 객체는 다음 필드를 포함합니다.

이벤트 수준

조건 키

EventDetails 메타데이터

클러스터 이벤트에는 이벤트 설명에서 전달하는 것 이상의 작업별 컨텍스트를 제공하는 EventDetails 필드 내 EventMetadata 객체가 포함됩니다. 의 내용은 리소스 유형 및 이벤트 유형에 따라 EventMetadata 다릅니다. 전체 스키마 및 지원되는 필드는 Amazon SageMaker AI API 참조의 EventMetadata를 참조하세요.

EventBridge 봉투 필드

Amazon EventBridge를 통해 전달되면 이벤트 레코드가 표준 EventBridge 봉투에 래핑됩니다.

일반적인 이벤트(EKS 및 Slurm)

오케스트레이터에 관계없이 모든 HyperPod 클러스터에 대해 다음 이벤트가 발생합니다. 설명 열에는 API 응답 및 콘솔 이벤트 탭에 표시되는 이벤트 레코드의 Description 필드 값이 표시됩니다.

클러스터 수명 주기

인스턴스 그룹 수명 주기

인스턴스 그룹 네트워크 구성

인스턴스 생성

인스턴스 삭제

인스턴스 재부팅

인스턴스 작업(일반)

인스턴스 교체

FSx 파일 시스템 수명 주기

패치 적용(일반 단계)

이러한 패치 이벤트는 UpdateClusterSoftware 작업 중에 EKS 및 Slurm 클러스터 모두에 대해 내보내집니다.

EKS 관련 이벤트

다음 이벤트는 Amazon EKS로 오케스트레이션된 HyperPod 클러스터에만 내보내집니다.

액세스 항목 관리

Kubernetes 구성 업데이트

Karpenter Auto Scaling

패치 적용 - EKS 인스턴스 수준

패치 적용 - EKS 롤백

Slurm 관련 이벤트

다음 이벤트는 Slurm으로 오케스트레이션된 HyperPod 클러스터에만 내보내집니다.

EventBridge 통합

HyperPod는 세 가지 세부 정보 유형을 사용하여 클러스터 이벤트를 Amazon EventBridge로 전송합니다.

이벤트 패턴 예제

모든 HyperPod 클러스터 이벤트:

{
  "source": ["aws.sagemaker"],
  "detail-type": ["SageMaker HyperPod Cluster Event"]
}

오류 이벤트만 해당(알림용):

{
  "source": ["aws.sagemaker"],
  "detail-type": ["SageMaker HyperPod Cluster Event"],
  "detail": {
    "EventDetails": {
      "EventLevel": ["Error"]
    }
  }
}

특정 클러스터에 대한 이벤트:

{
  "source": ["aws.sagemaker"],
  "detail-type": ["SageMaker HyperPod Cluster Event"],
  "resources": ["arn:aws:sagemaker:us-west-2:111122223333:cluster/my-cluster-id"]
}

노드 상태 이벤트:

{
  "source": ["aws.sagemaker"],
  "detail-type": ["SageMaker HyperPod Cluster Node Health Event"]
}

API 참조

다음 사항도 참조하세요.