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.

# Commencez avec CloudWatch SageMaker AI Insights
<a name="SageMaker-AI-Insights-Get-Started"></a>

Suivez ces étapes pour activer et accéder à SageMaker AI Insights pour vos points de terminaison d'inférence.

Pour le guide de configuration complet sur l'activation de mesures d'observabilité détaillées sur vos terminaux, consultez la section [Observabilité détaillée de l'SageMaker IA](https://docs.aws.amazon.com/sagemaker/latest/dg/inference-detailed-observability.html) dans le Guide du développeur d'*SageMaker IA*.

## Étape 1 : activer l'enrichissement par OTel
<a name="SageMaker-AI-Insights-enable-otel"></a>

SageMaker AI Insights nécessite [l'enrichissement des métriques OTel](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTelEnrichment.html) et l'activation des balises de ressources dans votre compte.

**Pour activer l'enrichissement par OTel (console)**

1. Ouvrez la CloudWatch console et choisissez **Paramètres**.

1. Activez l'**enrichissement des métriques OTel**.

1. Activez les **balises de ressources pour la télémétrie**.

Pour activer l'enrichissement OTel avec le AWS CLI, utilisez les commandes suivantes.

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

## Étape 2 : vérifier la configuration de votre terminal
<a name="SageMaker-AI-Insights-verify-config"></a>

Assurez-vous qu'il `EnableDetailedObservability` est défini `true` sur la configuration de votre terminal. Il s'agit de la valeur par défaut pour les nouveaux points de terminaison.

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

S'il n'est pas activé, créez une nouvelle configuration de point de terminaison avec l'indicateur défini sur `true` et mettez-le à jour.

## Étape 3 : confirmez que votre point de terminaison est InService
<a name="SageMaker-AI-Insights-confirm-inservice"></a>

Vérifiez que votre terminal est dans `InService` cet état.

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

Le résultat attendu est`"InService"`.

## Étape 4 : Ouvrez SageMaker AI Insights
<a name="SageMaker-AI-Insights-open"></a>

Accédez au tableau de bord en utilisant l'un des chemins suivants.
+ CloudWatch console → **Surveillance de l'infrastructure** → **SageMaker AI Insights**
+ SageMaker Console AI → **Points de terminaison** → choisissez **Open SageMaker AI Insights**
+ SageMaker Console AI → page détaillée du point de terminaison → choisissez **Afficher dans SageMaker AI Insights**

## Étape 5 : vérifier que les données circulent
<a name="SageMaker-AI-Insights-verify-data"></a>

Après 2 à 3 minutes, le tableau de bord devrait être renseigné avec les données suivantes.
+ Les invocations sont comptabilisées dans la barre de résumé
+ Données d'instance et de composant d'inférence (IC) dans l'onglet **Performances**
+ Mesures d'utilisation dans l'onglet **Capacité**

**Astuce**  
Si **aucune donnée** s'affiche, vérifiez que l'enrichissement OTel est activé et que votre terminal fonctionne `InService` depuis au moins 2 à 3 minutes.

## Autorisations requises pour SageMaker AI Insights
<a name="SageMaker-AI-Insights-permissions"></a>

Certaines autorisations IAM sont requises pour utiliser SageMaker AI Insights. La politique suivante contient les autorisations requises pour utiliser SageMaker AI Insights.

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