View a markdown version of this page

Migrez d'Enhanced Container Insights (Classic) vers OTel Container Insights - Amazon CloudWatch
Conditions préalablesÉvolutionsÉtapes de la migrationVérificationRestauration

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.

Migrez d'Enhanced Container Insights (Classic) vers OTel Container Insights

Enhanced Container Insights (Classic) et OTel Container Insights utilisent le même module complémentaire amazon-cloudwatch-observability Amazon EKS. La migration est une mise à jour de version complémentaire sur place que vous pouvez effectuer en 15 à 30 minutes.

Avertissement

CloudWatch les alarmes configurées avec des noms de métriques classiques ne fonctionnent pas automatiquement avec les métriques OTel. Vous devez recréer les alarmes à l'aide des règles PromQL-based d'alarme.

Conditions préalables

Avant de commencer la migration, vérifiez que vous répondez aux exigences suivantes.

  • Un cluster Amazon EKS exécutant Kubernetes version 1.28 ou ultérieure

  • Le amazon-cloudwatch-observability module complémentaire est installé et en ACTIVE état

  • AWS CLI version 2.15.0 ou ultérieure

  • kubectlconfiguré pour communiquer avec votre cluster cible

  • Un rôle IAM auquel est attachée la politique CloudWatchAgentServerPolicy gérée

Évolutions

Passez en revue les modifications majeures suivantes avant de commencer la migration.

Fonctionnalités supprimées

Les fonctionnalités suivantes ne sont pas disponibles dans OTel Container Insights :

  • Métriques personnalisées StatsD — Utilisez plutôt le récepteur StatsD OTel.

  • collectd plugin — Migrer vers l' OTel-nativeinstrumentation.

Valeurs par défaut modifiées

Le tableau suivant indique les valeurs par défaut qui changent entre Classic et OTel Container Insights.

Paramètre Par défaut classique IP OTel par défaut
Intervalle de collecte 60 secondes 60 secondes
Observabilité améliorée Activé Activé
Demande CPU de l'agent 200 m 100 m
Demande de mémoire de l'agent 200 milles 128 milles

Étapes de la migration

Cette migration utilise une approche progressive afin de minimiser les lacunes en matière de surveillance. Vous exécutez les flux de métriques Classic et OTel en parallèle, vous validez les données, puis vous désactivez le flux Classic.

Phase 1 : Confirmation de l'état actuel (version classique uniquement)

Avant d'apporter des modifications, confirmez l'état actuel de votre module complémentaire et enregistrez la version pour la restauration.

Pour confirmer la configuration actuelle de votre module complémentaire

  1. Exécutez la commande suivante pour vérifier l'état actuel du module complémentaire.

    aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability

  2. Vérifiez que le status champ estACTIVE.

  3. Enregistrez la addonVersion valeur. Vous avez besoin de cette valeur si vous devez revenir en arrière.

Phase 2 : activer la double publication (Classic + OTel)

Activez OTel Container Insights parallèlement à Enhanced Container Insights (Classic). Cela publie les deux flux métriques simultanément afin que vous puissiez valider l'équivalence des données.

Important

Les deux flux métriques sont facturés au cours de cette phase. Nous recommandons que la double fenêtre de publication soit aussi courte que possible afin de minimiser les coûts.

Pour activer la double publication

  1. Exécutez la commande suivante pour mettre à jour le module complémentaire avec les deux flux activés.

    aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --addon-version latest-version \
  --configuration-values '{"containerInsights":{"enabled":true},"otelContainerInsights":{"enabled":true}}' \
  --resolve-conflicts OVERWRITE

  2. Attendez que le statut du module complémentaire revienne àACTIVE.

    aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --query "addon.status"

  3. Vérifiez que les métriques OTel apparaissent dans en CloudWatch interrogeant une métrique connue avec ProMQL.

Phase 3 : recréer les alarmes et mettre à jour les tableaux de bord

Créez des remplacements OTel pour vos alarmes et tableaux de bord classiques existants. Maintenez les alarmes classiques actives comme filet de sécurité pendant cette phase.

Pour recréer des alarmes pour les métriques OTel

  1. Identifiez toutes les CloudWatch alarmes qui font référence aux noms des métriques Classic Container Insights.

  2. Créez des alarmes équivalentes à l'aide d'expressions mathématiques PromQL-based métriques faisant référence aux noms des métriques OTel.

  3. Vérifiez que les nouvelles alarmes entrent en OK état et produisent des évaluations de seuil équivalentes.

  4. Mettez à jour tous CloudWatch les tableaux de bord pour inclure des widgets basés sur les métriques OTel aux côtés des widgets classiques existants.

Phase 4 : Désactiver Classic (passer à OTel uniquement)

Après avoir vérifié que les métriques, les alarmes et les tableaux de bord OTel fonctionnent correctement, désactivez le flux classique.

Pour désactiver Classic et conserver OTel uniquement

  1. Exécutez la commande suivante pour désactiver la publication classique des métriques.

    aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{"containerInsights":{"enabled":false},"otelContainerInsights":{"enabled":true}}' \
  --resolve-conflicts OVERWRITE

  2. Attendez que le statut du module complémentaire revienne àACTIVE.

  3. Supprimez les alarmes classiques que vous avez remplacées dans la phase 3.

Vérification

Une fois la migration terminée, vérifiez que votre pile d'observabilité fonctionne correctement.

  • Vérifiez les métriques dans Query Studio : utilisez des requêtes ProMQL pour confirmer que les métriques proviennent du pipeline OTel.

  • Comparer avec les valeurs de référence : vérifiez que les valeurs des mesures sont cohérentes avec les mesures classiques que vous avez enregistrées au cours de la phase 2.

  • Vérifiez les tableaux de bord Container Insights : vérifiez que la console Container Insights affiche les données de votre cluster.

  • Vérifier la livraison des journaux : vérifiez que les journaux des conteneurs continuent d'apparaître dans CloudWatch les journaux.

  • Vérifier les alarmes : vérifiez qu'aucune alarme n'est INSUFFICIENT_DATA active.

Restauration

Si vous rencontrez des problèmes après la migration, vous pouvez restaurer la configuration classique précédente.

Pour revenir à Enhanced Container Insights (Classic)

  1. Identifiez la version précédente du module complémentaire que vous avez enregistrée lors de la phase 1.

  2. Exécutez la commande suivante pour rétrograder le module complémentaire.

    aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --addon-version previous-version \
  --resolve-conflicts OVERWRITE

  3. Attendez que le statut du module complémentaire revienne àACTIVE.

    aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --query "addon.status"

  4. Re-apply toutes les valeurs de configuration personnalisées que vous avez utilisées avec la version précédente.