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

# Wawasan Kontainer dengan OpenTelemetry metrik untuk Amazon EKS
<a name="container-insights-otel-metrics"></a>

**Pratinjau**  
Wawasan Kontainer dengan OpenTelemetry metrik memberikan visibilitas ke dalam kesehatan operasional infrastruktur klaster Amazon EKS Anda. Ini tersedia dalam pratinjau publik tanpa biaya tambahan di AS Timur (Virginia N.), AS Barat (Oregon), Eropa (Irlandia), Asia Pasifik (Singapura), dan Asia Pasifik (Sydney).

Add-on Amazon CloudWatch Observability EKS mengumpulkan metrik open source dari kluster Amazon EKS Anda dan mengirimkannya untuk CloudWatch menggunakan OpenTelemetry Protokol (OTLP) pada perincian 30 detik. Metrik ini menggunakan nama metrik dari sumber aslinya, termasuk cAdvisor, Prometheus Node Exporter, NVIDIA DCGM, Kube State Metrics, dan Neuron Monitor. AWS Anda dapat melakukan kueri metrik ini menggunakan PromQL di CloudWatch Query Studio atau melalui API kueri yang kompatibel dengan Prometheus.

Setiap metrik secara otomatis diperkaya dengan hingga 150 label, termasuk atribut konvensi OpenTelemetry semantik dan label pod dan node Kubernetes. PromQL menangani agregasi pada waktu kueri, sehingga setiap metrik diterbitkan satu kali per sumber daya daripada di beberapa tingkat agregasi. Add-on ini juga menghubungkan metrik akselerator dari AWS Neuron dan Adaptor Kain AWS Elastis dengan pod dan wadah tertentu yang menggunakannya, memberikan visibilitas yang tidak tersedia dari sumber metrik saja.

Untuk mengaktifkan OTel Container Insights di kluster Amazon EKS, instal versi add-on Amazon CloudWatch Observability EKS `v6.0.1-eksbuild.1` atau yang lebih baru melalui konsol Amazon EKS atau melalui infrastruktur sebagai kode.

Untuk informasi selengkapnya tentang menyiapkan OTel Container Insights, lihat. [Menyiapkan Wawasan Kontainer](deploy-container-insights.md)

Untuk informasi selengkapnya tentang kueri metrik ini dengan PromQL, lihat. [Kueri PromQL](CloudWatch-PromQL-Querying.md)

## Bagaimana OTel Container Insights dibandingkan dengan Container Insights (ditingkatkan)
<a name="container-insights-otel-comparison"></a>

Tabel berikut merangkum perbedaan antara Container Insights (ditingkatkan) dan OTel Container Insights.


| Fitur | Wawasan Kontainer (ditingkatkan) | Wawasan Kontainer OTel | 
| --- | --- | --- | 
| Nama metrik | CloudWatch-format metrik (misalnya,pod\_cpu\_utilization) | Open-source asli (misalnya,container\_cpu\_usage\_seconds\_total) | 
| Label per metrik | 3-6 dimensi yang telah ditentukan per metrik | Hingga 150 label, termasuk semua label pod dan node Kubernetes | 
| Agregasi | Pre-aggregated pada berbagai tingkatan (cluster, namespace, beban kerja, pod) | Metrik mentah per sumber daya; agregat pada waktu kueri dengan PromQL | 
| Bahasa kueri | CloudWatch Metrik API | PromQL () Prometheus-compatible | 
| Konsumsi metrik | CloudWatch Log dalam format EMF | Titik akhir OTLP | 

## Bagaimana metrik diberi label
<a name="container-insights-otel-labels"></a>

Setiap metrik yang dikumpulkan oleh OTel Container Insights membawa label dari tiga sumber.

Label asli sumber telemetri  
Label dari sumber metrik asli (misalnya, cAdvisor menyediakan label seperti`pod`,`namespace`, dan`container`). Ini dipertahankan sebagai atribut titik data.

