View a markdown version of this page

Bermigrasi dari Enhanced Container Insights (Classic) ke OTel Container Insights - Amazon CloudWatch
PrasyaratMelanggar perubahanLangkah migrasiVerifikasiRollback

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bermigrasi dari Enhanced Container Insights (Classic) ke OTel Container Insights

Baik Enhanced Container Insights (Classic) dan OTel Container Insights menggunakan add-on amazon-cloudwatch-observability Amazon EKS yang sama. Migrasi adalah pembaruan versi add-on di tempat yang dapat Anda selesaikan dalam 15-30 menit.

Awas

CloudWatch alarm yang dikonfigurasi dengan nama metrik Klasik tidak berfungsi secara otomatis dengan metrik OTel. Anda harus membuat ulang alarm menggunakan aturan PromQL-based alarm.

Prasyarat

Sebelum memulai migrasi, verifikasi bahwa Anda memenuhi persyaratan berikut.

  • Cluster Amazon EKS yang menjalankan Kubernetes versi 1.28 atau yang lebih baru

  • amazon-cloudwatch-observabilityAdd-on diinstal dan dalam status ACTIVE

  • AWS CLI versi 2.15.0 atau yang lebih baru

  • kubectldikonfigurasi untuk berkomunikasi dengan cluster target Anda

  • Peran IAM dengan kebijakan CloudWatchAgentServerPolicy terkelola terlampir

Melanggar perubahan

Tinjau perubahan yang melanggar berikut sebelum Anda memulai migrasi.

Fitur yang dihapus

Fitur-fitur berikut tidak tersedia di OTel Container Insights:

  • Metrik kustom StatSD — Gunakan penerima StatSD oTel sebagai gantinya.

  • plugin collectd - Migrasi ke OTel-native instrumentasi.

Default berubah

Tabel berikut menunjukkan nilai default yang berubah antara Classic dan OTel Container Insights.

Pengaturan Klasik default OTel CI standar
Interval pengumpulan 60 detik 60 detik
Peningkatan Observabilitas Diaktifkan Diaktifkan
Permintaan agen CPU 200m 100m
Permintaan memori agen 200Mi 128Mi

Langkah migrasi

Migrasi ini menggunakan pendekatan bertahap untuk meminimalkan kesenjangan pemantauan. Anda menjalankan aliran metrik Klasik dan OTel secara paralel, memvalidasi data, dan kemudian menonaktifkan aliran Klasik.

Fase 1: Konfirmasikan status saat ini (Hanya klasik)

Sebelum Anda membuat perubahan, konfirmasikan status add-on Anda saat ini dan rekam versi untuk rollback.

Untuk mengonfirmasi konfigurasi add-on Anda saat ini

  1. Jalankan perintah berikut untuk memeriksa status add-on saat ini.

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

  2. Verifikasi bahwa status bidang tersebutACTIVE.

  3. Catat addonVersion nilainya. Anda membutuhkan nilai ini jika Anda harus memutar kembali.

Fase 2: Aktifkan penerbitan ganda (Classic + OTel)

Aktifkan Insights Kontainer OTel bersama Enhanced Container Insights (Klasik). Ini menerbitkan kedua aliran metrik secara bersamaan sehingga Anda dapat memvalidasi kesetaraan data.

penting

Kedua aliran metrik menimbulkan muatan selama fase ini. Kami menyarankan agar jendela penerbitan ganda sesingkat mungkin untuk meminimalkan biaya.

Untuk mengaktifkan penerbitan ganda

  1. Jalankan perintah berikut untuk memperbarui add-on dengan kedua aliran diaktifkan.

    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. Tunggu status add-on kembali keACTIVE.

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

  3. Verifikasi bahwa metrik OTel muncul dengan menanyakan metrik yang diketahui CloudWatch dengan PromQL.

Fase 3: Buat ulang alarm dan perbarui dasbor

Buat pengganti OTel untuk alarm dan dasbor Klasik yang ada. Jaga agar alarm Klasik tetap aktif sebagai jaring pengaman selama fase ini.

Untuk membuat ulang alarm untuk metrik OTel

  1. Identifikasi semua CloudWatch alarm yang mereferensikan nama metrik Classic Container Insights.

  2. Buat alarm setara menggunakan ekspresi matematika PromQL-based metrik yang mereferensikan nama metrik OTel.

  3. Verifikasi bahwa alarm baru memasuki OK status dan menghasilkan evaluasi ambang batas yang setara.

  4. Perbarui CloudWatch dasbor apa pun untuk menyertakan widget berdasarkan metrik OTel di samping widget Klasik yang ada.

Tahap 4: Nonaktifkan Klasik (hanya beralih ke OTel)

Setelah Anda memvalidasi bahwa metrik, alarm, dan dasbor OTel berfungsi dengan benar, nonaktifkan aliran Klasik.

Untuk menonaktifkan Classic dan hanya menyimpan OTel

  1. Jalankan perintah berikut untuk menonaktifkan penerbitan metrik Klasik.

    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. Tunggu status add-on kembali keACTIVE.

  3. Lepaskan alarm Klasik yang Anda ganti di Fase 3.

Verifikasi

Setelah Anda menyelesaikan migrasi, verifikasi bahwa tumpukan observabilitas Anda berfungsi dengan benar.

  • Periksa metrik di Query Studio — Gunakan kueri PromQL untuk mengonfirmasi bahwa metrik mengalir dari pipeline OTel.

  • Bandingkan dengan nilai dasar — Verifikasi bahwa nilai metrik konsisten dengan metrik Klasik yang Anda rekam selama Fase 2.

  • Verifikasi dasbor Container Insights — Konfirmasikan bahwa konsol Container Insights menampilkan data untuk klaster Anda.

  • Verifikasi pengiriman log — Periksa apakah log kontainer terus muncul di CloudWatch Log.

  • Verifikasi alarm — Konfirmasikan bahwa tidak ada alarm dalam INSUFFICIENT_DATA status.

Rollback

Jika mengalami masalah setelah migrasi, Anda dapat memulihkan konfigurasi Klasik sebelumnya.

Untuk memutar kembali ke Enhanced Container Insights (Klasik)

  1. Identifikasi versi add-on sebelumnya yang Anda rekam di Fase 1.

  2. Jalankan perintah berikut untuk menurunkan versi add-on.

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

  3. Tunggu status add-on kembali keACTIVE.

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

  4. Re-apply nilai konfigurasi kustom apa pun yang Anda gunakan dengan versi sebelumnya.