View a markdown version of this page

Menyebarkan AWS Distro OpenTelemetry untuk mengumpulkan metrik tingkat instance EC2 di cluster Amazon ECS - Amazon CloudWatch

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

Menyebarkan AWS Distro OpenTelemetry untuk mengumpulkan metrik tingkat instance EC2 di cluster Amazon ECS

Gunakan langkah-langkah di bagian ini untuk menggunakan AWS Distro for OpenTelemetry untuk mengumpulkan metrik tingkat instance EC2 pada cluster Amazon ECS. Untuk informasi lebih lanjut tentang AWS Distro untuk OpenTelemetry, lihat AWS Distro 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 menggunakan AWS Distro for Open Telemetry dengan Amazon ECS dan menyiapkan cluster Amazon ECS untuk tujuan ini, lihat Men yiapkan AWS Distro for OpenTelemetry Collector di Amazon Elastic Container Service untuk metrik tingkat instans ECS EC2.

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

  • Cluster_Name— Nama cluster Amazon ECS

  • AWS_Region– Wilayah tempat data nanti akan dikirim

  • PATH_TO_ CloudFormation _TEMPLATE - Jalur tempat Anda menyimpan file template. CloudFormation

  • perintah — Untuk mengaktifkan AWS Distro for OpenTelemetry kolektor untuk mengumpulkan metrik tingkat instance 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 tumpu CloudFormation kan, 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 Logs untuk memeriksa log agen. Cari aws/ecs //containerinsights/{} ClusterName /grup log kinerja.

Konfigurasi manual dan kustom

Ikuti langkah-langkah di bagian ini untuk menerapkan AWS Distro secara manual OpenTelemetry untuk mengumpulkan metrik tingkat instance dari cluster 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 petunjuk di Buat Definisi Tugas ECS EC2 untuk instans EC2 dengan AWS OtEL Collector.

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

Langkah 3: Meluncurkan layanan daemon

Untuk meluncurkan AWS Distro OpenTelemetry sebagai layanan daemon, ikuti petunjuk di J alankan tugas Anda di Amazon Elastic Container Service (Amazon ECS) menggunakan layanan daemon.

(Opsional) Konfigurasi lanjutan

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