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.
# OTel Container Insights (recommandé)
OTel Container Insights est l'approche recommandée pour activer Container Insights sur les clusters Amazon EKS. Sur cette base OpenTelemetry, il fournit une observabilité complète à travers les métriques et les journaux grâce à un modèle de déploiement simplifié et à un développement continu actif.
OTel Container Insights et Enhanced Container Insights (Classic) utilisent le même module complémentaire `amazon-cloudwatch-observability` Amazon EKS. La différence réside dans la version et la configuration du module complémentaire, et non dans un produit différent. OTel Container Insights est la nouvelle configuration activement développée de ce module complémentaire.
Cette approche est conçue pour les cas d'utilisation suivants :
+ Nouveaux clients Amazon EKS qui souhaitent bénéficier du meilleur support pour accéder à l'observabilité des clusters
+ Clients existants qui souhaitent se regrouper sur un pipeline de télémétrie unique et moderne
+ Équipes adoptant et OpenTelemetry souhaitant une intégration native avec CloudWatch
## Principaux avantages
OTel Container Insights offre les avantages suivants :
+ **Configuration simplifiée** : activez une observabilité complète en quelques minutes via la console AWS CLI, ou CloudFormation
+ **Signaux complets** : collectez des métriques et des journaux à partir du déploiement d'un seul agent
+ **Observabilité améliorée** : accédez à des indicateurs Kubernetes détaillés, à des informations au niveau des pods et à des signaux corrélés
+ **Développement actif** : bénéficie de nouvelles fonctionnalités, d'améliorations de performances et d'une couverture de signal étendue sur une base continue
+ **OpenTelemetry-native**— Construit sur le OpenTelemetry Collector, conformément au cadre d'observabilité standard du secteur
## Pourquoi cette approche est recommandée
OTel Container Insights est recommandé par rapport aux autres approches de Container Insights car il fournit la couverture de signal la plus large (métriques et journaux) avec le modèle de déploiement le plus simple. D'autres approches sont en mode maintenance uniquement ou nécessitent une configuration manuelle plus complexe.
Le tableau suivant compare OTel Container Insights avec Enhanced Container Insights (Classic).
| Considération | Informations sur les conteneurs OTel | Informations améliorées sur les conteneurs (version classique) |
| --- | --- | --- |
| Signaux | Métriques, journaux | Métriques, journaux |
| Observabilité améliorée | Oui | Oui |
| État de maintenance | Développement actif | Maintenance |
| Complexité du déploiement | Faible | Faible |
## Sources et récepteurs métriques
OTel Container Insights collecte des métriques auprès de récepteurs open source et les enrichit automatiquement grâce à des conventions OpenTelemetry sémantiques. Contrairement à Enhanced Container Insights (Classic), qui utilise des noms de métriques propriétaires, OTel Container Insights préserve les noms de métriques d'origine de chaque source. Cela les rend compatibles avec les tableaux de bord ProMQL existants et la documentation communautaire.
OTel Container Insights collecte des métriques open source auprès de plusieurs récepteurs à l'aide du OpenTelemetry protocole (OTLP) avec une granularité de 30 secondes. Les métriques utilisent leurs noms de source d'origine (par exemple, `container_cpu_usage_seconds_total` provenant de cAdvisor) plutôt que CloudWatch-format des noms, et vous pouvez les interroger avec ProMQL.
Le tableau suivant répertorie les récepteurs disponibles et leurs prérequis.
| Récepteur | Ce qu'il collecte | Conditions préalables |
| --- | --- | --- |
| cViseur | Processeur du conteneur, mémoire, réseau, disk/filesystem métriques | Intégré à kubelet — aucune configuration supplémentaire |
| Exportateur de nœuds Prometheus | Node-level Processeur, mémoire, disque, système de fichiers, réseau, système, VMstat, métriques netstat/socket | Inclus dans le module complémentaire |
| Métriques de l'état de Kube | Pod, node, Deployment DaemonSet, StatefulSet, ReplicaSet, Job CronJob, Service, Namespace, PV, PVC metrics | Inclus dans le module complémentaire |
| Serveur d'API Kubernetes | Serveur API et métriques etcd | Disponible sur le plan de commande |
| NVIDIA DCGM | Utilisation du GPU, mémoire power/thermal, régulation, métriques error/reliability NVLink | Plug-in pour appareil NVIDIA et boîte à outils de conteneur requis |
| AWS Moniteur Neuron | NeuronCore NeuronDevice, et métriques du système Neuron | Pilote Neuron et plug-in de périphérique requis |
| AWS Adaptateur en tissu élastique | Mesures de mise en réseau EFA | Plug-in d'appareil EFA requis |
| NVMe | Indicateurs de santé NVMe SMART | Aucune configuration supplémentaire |
Chaque métrique est enrichie d'un maximum de 150 étiquettes provenant des trois sources suivantes :
1. **Étiquettes natives de la source de télémétrie** : depuis le récepteur d'origine (par exemple `pod``namespace`, `container` depuis cAdvisor)
1. **OpenTelemetry attributs de ressources** — Respect des conventions sémantiques OTel pour Kubernetes, Host et Cloud
1. Étiquettes **des pods et des nœuds Kubernetes : toutes les étiquettes** de l'API Kubernetes, préfixées par et `k8s.pod.label.*` `k8s.node.label.*`
## Double publication et migration
OTel Container Insights est désactivé par défaut. Pour l'activer, `otelContainerInsights.enabled` définissez-le `true` dans la configuration du module complémentaire.
À partir de la version complémentaire v6.2.0, l'extension prend en charge la publication simultanée de métriques via Enhanced Container Insights (Classic) et OTel Container Insights. Cela vous permet de valider le nouveau pipeline de métriques avant de procéder à la migration complète.
Pour activer OTel Container Insights parallèlement à Enhanced Container Insights (Classic), exécutez la commande suivante.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"containerInsights":{"enabled":true},"otelContainerInsights":{"enabled":true}}'
```
Pour désactiver OTel Container Insights et conserver uniquement Enhanced Container Insights (Classic), exécutez la commande suivante.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"otelContainerInsights":{"enabled":false}}'
```
Pour désactiver Enhanced Container Insights (Classic) et conserver uniquement OTel Container Insights, exécutez la commande suivante.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"containerInsights":{"enabled":false},"otelContainerInsights":{"enabled":true}}'
```
## Prise en main
Utilisez les rubriques suivantes pour configurer et configurer OTel Container Insights sur vos clusters Amazon EKS.
**Topics**
+ [Démarrage rapide : OTel Container Insights sur Amazon EKS](container-insights-eks-otel-quickstart.md)— Commencez avec OTel Container Insights en utilisant le chemin de configuration le plus rapide.
+ [Activez OTel Container Insights depuis la console](container-insights-eks-otel-console.md)— Activez OTel Container Insights via la console AWS de gestion.
+ [Déployez OTel Container Insights avec Helm](container-insights-eks-otel-helm.md)— Déployez OTel Container Insights à l'aide du graphique Helm pour une GitOps-friendly gestion flexible.
+ [Déployez OTel Container Insights avec CloudFormation](container-insights-eks-otel-cfn.md)— Déployez OTel Container Insights à l'aide d'un CloudFormation modèle.
+ [Envoi de journaux à Amazon CloudWatch](container-insights-eks-otel-logs.md)— Configurez la collecte de journaux pour vos clusters Amazon EKS.
+ [Configuration avancée pour OTel Container Insights sur Amazon EKS](container-insights-eks-otel-advanced.md)— Personnalisez et affinez OTel Container Insights en fonction de votre environnement.