

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

# デバッガーの可用性の変更
<a name="debugger-availability-change"></a>

**注記**  
Amazon SageMaker デバッガーは新規顧客に公開されなくなりました。既存のお客様は、引き続きこのサービスを通常どおり使用できます。 は AWS デバッガーのセキュリティと可用性の向上に引き続き投資しますが、新機能を導入する予定はありません。

## Amazon SageMaker デバッガーの置き換え
<a name="debugger-replacing"></a>

代替サービスに移行するには、このガイドに従ってください。

## 概要
<a name="debugger-migration-overview"></a>

Amazon SageMaker デバッガーは、組み込みの SageMaker 機能として、トレーニングオブザーバビリティ、モデルデバッグ、システムプロファイリングを提供しました。これらの機能は、Amazon SageMaker AI MLflow、TensorBoard on SageMaker、Amazon CloudWatch を組み合わせて、オブザーバビリティ、モデルデバッグ、システムパフォーマンスのモニタリングをトレーニングすることでより適切に機能するようになりました。これらのツールは、基盤モデルの微調整、カスタムアーキテクチャのトレーニング、分散ワークロードの実行など、特定のトレーニングワークフローに適応する柔軟な機能を提供します。

## 機能マッピング
<a name="debugger-capability-mapping"></a>


| デバッガー機能 | 置換後の値 | 提供内容 | 
| --- | --- | --- | 
| トレーニングメトリクスのログ記録 | MLflow/TensorBoard | トレーニング実行全体のメトリクスのログ記録、視覚化、比較 | 
| モデルとパラメータの追跡 | MLflow | ハイパーパラメータ、モデルバージョン、アーティファクトを完全な再現性で追跡する | 
| グラデーション、アクティベーション、重みの分析 | TensorBoard | トレーニングステップ全体でモデルの内部を検査するためのヒストグラムとディストリビューションプラグイン | 
| システムリソースプロファイリング (CPU、GPU、メモリ、ディスク) | Amazon CloudWatch | 設定可能なダッシュボードを使用したリアルタイムの使用率メトリクス | 
| 自動トレーニング診断 | Amazon CloudWatch アラーム \+ MLflow | 損失収束、勾配基準、リソース使用率、しきい値違反のアラートなど、記録されたメトリクスをモニタリングします。MLflow 実行比較は実験間の回帰を識別します | 

## ステップ 1: デバッガー設定を削除する
<a name="debugger-step1-remove"></a>

### 推定器から DebuggerHookConfig を削除する
<a name="debugger-remove-hook-config"></a>

トレーニングスクリプトまたは SageMaker 推定器に `DebuggerHookConfig`、デバッガー固有の `TensorBoardOutputConfig`、または `rules`設定が含まれている場合は、それらを削除します。これにより、自動テンソルキャプチャとルール評価が無効になります。

