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, le dimensionnement, 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 dont la valeur NodeProvisioningMode est définie surContinuous. Les événements sont accessibles via les DescribeClusterEvent API ListClusterEvents and, l'onglet Événements de la console SageMaker AI et Amazon EventBridge.

Enregistrement des événements du cluster

Chaque événement de cluster est représenté sous la forme d'un enregistrement structuré contenant des métadonnées d'identification, de calendrier, de portée, de gravité et spécifiques à l'opération. L'exemple suivant montre un enregistrement d'événement complet tel qu'il a été fourni 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 transmet la description de l'événement. Le contenu de EventMetadata varie en fonction du type de ressource et du type d'événement. Pour le schéma complet et les champs pris en charge, consultez EventMetadatale 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 l' EventBridge 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 indique la valeur du Description champ dans l'enregistrement d'événement tel qu'il 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 d'instance

Cycle de vie du système de fichiers FSx

Application de correctifs (étapes courantes)

Ces événements de correction sont émis 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 de Karpenter

Application de correctifs — au niveau de l'instance EKS

Correctifs — EKS rollback

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 à la santé des nœuds :

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

Référence des API

Consultez aussi