翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# SageMaker HyperPod Slurm クラスターイベント
Amazon SageMaker HyperPod は、クラスター、インスタンスグループ、インスタンスレベルでの運用上の変更を可視化する構造化クラスターイベントを出力します。これらのイベントを使用して、プロビジョニングアクティビティのモニタリング、スケーリングオペレーションの追跡、障害の検出、自動アラートパイプラインの構築を行うことができます。
クラスターイベントは、 が `NodeProvisioningMode`に設定されている HyperPod Slurm クラスターで使用できます`Continuous`。イベントには、 `ListClusterEvents`および `DescribeClusterEvent` APIs、SageMaker AI コンソール、Amazon EventBridge からアクセスできます。
完全なイベントスキーマ、重要度レベル、完全なイベントカタログ、および EventBridge 統合の詳細については、「」を参照してください[SageMaker HyperPod クラスターイベントリファレンス](sagemaker-hyperpod-cluster-events-reference.md)。
## 前提条件
+ HyperPod Slurm クラスターは を `NodeProvisioningMode`に設定する必要があります`Continuous`。レガシープロビジョニングモードを使用するクラスターは、構造化イベントを出力しません。
+ API を使用するには、IAM ポリシーで `sagemaker:ListClusterEvents`および アクセス`sagemaker:DescribeClusterEvent`許可が必要です。
## イベントタイプ
HyperPod は、継続的なプロビジョニング時に Slurm クラスターに 2 つのカテゴリのイベントを発行します。すべてのオーケストレーターに適用される一般的なイベントと Slurm 固有のイベントです。
**一般的なイベント**には、インスタンスのプロビジョニングと終了、インスタンスグループのスケーリング、キャパシティ予約処理、ライフサイクルスクリプト実行、ENI 管理、FSx ファイルシステムのライフサイクル、パッチ適用ワークフローなどのコアインフラストラクチャオペレーションが含まれます。完全なリストについては、HyperPod クラスターイベントリファレンス[一般的なイベント (EKS および Slurm)](sagemaker-hyperpod-cluster-events-reference.md#sagemaker-hyperpod-cluster-events-common)の「」を参照してください。
**Slurm 固有のイベント**は、プロビジョニングパラメータの検証、munge キーの作成、Slurm 設定ドリフトの検出、Slurm の再設定、クラスターのロールバックなどのオーケストレーター固有のオペレーションを対象としています。これらのイベントは、以前は CloudWatch ログを介してのみ観測できた Slurm 固有のライフサイクルステージを可視化します。完全なリストについては、HyperPod クラスターイベントリファレンス[Slurm 固有のイベント](sagemaker-hyperpod-cluster-events-reference.md#sagemaker-hyperpod-cluster-events-slurm)の「」を参照してください。
## コンソールでのイベントの表示
1. [SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)を開きます。
1. 左側のナビゲーションペインで、**HyperPod クラスター**を選択します。
1. クラスター名を選択します。
1. **[イベント]** タブを選択します。
**イベント**タブには、イベントレベル、イベント ID、リソース名、リソースタイプ、説明、イベント時刻の列を含むイベントのページ分割されたリストが表示されます。検索ボックスを使用して属性でイベントをフィルタリングし、イベント時刻でソートして、イベント ID を選択すると、イベントメタデータや完全なイベントレコードを含む完全なイベントの詳細を表示できます。
## CLI AWS を使用したイベントの一覧表示
`list-cluster-events` コマンドを使用して、クラスターのイベントを取得します。
```
aws sagemaker list-cluster-events \
--cluster-name my-slurm-cluster \
--sort-by EventTime \
--sort-order Descending \
--max-results 20
```
次のフィルターを使用して結果を絞り込むことができます。
+ `--resource-type` — `Cluster`、、`InstanceGroup`または でフィルタリングします`Instance`。
+ `--instance-group-name` — 特定のインスタンスグループのイベントにフィルタリングします。
+ `--node-id` — 特定の EC2 インスタンスのイベントにフィルタリングします。
+ `--event-time-after` および `--event-time-before` — 特定の時間枠にフィルタリングします。
たとえば、特定のinstance-group-levelイベントのみを表示するには、次のようにします。
```
aws sagemaker list-cluster-events \
--cluster-name my-slurm-cluster \
--resource-type InstanceGroup \
--instance-group-name gpu-workers
```
## 特定のイベントの説明
コマンドをリスト出力のイベント ID `describe-cluster-event`とともに使用して、、`EventLevel`、`Description`および を含む完全なイベントの詳細を取得します`EventMetadata`。
```
aws sagemaker describe-cluster-event \
--cluster-name my-slurm-cluster \
--event-id 83ea0bb5-be77-45e8-a458-0a87f778a205
```
返されるイベントレコードの構造と各フィールドの説明については、HyperPod クラスターイベントリファレンスの[クラスターイベントレコード](sagemaker-hyperpod-cluster-events-reference.md#sagemaker-hyperpod-cluster-events-record)「」を参照してください。
## Amazon EventBridge によるレスポンスの自動化
HyperPod クラスターイベントは、詳細タイプ で Amazon EventBridge に自動的に送信され`SageMaker HyperPod Cluster Event`、Lambda、Amazon SNS、Step Functions、Amazon SQS などのターゲットにイベントをルーティングできます。`EventLevel` フィールドでフィルタリングして`Error`イベントのみのアラートをトリガーしたり、クラスター ARN でフィルタリングしてルールを特定のクラスターにスコープしたりできます。
EventBridge イベントパターン、ペイロードの例、および関連する`SageMaker HyperPod Cluster State Change`タイプと`SageMaker HyperPod Cluster Node Health Event`詳細タイプについては、HyperPod クラスターイベントリファレンス[EventBridge 統合](sagemaker-hyperpod-cluster-events-reference.md#sagemaker-hyperpod-cluster-events-eventbridge)の「」を参照してください。
## 関連トピック
+ [SageMaker HyperPod クラスターイベントリファレンス](sagemaker-hyperpod-cluster-events-reference.md)
+ [Amazon SageMaker AI が Amazon EventBridge に送信するイベント](https://docs.aws.amazon.com/sagemaker/latest/dg/automating-sagemaker-with-eventbridge.html)