Menerapkan AWS Distro OpenTelemetry untuk mengumpulkan metrik EC2 tingkat instans di kluster Amazon ECS

Gunakan langkah-langkah di bagian ini untuk menggunakan AWS Distro OpenTelemetry untuk mengumpulkan metrik EC2 tingkat instans di klaster Amazon ECS. Untuk informasi lebih lanjut tentang AWS Distro OpenTelemetry, lihat AWS Distro untuk. OpenTelemetry

Langkah-langkah ini mengasumsikan Anda sudah memiliki sebuah klaster yang menjalankan Amazon ECS. Cluster ini harus digunakan dengan tipe EC2 peluncuran. 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 metrik tingkat instans ECS. EC2

Pengaturan cepat menggunakan AWS CloudFormation

Unduh file AWS 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_TO_CloudFormation_TEMPLATE dengan jalur tempat Anda menyimpan file template. Kemudian ekspor parameter berikut dan jalankan AWS CloudFormation perintah, seperti yang ditunjukkan pada perintah berikut.

• Cluster_Name– Nama klaster Amazon ECS

• AWS_Region — Wilayah tempat data akan dikirim

• PATH_TO_ CloudFormation _TEMPLATE - Jalur tempat Anda menyimpan file template. AWS 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 AWS 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/{ClusterName}/performancelog.

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 Anda 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 dan Membuat peran IAM.

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 instruksi di Buat Definisi EC2 Tugas ECS EC2 misalnya dengan AWS OTel Kolektor.

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 EC2 instans Amazon ECS.

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.

(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 dihosting di instans Amazon. EC2 Untuk informasi selengkapnya, tentang membuat file konfigurasi, lihat OpenTelemetry Konfigurasi Kustom. Untuk informasi selengkapnya tentang opsi-opsi yang dapat Anda gunakan dalam file konfigurasi tersebut, silakan lihat Penerima Wawasan Kontainer AWS.