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
<a name="container-insights-eks-migrate-from-classic"></a>

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
<a name="container-insights-eks-migrate-from-classic-prereqs"></a>

Sebelum memulai migrasi, verifikasi bahwa Anda memenuhi persyaratan berikut.
+ Cluster Amazon EKS yang menjalankan Kubernetes versi 1.28 atau yang lebih baru
+ `amazon-cloudwatch-observability`Add-on diinstal dan dalam status `ACTIVE`
+ AWS CLI versi 2.15.0 atau yang lebih baru
+ `kubectl`dikonfigurasi untuk berkomunikasi dengan cluster target Anda
+ Peran IAM dengan kebijakan `CloudWatchAgentServerPolicy` terkelola terlampir

## Melanggar perubahan
<a name="container-insights-eks-migrate-from-classic-breaking"></a>

Tinjau perubahan yang melanggar berikut sebelum Anda memulai migrasi.

### Fitur yang dihapus
<a name="container-insights-eks-migrate-from-classic-removed"></a>

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
<a name="container-insights-eks-migrate-from-classic-defaults"></a>

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
<a name="container-insights-eks-migrate-from-classic-steps"></a>

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)
<a name="container-insights-eks-migrate-from-classic-phase1"></a>

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
   ```

1. Verifikasi bahwa `status` bidang tersebut`ACTIVE`.

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

### Fase 2: Aktifkan penerbitan ganda (Classic \+ OTel)
<a name="container-insights-eks-migrate-from-classic-phase2"></a>

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
   ```

1. Tunggu status add-on kembali ke`ACTIVE`.

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

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

### Fase 3: Buat ulang alarm dan perbarui dasbor
<a name="container-insights-eks-migrate-from-classic-phase3"></a>

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.

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

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

1. 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)
<a name="container-insights-eks-migrate-from-classic-phase4"></a>

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
   ```

1. Tunggu status add-on kembali ke`ACTIVE`.

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

## Verifikasi
<a name="container-insights-eks-migrate-from-classic-verify"></a>

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
<a name="container-insights-eks-migrate-from-classic-rollback"></a>

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.

1. 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
   ```

1. Tunggu status add-on kembali ke`ACTIVE`.

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

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