OpenTelemetry atribut sumber daya  
Add-on menambahkan atribut resource mengikuti konvensi OpenTelemetry semantik untuk [Kubernetes](https://opentelemetry.io/docs/specs/semconv/resource/k8s/), [Host](https://opentelemetry.io/docs/specs/semconv/resource/host/), dan [Cloud](https://opentelemetry.io/docs/specs/semconv/resource/cloud/), seperti,,, dan. `k8s.pod.name` `k8s.namespace.name` `k8s.node.name` `host.name` `cloud.region` Atribut ini konsisten di semua sumber metrik.

Label pod dan node Kubernetes  
Semua label pod dan label node yang ditemukan dari Kubernetes API ditambahkan sebagai atribut resource dengan prefiks dan. `k8s.pod.label` `k8s.node.label`

Untuk informasi selengkapnya tentang cara menanyakan atribut ini menggunakan PromQL, lihat. [Kueri PromQL](CloudWatch-PromQL-Querying.md)

## Metrik yang didukung
<a name="container-insights-otel-supported-metrics"></a>

Tabel berikut mencantumkan sumber metrik dan kategori yang dikumpulkan oleh OTel Container Insights.


| Sumber metrik | Kategori metrik | Prasyarat | 
| --- | --- | --- | 
| cAdvisor | Metrik CPU | - | 
| cAdvisor | Metrik memori | - | 
| cAdvisor | Metrik jaringan | - | 
| cAdvisor | Metrik disk dan sistem file | - | 
| Prometheus Node Exportir | Metrik CPU | - | 
| Prometheus Node Exportir | Metrik memori | - | 
| Prometheus Node Exportir | Metrik disk | - | 
| Prometheus Node Exportir | Metrik sistem file | - | 
| Prometheus Node Exportir | Metrik jaringan | - | 
| Prometheus Node Exportir | Metrik sistem | - | 
| Prometheus Node Exportir | Metrik VMStat | - | 
| Prometheus Node Exportir | Metrik netstat dan soket | - | 
| NVIDIA DCGM | Pemanfaatan GPU dan metrik kinerja | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Metrik memori GPU | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Daya GPU dan metrik termal | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Metrik pelambatan GPU | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Kesalahan GPU dan metrik keandalan | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Metrik GPU NVLink | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| NVIDIA DCGM | Metrik informasi GPU | [Plugin perangkat NVIDIA](https://github.com/NVIDIA/k8s-device-plugin) [dan toolkit kontainer NVIDIA](https://github.com/NVIDIA/nvidia-container-toolkit) harus diinstal. | 
| AWS Monitor Neuron | NeuronCore metrik | [Driver neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/general/setup/neuron-setup/pytorch/neuronx/ubuntu/torch-neuronx-ubuntu22.html) [dan plugin perangkat Neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/containers/kubernetes-getting-started.html) harus diinstal. | 
| AWS Monitor Neuron | NeuronDevice metrik | [Driver neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/general/setup/neuron-setup/pytorch/neuronx/ubuntu/torch-neuronx-ubuntu22.html) [dan plugin perangkat Neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/containers/kubernetes-getting-started.html) harus diinstal. | 
| AWS Monitor Neuron | Metrik sistem neuron | [Driver neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/general/setup/neuron-setup/pytorch/neuronx/ubuntu/torch-neuronx-ubuntu22.html) [dan plugin perangkat Neuron](https://awsdocs-neuron.readthedocs-hosted.com/en/latest/containers/kubernetes-getting-started.html) harus diinstal. | 
| AWS Adaptor Kain Elastis | Metrik EFA | [Plugin perangkat EFA](https://github.com/aws/eks-charts/tree/master/stable/aws-efa-k8s-device-plugin) harus diinstal. | 
| NVMe | Metrik NVMe SMART | - | 
| Metrik Negara Bagian Kube | Pod, node, Deployment,, DaemonSet, StatefulSet, Job ReplicaSet,, Layanan CronJob, Namespace,, metrik PersistentVolume PersistentVolumeClaim  | - | 
| Server API Kubernetes | Server API dan metrik etcd | - | 

## Menonaktifkan penerbitan ganda
<a name="container-insights-otel-disable-dual-publish"></a>

Dimulai dengan versi add-on Amazon CloudWatch Observability EKS v6.0.1-eksbuild.1 atau yang lebih baru, add-on menerbitkan metrik melalui Container Insights (legacy) dan OTel Container Insights secara default. Jika Anda hanya ingin menggunakan salah satu dari ini, Anda dapat menonaktifkan yang lain.

### Nonaktifkan Wawasan Kontainer OTel
<a name="container-insights-otel-disable-otel"></a>

Untuk berhenti menerbitkan metrik OTel Container Insights dan hanya menggunakan Wawasan Kontainer lama, setel konfigurasi ke nonaktif. `otelContainerInsights`

Gunakan nilai konfigurasi berikut:

```
{"otelContainerInsights":{"enabled":false}}
```

Jalankan perintah berikut untuk menerapkan konfigurasi:

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

### Nonaktifkan Wawasan Kontainer
<a name="container-insights-otel-disable-legacy"></a>

Untuk menghentikan penerbitan metrik Wawasan Kontainer lama dan hanya menggunakan OTel Container Insights, setel konfigurasi ke nonaktif. `containerInsights`

Gunakan nilai konfigurasi berikut:

```
{"containerInsights":{"enabled":false}}
```

Jalankan perintah berikut untuk menerapkan konfigurasi:

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