

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

# Wawasan Kontainer OTel (Direkomendasikan)
<a name="container-insights-eks-otel"></a>

OTel Container Insights adalah pendekatan yang direkomendasikan untuk mengaktifkan Wawasan Kontainer di kluster Amazon EKS. Dibangun di atas OpenTelemetry, ini memberikan observabilitas komprehensif di seluruh metrik dan log dengan model penerapan yang disederhanakan dan pengembangan berkelanjutan yang aktif.

Baik OTel Container Insights dan Enhanced Container Insights (Classic) menggunakan add-on `amazon-cloudwatch-observability` Amazon EKS yang sama. Perbedaannya adalah versi dan konfigurasi add-on, bukan produk yang berbeda. OTel Container Insights adalah konfigurasi add-on yang lebih baru dan dikembangkan secara aktif.

Pendekatan ini dirancang untuk kasus penggunaan berikut:
+ Pelanggan Amazon EKS baru yang menginginkan jalur yang didukung terbaik untuk observabilitas cluster
+ Pelanggan lama yang ingin berkonsolidasi pada satu saluran telemetri modern
+ Tim mengadopsi OpenTelemetry yang menginginkan integrasi asli dengan CloudWatch

## Manfaat utama
<a name="container-insights-eks-otel-benefits"></a>

OTel Container Insights memberikan manfaat sebagai berikut:
+ **Pengaturan yang disederhanakan** - Aktifkan pengamatan penuh dalam hitungan menit melalui konsol, AWS CLI, atau CloudFormation
+ **Sinyal komprehensif** - Kumpulkan metrik dan log dari penyebaran agen tunggal
+ **Peningkatan observabilitas** — Akses metrik Kubernetes yang mendetail, wawasan tingkat pod, dan sinyal berkorelasi
+ **Pengembangan aktif** - Menerima fitur baru, peningkatan kinerja, dan jangkauan sinyal yang diperluas secara berkelanjutan
+ **OpenTelemetry-native**- Dibangun di atas OpenTelemetry Kolektor, selaras dengan kerangka observabilitas standar industri

## Mengapa pendekatan ini direkomendasikan
<a name="container-insights-eks-otel-comparison"></a>

OTel Container Insights direkomendasikan dibandingkan pendekatan Container Insights lainnya karena menyediakan cakupan sinyal terluas (metrik dan log) dengan model penerapan paling sederhana. Pendekatan lain dalam mode perawatan saja atau memerlukan konfigurasi manual yang lebih kompleks.

Tabel berikut membandingkan OTel Container Insights dengan Enhanced Container Insights (Classic).


| Pertimbangan | Wawasan Kontainer OTel | Wawasan Kontainer yang Ditingkatkan (Klasik) | 
| --- | --- | --- | 
| Sinyal | Metrik, Log | Metrik, Log | 
| Peningkatan observabilitas | Ya | Ya | 
| Status pemeliharaan | Pengembangan aktif | Maintenance | 
| Kompleksitas penyebaran | Rendah | Rendah | 

## Sumber dan penerima metrik
<a name="container-insights-eks-otel-receivers"></a>

OTel Container Insights mengumpulkan metrik dari penerima sumber terbuka dan secara otomatis memperkaya mereka dengan konvensi semantik. OpenTelemetry Tidak seperti Enhanced Container Insights (Classic), yang menggunakan nama metrik eksklusif, OTel Container Insights mempertahankan nama metrik asli dari setiap sumber. Ini membuatnya kompatibel dengan dasbor PromQL dan dokumentasi komunitas yang ada.

OTel Container Insights mengumpulkan metrik open-source dari beberapa receiver menggunakan OpenTelemetry Protocol (OTLP) pada perincian 30 detik. Metrik menggunakan nama sumber aslinya (misalnya, `container_cpu_usage_seconds_total` dari cAdvisor) daripada CloudWatch-format nama, dan Anda dapat menanyakannya dengan PromQL.

Tabel berikut mencantumkan penerima yang tersedia dan prasyaratnya.


