As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

SageMaker HyperPod referência de eventos de cluster

Esta página fornece uma referência completa de todos os eventos estruturados emitidos pelos SageMaker HyperPod clusters da Amazon. Os eventos fornecem visibilidade das operações em nível de cluster, grupo de instâncias e instância, incluindo provisionamento, escalabilidade, aplicação de patches e mudanças no ciclo de vida específicas do orquestrador.

Os eventos de cluster estão disponíveis para HyperPod clusters com NodeProvisioningMode definido comoContinuous. Os eventos podem ser acessados por meio das DescribeClusterEvent APIs ListClusterEvents e, da guia Eventos do console de SageMaker IA e da Amazon EventBridge.

Registro de eventos de cluster

Cada evento de cluster é representado como um registro estruturado contendo identificação, tempo, escopo, gravidade e metadados específicos da operação. O exemplo a seguir mostra um registro completo do evento entregue por meio da DescribeClusterEvent API e da 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"
          }
        }
      }
    }
  }
}

Campos de registro de eventos

O objeto detail.EventDetails contém os campos a seguir.

Níveis do evento

Resource types

EventDetails metadados

Os eventos de cluster incluem um EventMetadata objeto dentro do EventDetails campo que fornece um contexto específico da operação além do que a descrição do evento transmite. O conteúdo do EventMetadata varia de acordo com o tipo de recurso e o tipo de evento. Para ver o esquema completo e os campos compatíveis, consulte EventMetadataa Amazon SageMaker AI API Reference.

EventBridge campos de envelope

Quando entregue pela Amazon EventBridge, o registro do evento é embalado no EventBridge envelope padrão:

Eventos comuns (EKS e Slurm)

Os eventos a seguir são emitidos para todos os HyperPod clusters, independentemente do orquestrador. A coluna Descrição mostra o valor do Description campo no registro do evento conforme ele aparece na resposta da API e na guia Eventos do console.

Ciclo de vida do cluster

Ciclo de vida do grupo de instâncias

Configuração de rede do grupo de instâncias

Criação de instância

Exclusão de instância

Reinicialização da instância

Operação de instância (genérica)

Substituição de instâncias

Ciclo de vida do sistema de arquivos FSx

Aplicação de patches (etapas comuns)

Esses eventos de patch são emitidos para os clusters EKS e Slurm durante as operações. UpdateClusterSoftware

EKS-specific eventos

Os eventos a seguir são emitidos somente para HyperPod clusters orquestrados com o Amazon EKS.

Gerenciamento de entradas de acesso

Atualizações de configuração do Kubernetes

Escalonamento automático do Karpenter

Aplicação de patches — nível de instância do EKS

Aplicação de patches — reversão do EKS

Slurm-specific eventos

Os eventos a seguir são emitidos somente para HyperPod clusters orquestrados com o Slurm.

EventBridge integração

HyperPod envia eventos de cluster para a Amazon EventBridge usando três tipos de detalhes:

Exemplos de padrões de eventos

Todos os eventos HyperPod do cluster:

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

Somente eventos de erro (para alertas):

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

Eventos para um cluster específico:

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

Eventos de saúde do Node:

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

Referência de API

Consulte também