翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 クラスターに対して次のイベントが出力されます。Description 列には、API レスポンスとコンソールの Events タブに表示されるイベントレコードの Descriptionフィールドの値が表示されます。

クラスターのライフサイクル

インスタンスグループのライフサイクル

インスタンスグループのネットワーク設定

インスタンスの作成

インスタンスの削除

インスタンスの再起動

インスタンスオペレーション (汎用)

インスタンスの置き換え

FSx ファイルシステムのライフサイクル

パッチ適用 (一般的なステップ)

これらのパッチ適用イベントは、UpdateClusterSoftwareオペレーション中に EKS クラスターと Slurm クラスターの両方に対して出力されます。

EKS 固有のイベント

次のイベントは、Amazon EKS とオーケストレーションされた HyperPod クラスターに対してのみ出力されます。

アクセスエントリ管理

Kubernetes 設定の更新

Karpenter 自動スケーリング

パッチ適用 — EKS インスタンスレベル

パッチ適用 — EKS ロールバック

Slurm 固有のイベント

次のイベントは、Slurm とオーケストレーションされた HyperPod クラスターに対してのみ出力されます。

EventBridge 統合

HyperPod は、3 つの詳細タイプを使用してクラスターイベントを 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 リファレンス

関連情報