**注記**  
SageMaker Python SDK v2 `Estimator` クラスを使用している場合は、推定器がレガシーコンストラクトであるため、新しい [SageMaker Python SDK トレーニング APIs](https://docs.aws.amazon.com/sagemaker/latest/dg/train-model.html) または直接 Boto3 `CreateTrainingJob`呼び出しへの移行も検討してください。

### Amazon S3 でデバッガー出力を削除する
<a name="debugger-delete-s3-output"></a>

デバッガーはテンソルデータを保存し、次のようなパスで S3 に出力をプロファイリングします。

```
s3://<bucket>/<training-job-name>/debug-output/
s3://<bucket>/<training-job-name>/profiler-output/
```

履歴データが不要になった場合は、これらのプレフィックスを削除します。S3 のトレーニングジョブログとモデルアーティファクトは影響を受けません。

### カスタムデバッガールールを削除する (使用する場合)
<a name="debugger-delete-custom-rules"></a>

カスタムルールコンテナを定義した場合:
+ カスタムデバッガールール評価に使用される Amazon ECR イメージを削除する
+ 不要になったルール定義スクリプトまたは JSON 設定を削除する

### CloudWatch ロググループを削除する (オプション)
<a name="debugger-delete-cloudwatch-logs"></a>

デバッガーは、ルール評価`/aws/sagemaker/TrainingJobs`のために にロググループを作成しました。ログストレージコストを削減する必要がなくなった場合は、これらを削除します。

### IAM ポリシーを確認する
<a name="debugger-review-iam"></a>

デバッガーの使用専用にアクセスを付与した IAM ポリシーを削除します。
+ `s3:GetObject` / `s3:PutObject`デバッガー出力パスの範囲
+ `logs:PutLogEvents` デバッガー固有のロググループ用
+ デバッガールールコンテナ実行のアクセス許可

トレーニングジョブ、MLflow、または CloudWatch にまだ必要なポリシーを保持します。

## ステップ 2: 置き換えを設定する
<a name="debugger-step2-configure"></a>

### MLflow を統合して実験を追跡する
<a name="debugger-integrate-mlflow"></a>

Amazon SageMaker AI は、AI モデル開発タスクをサポートするように動的にスケールするサーバーレス MLflow 機能を追加料金なしで提供します。[起動ブログ](https://aws.amazon.com/blogs/aws/accelerate-ai-development-using-amazon-sagemaker-ai-with-serverless-mlflow/)を参照してください。

MLflow を使用して以下を行います。
+ ハイパーパラメータ、トレーニングメトリクス、モデルアーティファクトのログ記録
+ 実行をside-by-side比較し、リグレッションや改善点を特定する
+ 実験から本番稼働までのモデルバージョンと系統を追跡する

**開始方法: Amazon **[Amazon SageMakerと MLflow を使用した機械学習実験](https://docs.aws.amazon.com/sagemaker/latest/dg/mlflow-track-experiments.html) – セットアップ、追跡サーバーの作成、トレーニングコードとの統合について説明します。

### モデルイントロスペクションに TensorBoard を使用する
<a name="debugger-use-tensorboard"></a>

Amazon SageMaker AI の TensorBoard は、トレーニング中にモデルの内部を深く可視化します。
+ ステップ間の勾配分布と重みヒストグラムを視覚化する
+ アクティベーションパターンとレイヤーの動作をモニタリングする
+ スカラーメトリクス、イメージ、カスタムビジュアライゼーションを追跡する

**TensorBoard と MLflow を使用する場合:** MLflow はスカラーメトリクスを追跡し、実行比較の基本的な視覚化をサポートします。TensorBoard は、勾配ヒストグラム、重み分布、計算グラフ、埋め込み射影など、多次元モデルのイントロスペクションに優れています。実験管理には MLflow、ディープデバッグセッションには TensorBoard の両方を使用します。

**開始方法: Amazon **[Amazon SageMakerの TensorBoard ](https://docs.aws.amazon.com/sagemaker/latest/dg/tensorboard-on-sagemaker.html)

### システムモニタリングとアラートに Amazon CloudWatch を使用する
<a name="debugger-use-cloudwatch"></a>

Amazon CloudWatch は、トレーニングジョブのリソース使用率メトリクスをキャプチャし、設定可能なアラームをサポートします。
+ CPU、GPU、メモリ、ディスク使用率をリアルタイムでモニタリングする
+ トレーニングメトリクスにアラームを設定して異常を検出する – 損失プラトー、リソースのボトルネック、予期しないメトリクスの動作
+ システムメトリクスとトレーニングメトリクスを組み合わせてダッシュボードを構築し、統一された可視性を実現する

**開始方法: **[トレーニングジョブのモニタリングと分析のための Amazon CloudWatch メトリクス](https://docs.aws.amazon.com/sagemaker/latest/dg/training-metrics.html)

## 既存のデータの処理
<a name="debugger-existing-data"></a>
+ **S3 のトレーニングログ:** トレーニングジョブの出力、モデルアーティファクト、ログには引き続きアクセスできます。これらはデバッガーから独立しています。
+ **デバッガーテンソルデータ:** デバッガーによって保存された履歴テンソルコレクションは、削除するまで上記のパスの S3 に残ります。[`smdebug` クライアントライブラリ](https://github.com/awslabs/sagemaker-debugger)は、このデータを引き続き参照用に読み取ることができます。
+ **CloudWatch メトリクス:** CloudWatch に既に存在する履歴トレーニングメトリクスは、アカウントの[ログ保持設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#SettingLogRetention)に従って保持されます。