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 untuk OpenTelemetry, lihat AWS Distro untuk. OpenTelemetry

Langkah-langkah ini mengasumsikan bahwa Anda sudah memiliki cluster yang menjalankan AmazonECS. Cluster ini harus digunakan dengan tipe EC2 peluncuran. Untuk informasi selengkapnya tentang penggunaan AWS Distro untuk Telemetri Terbuka dengan Amazon ECS dan menyiapkan ECS klaster Amazon untuk tujuan ini, lihat Menyiapkan AWS Distro untuk Kolektor OpenTelemetry di Amazon Elastic Container Service untuk ECS EC2 metrik level misalnya.

Pengaturan cepat menggunakan AWS CloudFormation

Unduh file AWS CloudFormation template untuk menginstal AWS Distro untuk OpenTelemetry kolektor untuk Amazon ECS diEC2. 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 cluster Amazon ECS

• AWS_Region — Wilayah tempat data akan dikirim

• PATH_TO_ CloudFormation _ TEMPLATE — Jalur tempat Anda menyimpan file AWS CloudFormation template.

• perintah — Untuk mengaktifkan AWS Distro for OpenTelemetry collector untuk mengumpulkan metrik tingkat instance untuk Amazon di ECS AmazonEC2, 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, gunakan ECS konsol Amazon untuk melihat apakah tugas sedang berjalan.

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 ECS kluster Amazon yang dihosting di instans Amazon. EC2

Langkah 1: Peran dan kebijakan yang diperlukan

Diperlukan dua IAM peran. Anda harus membuat dua peran ini jika belum ada. Untuk informasi selengkapnya tentang peran ini, lihat Membuat IAM kebijakan dan Membuat IAM peran.

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

Untuk menggunakan ECS konsol Amazon untuk membuat definisi tugas, ikuti petunjuk di Install AWS OTel Collector dengan membuat Definisi Tugas melalui AWS konsol untuk metrik ECS EC2 instans Amazon.

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 (AmazonECS) menggunakan layanan daemon.

(Opsional) Konfigurasi lanjutan

Secara opsional, Anda dapat menggunakan SSM untuk menentukan opsi konfigurasi lain untuk AWS Distro untuk OpenTelemetry di ECS kluster Amazon 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.