Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menerapkan AWS Distro OpenTelemetry untuk mengumpulkan metrik tingkat instans EC2 di kluster Amazon ECS
Gunakan langkah-langkah di bagian ini untuk menggunakan AWS Distro OpenTelemetry untuk mengumpulkan metrik tingkat instans EC2 di klaster Amazon ECS. Untuk informasi selengkapnya tentang AWS Distro OpenTelemetry, lihat [AWS Distro](https://aws.amazon.com/otel/) untuk. OpenTelemetry
Langkah-langkah ini mengasumsikan Anda sudah memiliki sebuah klaster yang menjalankan Amazon ECS. Klaster ini harus di-deploy dengan tipe peluncuran EC2. Untuk informasi selengkapnya tentang penggunaan AWS Distro untuk Open Telemetry dengan Amazon ECS dan menyiapkan klaster Amazon ECS untuk tujuan ini, lihat [Menyiapkan AWS Distro untuk OpenTelemetry Kolektor di Amazon Elastic Container Service untuk](https://aws-otel.github.io/docs/setup/ecs#3-setup-the-aws-otel-collector-for-ecs-ec2-instance-metrics) metrik tingkat instans ECS EC2.
**Topics**
+ [
## Pengaturan cepat menggunakan CloudFormation
](#container-insights-ECS-OTEL-quicksetup)
+ [
## Konfigurasi manual dan kustom
](#container-insights-ECS-OTEL-custom)
## Pengaturan cepat menggunakan CloudFormation
Unduh file CloudFormation template untuk menginstal AWS Distro untuk OpenTelemetry kolektor untuk Amazon ECS di EC2. Jalankan perintah curl berikut.
```
curl -O https://raw.githubusercontent.com/aws-observability/aws-otel-collector/main/deployment-template/ecs/aws-otel-ec2-instance-metrics-daemon-deployment-cfn.yaml
```
Setelah Anda mengunduh file template, buka dan ganti *PATH\$1TO\$1CloudFormation\$1TEMPLATE* dengan jalur tempat Anda menyimpan file template. Kemudian ekspor parameter berikut dan jalankan CloudFormation perintah, seperti yang ditunjukkan pada perintah berikut.
+ **Cluster\$1Name**– Nama klaster Amazon ECS
+ **AWS\$1Region** — Wilayah tempat data akan dikirim
+ **PATH\$1TO\$1 CloudFormation \$1TEMPLATE** - Jalur tempat Anda menyimpan file template. CloudFormation
+ **perintah** — Untuk mengaktifkan AWS Distro for OpenTelemetry collector untuk mengumpulkan metrik tingkat instans untuk Amazon ECS di Amazon EC2, Anda harus menentukan parameter ini. `--config=/etc/ecs/otel-instance-metrics-config.yaml`
```
ClusterName=Cluster_Name
Region=AWS_Region
command=--config=/etc/ecs/otel-instance-metrics-config.yaml
aws cloudformation create-stack --stack-name AOCECS-${ClusterName}-${Region} \
--template-body file://PATH_TO_CloudFormation_TEMPLATE \
--parameters ParameterKey=ClusterName,ParameterValue=${ClusterName} \
ParameterKey=CreateIAMRoles,ParameterValue=True \
ParameterKey=command,ParameterValue=${command} \
--capabilities CAPABILITY_NAMED_IAM \
--region ${Region}
```
Setelah menjalankan perintah ini, Anda harus menggunakan konsol Amazon ECS untuk melihat apakah tugas sedang berjalan, atau tidak.
### Pemecahan masalah pengaturan cepat
Untuk memeriksa status CloudFormation tumpukan, masukkan perintah berikut.
```
ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stack --stack-name AOCECS-$ClusterName-$Region --region $Region
```
Jika nilai dari `StackStatus` bukan `CREATE_COMPLETE` atau `CREATE_IN_PROGRESS`, maka Anda harus memeriksa peristiwa-peristiwa tumpukan untuk menemukan kesalahannya. Masukkan perintah berikut.
```
ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stack-events --stack-name AOCECS-$ClusterName-$Region --region $Region
```
Untuk memeriksa status dari layanan daemon `AOCECS`, Anda harus memasukkan perintah berikut. Dalam outputnya, Anda akan melihat bahwa `runningCount` sama dengan `desiredCount` di bagian deployment. Jika tidak sama, periksa bagian kegagalan yang ada di output tersebut.
```
ClusterName=cluster-name
Region=cluster-region
aws ecs describe-services --services AOCECS-daemon-service --cluster $ClusterName --region $Region
```
Anda juga dapat menggunakan konsol CloudWatch Log untuk memeriksa log agen. Cari grup**/aws/ecs/containerinsights/\$1ClusterName\$1/performance**log.
## Konfigurasi manual dan kustom
Ikuti langkah-langkah di bagian ini untuk menerapkan AWS Distro secara manual OpenTelemetry untuk mengumpulkan metrik tingkat instans dari kluster Amazon ECS yang dihosting di instans Amazon EC2.
### Langkah 1: Peran dan kebijakan yang diperlukan
Ada dua peran IAM yang diperlukan. Anda harus membuat dua peran ini jika belum ada. Untuk informasi selengkapnya tentang peran-peran ini, silakan lihat [Membuat kebijakan IAM](https://aws-otel.github.io/docs/setup/ecs/create-iam-policy) dan [Membuat peran IAM](https://aws-otel.github.io/docs/setup/ecs/create-iam-role).
### Langkah 2: Membuat penetapan tugas
Buat definisi tugas dan gunakan untuk meluncurkan AWS Distro OpenTelemetry sebagai layanan daemon.
Untuk menggunakan template definisi tugas untuk membuat definisi tugas, ikuti petunjuk di [Buat Definisi Tugas EC2 ECS untuk instans EC2 dengan Collector](https://aws-otel.github.io/docs/setup/ecs/task-definition-for-ecs-ec2-instance). AWS OTel
Untuk menggunakan konsol Amazon ECS untuk membuat definisi tugas, ikuti petunjuk di [Install AWS OTel Collector dengan membuat Definisi Tugas melalui AWS konsol untuk metrik instans Amazon ECS EC2](https://aws-otel.github.io/docs/setup/ecs/create-task-definition-instance-console).
### Langkah 3: Meluncurkan layanan daemon
Untuk meluncurkan layanan AWS Distro for OpenTelemetry as a daemon, ikuti petunjuk di [Jalankan tugas Anda di Amazon Elastic Container Service (Amazon ECS) Container Service (Amazon ECS) menggunakan layanan daemon](https://aws-otel.github.io/docs/setup/ecs/run-daemon-service).
### (Opsional) Konfigurasi lanjutan
Secara opsional, Anda dapat menggunakan SSM untuk menentukan opsi konfigurasi lain untuk AWS Distro untuk di kluster Amazon ECS OpenTelemetry Anda yang di-host di instans Amazon EC2. Untuk informasi selengkapnya, tentang membuat file konfigurasi, lihat [ OpenTelemetry Konfigurasi Kustom](https://aws-otel.github.io/docs/setup/ecs#5-custom-opentelemetry-configuration). Untuk informasi selengkapnya tentang opsi-opsi yang dapat Anda gunakan dalam file konfigurasi tersebut, silakan lihat [Penerima Wawasan Kontainer AWS](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/awscontainerinsightreceiver/README.md).