Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

SageMaker HyperPod référence des événements du cluster

Cette page fournit une référence complète de tous les événements structurés émis par les SageMaker HyperPod clusters Amazon. Les événements fournissent une visibilité sur les opérations au niveau du cluster, du groupe d'instances et de l'instance, notamment le provisionnement, la mise à l'échelle, l'application de correctifs et les modifications du cycle de vie spécifiques à l'orchestrateur.

Les événements de cluster sont disponibles pour les HyperPod clusters NodeProvisioningMode définis surContinuous. Les événements sont accessibles via les DescribeClusterEvent API ListClusterEvents et, l'onglet Événements de la console SageMaker AI et Amazon EventBridge.

Record des événements du cluster

Chaque événement de cluster est représenté sous la forme d'un enregistrement structuré contenant l'identification, le calendrier, la portée, la gravité et des métadonnées spécifiques à l'opération. L'exemple suivant montre un enregistrement d'événement complet tel que diffusé via l'DescribeClusterEventAPI et 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"
          }
        }
      }
    }
  }
}

Champs d'enregistrement d'événements

L'objet detail.EventDetails comporte les champs suivants :

Niveaux d'événements

Types de ressources

EventDetails métadonnées

Les événements de cluster incluent un EventMetadata objet dans le EventDetails champ qui fournit un contexte spécifique à l'opération au-delà de ce que la description de l'événement indique. Le contenu de EventMetadata varie selon le type de ressource et le type d'événement. Pour le schéma complet et les champs pris en charge, consultez EventMetadata le manuel Amazon SageMaker AI API Reference.

EventBridge champs d'enveloppe

Lorsqu'il est livré via Amazon EventBridge, l'enregistrement de l'événement est emballé dans EventBridge une enveloppe standard :

Événements courants (EKS et Slurm)

Les événements suivants sont émis pour tous les HyperPod clusters, quel que soit l'orchestrateur. La colonne Description affiche la valeur du Description champ dans l'enregistrement d'événement telle qu'elle apparaît dans la réponse de l'API et dans l'onglet Événements de la console.

Cycle de vie d'un cluster

Cycle de vie des groupes d'instances

Configuration réseau du groupe d'instances

Création d'instance

Suppression d'instance

Redémarrage d’instance

Fonctionnement de l'instance (générique)

Remplacement de l'instance

Cycle de vie du système de fichiers FSx

Application de correctifs (étapes courantes)

Ces événements de correction sont émis à la fois pour les clusters EKS et Slurm pendant les opérations. UpdateClusterSoftware

EKS-specific événements

Les événements suivants sont émis uniquement pour les HyperPod clusters orchestrés avec Amazon EKS.

Gestion des entrées d'accès

Mises à jour de configuration de Kubernetes

Mise à l'échelle automatique Karpenter

Application de correctifs au niveau de l'instance EKS

Application de correctifs — Annulation EKS

Slurm-specific événements

Les événements suivants sont émis uniquement pour les HyperPod clusters orchestrés avec Slurm.

EventBridge intégration

HyperPod envoie des événements de cluster à Amazon EventBridge en utilisant trois types de détails :

Exemples de modèles d'événements

Tous les événements HyperPod du cluster :

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

Événements d'erreur uniquement (pour les alertes) :

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

Événements pour un cluster spécifique :

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

Événements liés à l'état des nœuds :

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

Référence des API

Consultez aussi