Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Terapkan Wawasan Kontainer yang Ditingkatkan (Klasik) dengan CloudFormation atau Helm
Anda dapat menerapkan Enhanced Container Insights (Classic) sebagai infrastruktur sebagai kode dengan menggunakan CloudFormation templat atau bagan Helm. Pendekatan ini menginstal `amazon-cloudwatch-observability` add-on dengan versi sebelum v6.2.0 untuk mengaktifkan pipeline metrik Klasik. Pilih pendekatan ini jika Anda mengelola cluster melalui saluran pipa IAC dan menginginkan penerapan yang dapat diulang dan dikendalikan versi.
**Rekomendasi**
Untuk penerapan baru, kami sarankan[Wawasan Kontainer OTel (Direkomendasikan)](container-insights-eks-otel.md), yang menggunakan add-on versi 6.2.0 atau yang lebih baru dengan pipeline. OTel-based
## Prasyarat
Sebelum Anda menerapkan Enhanced Container Insights (Classic) dengan CloudFormation atau Helm, verifikasi bahwa Anda memenuhi persyaratan berikut.
+ Cluster Amazon EKS yang sudah ada yang menjalankan Kubernetes versi 1.25 atau yang lebih baru
+ AWS CLI versi 2.12.0 atau yang lebih baru
+ `kubectl`dikonfigurasi untuk berkomunikasi dengan cluster target Anda
+ Izin IAM untuk pembuatan CloudFormation tumpukan (untuk metode) CloudFormation
+ Helm v3.8 atau yang lebih baru (untuk metode Helm)
+ Akses internet keluar dari cluster ke titik akhir CloudWatch
## Menyebarkan dengan CloudFormation
Gunakan CloudFormation template untuk menerapkan add-on CloudWatch Observability dengan konfigurasi Classic. Template ini menggunakan `AWS::EKS::Addon` sumber daya untuk menginstal add-on dengan versi sebelum v6.2.0.
### CloudFormation templat
Template berikut membuat resource yang Anda perlukan untuk mengaktifkan Enhanced Container Insights (Classic) di klaster Amazon EKS Anda.
```
AWSTemplateFormatVersion: '2010-09-09'
Description: Deploy Enhanced Container Insights (Classic) on an EKS cluster
Parameters:
ClusterName:
Type: String
Description: The name of your EKS cluster
Resources:
CloudWatchAgentRole:
Type: AWS::IAM::Role
Properties:
RoleName: EKS-CloudWatch-Agent-Role
AssumeRolePolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Principal:
Service: pods.eks.amazonaws.com
Action:
- sts:AssumeRole
- sts:TagSession
ManagedPolicyArns:
- arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy
PodIdentityAssociation:
Type: AWS::EKS::PodIdentityAssociation
Properties:
ClusterName: !Ref ClusterName
Namespace: amazon-cloudwatch
ServiceAccount: cloudwatch-agent
RoleArn: !GetAtt CloudWatchAgentRole.Arn
CloudWatchObservabilityAddon:
Type: AWS::EKS::Addon
DependsOn: PodIdentityAssociation
Properties:
ClusterName: !Ref ClusterName
AddonName: amazon-cloudwatch-observability
AddonVersion: v5.4.0-eksbuild.1
ServiceAccountRoleArn: !GetAtt CloudWatchAgentRole.Arn
ResolveConflicts: OVERWRITE
```
Template ini menciptakan sumber daya berikut:
+ Peran IAM dengan kebijakan `CloudWatchAgentServerPolicy` terkelola terlampir
+ Asosiasi Identitas Pod EKS yang memetakan peran ke akun layanan CloudWatch agen
+ Pengaya `amazon-cloudwatch-observability` EKS dengan versi Klasik (sebelum v6.2.0)
### Untuk menyebarkan CloudFormation tumpukan
Gunakan AWS CLI untuk membuat CloudFormation tumpukan dari template.
**Untuk menyebarkan tumpukan**
1. Simpan template sebelumnya ke file bernama. `classic-container-insights.yaml`
1. Jalankan perintah berikut. Ganti {{cluster-name}} dengan nama cluster Amazon EKS Anda.
```
aws cloudformation create-stack \
--stack-name classic-container-insights \
--template-body file://classic-container-insights.yaml \
--parameters ParameterKey=ClusterName,ParameterValue={{cluster-name}} \
--capabilities CAPABILITY_NAMED_IAM
```
1. Tunggu pembuatan tumpukan selesai.
```
aws cloudformation wait stack-create-complete \
--stack-name classic-container-insights
```
1. Verifikasi bahwa status tumpukan adalah`CREATE_COMPLETE`.
```
aws cloudformation describe-stacks \
--stack-name classic-container-insights \
--query "Stacks[0].StackStatus" \
--output text
```
## Menyebarkan dengan Helm
Gunakan bagan Helm untuk menerapkan Enhanced Container Insights (Classic) jika Anda mengelola beban kerja Kubernetes dengan Helm. Bagan menginstal operator CloudWatch Observability dengan pipeline metrik Klasik.
**catatan**
Ketika Anda menggunakan Helm, Anda harus membuat peran IAM dan asosiasi Pod Identity secara terpisah. Bagan Helm hanya menginstal sumber daya Kubernetes.
### Langkah 1: Buat peran IAM
Buat peran IAM untuk CloudWatch agen sebelum Anda menginstal bagan Helm.
**Untuk membuat peran IAM dan asosiasi Pod Identity**
1. Jalankan perintah berikut untuk membuat peran dengan kebijakan kepercayaan untuk EKS Pod Identity.
```
aws iam create-role \
--role-name EKS-CloudWatch-Agent-Role \
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": { "Service": "pods.eks.amazonaws.com" },
"Action": ["sts:AssumeRole", "sts:TagSession"]
}]
}'
```
1. Lampirkan kebijakan yang `CloudWatchAgentServerPolicy` dikelola ke peran.
```
aws iam attach-role-policy \
--role-name EKS-CloudWatch-Agent-Role \
--policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy
```
1. Buat asosiasi Pod Identity. Ganti {{cluster-name}} dengan nama cluster Amazon EKS Anda dan {{account-id}} dengan ID AWS akun Anda.
```
aws eks create-pod-identity-association \
--cluster-name {{cluster-name}} \
--namespace amazon-cloudwatch \
--service-account cloudwatch-agent \
--role-arn arn:aws:iam::{{account-id}}:role/EKS-CloudWatch-Agent-Role
```
### Langkah 2: Instal bagan Helm
Instal bagan CloudWatch Observability Helm dengan versi Klasik (sebelum v6.2.0).
**Untuk menginstal bagan Helm**
1. Jalankan perintah berikut. Ganti {{cluster-name}} dengan nama cluster Amazon EKS Anda dan {{region}} dengan AWS Wilayah Anda.
```
helm install amazon-cloudwatch-observability \
oci://public.ecr.aws/cloudwatch-agent/amazon-cloudwatch-observability-helm-chart \
--namespace amazon-cloudwatch \
--create-namespace \
--set clusterName={{cluster-name}} \
--set region={{region}} \
--version 5.4.0
```
1. Verifikasi bahwa rilis Helm berhasil diterapkan.
```
helm list -n amazon-cloudwatch
```
Status harus ditunjukkan`deployed`.
## Verifikasi penyebaran
Setelah pembuatan CloudFormation tumpukan atau instalasi Helm selesai, verifikasi bahwa add-on sedang berjalan dan mengirim data ke. CloudWatch
**Untuk memverifikasi penyebaran**
1. Konfirmasikan bahwa pod CloudWatch agen sedang berjalan.
```
kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent
```
Semua pod harus menunjukkan `Running` status.
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Pada panel navigasi, silakan pilih **Metrik**, dan kemudian pilih **Semua metrik**.
1. Verifikasi bahwa metrik muncul di `ContainerInsights` namespace untuk klaster Anda.
Metrik biasanya muncul CloudWatch dalam waktu 3 hingga 5 menit setelah penerapan selesai.
## Langkah selanjutnya
Setelah menerapkan Enhanced Container Insights (Classic), Anda dapat menjelajahi topik-topik berikut.
+ Untuk pengaturan berbasis konsol, lihat. [Aktifkan Wawasan Kontainer yang Ditingkatkan (Klasik) dari konsol](container-insights-eks-classic-console.md)
+ Untuk pengaturan AWS CLI berbasis, lihat[Panduan pengaturan (AWS CLI)](container-insights-eks-classic-setup.md).
+ Untuk informasi tentang metrik yang dikumpulkan Enhanced Container Insights (Classic), lihat. [Referensi metrik Wawasan Kontainer yang Ditingkatkan (Klasik)](container-insights-eks-classic-metrics.md)
+ Untuk bermigrasi ke OTel Container Insights, lihat. [Bermigrasi dari Enhanced Container Insights (Classic) ke OTel Container Insights](container-insights-eks-migrate-from-classic.md)
+ Untuk informasi selengkapnya tentang OTel Container Insights, lihat. [Wawasan Kontainer OTel (Direkomendasikan)](container-insights-eks-otel.md)