| Penerima | Apa yang dikumpulkannya | Prasyarat | 
| --- | --- | --- | 
| cAdvisor | CPU kontainer, memori, jaringan, disk/filesystem metrik | Dibangun ke dalam kubelet - tidak ada pengaturan tambahan | 
| Prometheus Node Exportir | Node-level CPU, memori, disk, sistem file, jaringan, sistem, VMStat, metrik netstat/socket  | Termasuk dalam add-on | 
| Metrik Negara Bagian Kube | Pod, simpul, Deployment, DaemonSet,, StatefulSet ReplicaSet, Job,, Layanan CronJob, Namespace, PV, metrik PVC | Termasuk dalam add-on | 
| Kubernetes API Server | Server API dan metrik etcd | Tersedia di pesawat kontrol | 
| NVIDIA DCGM | Pemanfaatan GPU, memori,, pelambatan, power/thermal, metrik NVLink error/reliability | Plugin perangkat NVIDIA dan toolkit kontainer diperlukan | 
| AWS Monitor Neuron | NeuronCore, NeuronDevice, dan metrik sistem Neuron | Driver neuron dan plugin perangkat diperlukan | 
| AWS Adaptor Kain Elastis | Metrik jaringan EFA | Plugin perangkat EFA diperlukan | 
| NVMe | Metrik kesehatan NVMe SMART | Tidak ada pengaturan tambahan | 

Setiap metrik diperkaya dengan hingga 150 label dari tiga sumber berikut:

1. **Label asli sumber telemetri** — Dari penerima asli (misalnya,, `pod``namespace`, `container` dari cAdvisor)

1. **OpenTelemetry atribut resource** — Mengikuti konvensi semantik OTel untuk Kubernetes, Host, dan Cloud

1. Label **pod dan node Kubernetes — Semua label** dari Kubernetes API, diawali dengan dan `k8s.pod.label.*` `k8s.node.label.*`

## Penerbitan dan migrasi ganda
<a name="container-insights-eks-otel-dual-publishing"></a>

OTel Container Insights dinonaktifkan secara default. Untuk mengaktifkannya, atur `otelContainerInsights.enabled` ke `true` dalam konfigurasi add-on.

Dimulai dengan versi add-on v6.2.0, add-on ini mendukung metrik penerbitan melalui Enhanced Container Insights (Classic) dan OTel Container Insights secara bersamaan. Ini memungkinkan Anda untuk memvalidasi pipeline metrik baru sebelum sepenuhnya bermigrasi.

Untuk mengaktifkan OTel Container Insights bersama Enhanced Container Insights (Classic), jalankan perintah berikut.

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

Untuk menonaktifkan OTel Container Insights dan hanya menyimpan Enhanced Container Insights (Classic), jalankan perintah berikut.

```
aws eks update-addon \
  --cluster-name {{cluster-name}} \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{"otelContainerInsights":{"enabled":false}}'
```

Untuk menonaktifkan Enhanced Container Insights (Classic) dan hanya menyimpan OTel Container Insights, jalankan perintah berikut.

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

## Memulai
<a name="container-insights-eks-otel-topics"></a>

Gunakan topik berikut untuk menyiapkan dan mengonfigurasi Insights Kontainer OTel di kluster Amazon EKS Anda.

**Topics**
+ [Mulai cepat: OTel Container Insights di Amazon EKS](container-insights-eks-otel-quickstart.md)— Mulai dengan OTel Container Insights menggunakan jalur penyiapan tercepat.
+ [Aktifkan Insights Kontainer OTel dari konsol](container-insights-eks-otel-console.md)— Aktifkan Wawasan Kontainer OTel melalui Konsol AWS Manajemen.
+ [Terapkan Wawasan Kontainer OTel dengan Helm](container-insights-eks-otel-helm.md)— Terapkan Insights Kontainer OTel menggunakan bagan Helm untuk manajemen yang fleksibel. GitOps-friendly 
+ [Terapkan Wawasan Kontainer OTel dengan CloudFormation](container-insights-eks-otel-cfn.md)— Menyebarkan OTel Container Insights menggunakan template. CloudFormation 
+ [Mengirim log ke Amazon CloudWatch](container-insights-eks-otel-logs.md)— Konfigurasikan koleksi log untuk kluster Amazon EKS Anda.
+ [Konfigurasi lanjutan untuk OTel Container Insights di Amazon EKS](container-insights-eks-otel-advanced.md)— Sesuaikan dan sempurnakan Wawasan Kontainer OTel untuk lingkungan Anda.