# CloudWatch SageMaker AI Insights の使用を開始する
<a name="SageMaker-AI-Insights-Get-Started"></a>

推論エンドポイントの SageMaker AI Insights を有効にしてアクセスするには、次の手順に従います。

エンドポイントで詳細なオブザーバビリティメトリクスを有効にするための完全なセットアップガイドについては、「*SageMaker AI デベロッパーガイド*」の「[SageMaker AI detailed observability](https://docs.aws.amazon.com/sagemaker/latest/dg/inference-detailed-observability.html)」を参照してください。

## ステップ 1: OTel エンリッチメントを有効にする
<a name="SageMaker-AI-Insights-enable-otel"></a>

SageMaker AI Insights を使用するには、アカウントで [OTel メトリクスエンリッチメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTelEnrichment.html)とリソースタグを有効にする必要があります。

**OTel エンリッチメントを有効にするには (コンソール)**

1. CloudWatch コンソールを開き、**[設定]** を選択します。

1. **[OTel metric enrichment]** を有効にします。

1. **[テレメトリのリソースタグ]** を有効にします。

AWS CLI で OTel エンリッチメントを有効にするには、次のコマンドを使用します。

```
aws cloudwatch start-otel-enrichment
aws observabilityadmin start-telemetry-enrichment
```

## ステップ 2: エンドポイント設定を確認する
<a name="SageMaker-AI-Insights-verify-config"></a>

エンドポイント設定で `EnableDetailedObservability` が `true` に設定されていることを確認します。これは、新しいエンドポイントのデフォルト設定です。

```
aws sagemaker describe-endpoint-config --endpoint-config-name {{name}}
# Look for "EnableDetailedObservability": true
```

有効になっていない場合は、フラグを `true` に設定した状態で新しいエンドポイント設定を作成し、エンドポイントを更新します。

## ステップ 3: エンドポイントが InService であることを確認する
<a name="SageMaker-AI-Insights-confirm-inservice"></a>

エンドポイントが `InService` 状態であることを確認します。

```
aws sagemaker describe-endpoint --endpoint-name {{name}} --query "EndpointStatus"
```

期待される出力は `"InService"` です。

## ステップ 4: SageMaker AI Insights を開く
<a name="SageMaker-AI-Insights-open"></a>

次のいずれかのパスを使用して、ダッシュボードに移動します。
+ CloudWatch コンソールで、**[インフラストラクチャのモニタリング]**、**[SageMaker AI Insights]** を順に選択する
+ SageMaker AI コンソールで、**[エンドポイント]**、**[Open SageMaker AI Insights]** を順に選択する
+ SageMaker AI コンソールのエンドポイントの詳細ページで **[View in SageMaker AI Insights]** を選択する

## ステップ 5: データが流れていることを確認する
<a name="SageMaker-AI-Insights-verify-data"></a>

2～3 分後、ダッシュボードに次のデータが表示されるはずです。
+ 概要バーの呼び出し数
+ **[パフォーマンス]** タブのインスタンスと推論コンポーネント (IC) データ
+ **[キャパシティ]** タブの使用率メトリクス

**ヒント**  
「**データなし**」と表示される場合は、OTel エンリッチメントが有効になっていて、エンドポイントが少なくとも 2～3 分間「`InService`」状態になっていることを確認してください。

## SageMaker AI Insights に必要なアクセス許可
<a name="SageMaker-AI-Insights-permissions"></a>

SageMaker AI Insights を使用するには、特定の IAM アクセス許可が必要です。次のポリシーには、SageMaker AI Insights を使用するために必要なアクセス許可が含まれています。

```
{
    "Effect": "Allow",		 	 	 
    "Action": [
        "cloudwatch:GetMetricData",
        "cloudwatch:ListMetrics",
        "cloudwatch:DescribeAlarms",
        "sagemaker:DescribeEndpoint",
        "sagemaker:DescribeEndpointConfig",
        "sagemaker:ListEndpoints",
        "sagemaker:ListInferenceComponents"
    ],
    "Resource": "*"
}
```