Tutorial: Instal menggunakan AWS CloudFormation template inline Tutorial: Instal CloudWatch agen menggunakan AWS CloudFormation dan Parameter Store Memecahkan masalah pemasangan agen dengan CloudWatch AWS CloudFormation

Menginstal CloudWatch agen pada instance baru menggunakan AWS CloudFormation

Amazon telah mengunggah beberapa AWS CloudFormation templat GitHub untuk membantu Anda menginstal dan memperbarui CloudWatch agen pada instans Amazon EC2 baru. Untuk informasi selengkapnya tentang penggunaan AWS CloudFormation, lihat Apa itu AWS CloudFormation? .

Lokasi template adalah Menyebarkan CloudWatch agen Amazon ke instans EC2 menggunakan. AWS CloudFormation Lokasi ini mencakup direktori inline dan ssm. Setiap direktori ini berisi template untuk instans Linux dan Windows.

Template dalam inline direktori memiliki konfigurasi CloudWatch agen yang disematkan ke dalam AWS CloudFormation template. Secara bawaan, template Linux mengumpulkan metrik mem_used_percent dan swap_used_percent, dan template Windows mengumpulkan Memory % Committed Bytes In Use dan Paging File % Usage.

Untuk mengubah template ini guna mengumpulkan metrik yang berbeda, ubah bagian template berikut. Contoh berikut berasal dari template untuk server Linux. Ikuti format dan sintaksis file konfigurasi agen untuk membuat perubahan ini. Untuk informasi selengkapnya, lihat Buat atau edit file konfigurasi CloudWatch agen secara manual.
```
{
   "metrics":{
      "append_dimensions":{
         "AutoScalingGroupName":"${!aws:AutoScalingGroupName}",
         "ImageId":"${!aws:ImageId}",
         "InstanceId":"${!aws:InstanceId}",
         "InstanceType":"${!aws:InstanceType}"
      },
      "metrics_collected":{
         "mem":{
            "measurement":[
               "mem_used_percent"
            ]
         },
         "swap":{
            "measurement":[
               "swap_used_percent"
            ]
         }
      }
   }
}
```
catatan
Pada template inline, semua variabel placeholder harus memiliki tanda seru (!) sebelum mereka sebagai karakter lolos. Anda dapat melihat ini di template contoh. Jika Anda menambahkan variabel placeholder lainnya, pastikan menambahkan tanda seru di depan nama.
Templat dalam ssm direktori memuat file konfigurasi agen dari Parameter Store. Untuk menggunakan template ini, Anda harus terlebih dahulu membuat file konfigurasi dan mengunggahnya ke Parameter Store. Kemudian, Anda memberikan Parameter Store nama file dalam templat. Anda dapat membuat file konfigurasi secara manual atau dengan menggunakan pemandu. Untuk informasi selengkapnya, lihat Buat file konfigurasi CloudWatch agen.

Anda dapat menggunakan kedua jenis templat untuk menginstal CloudWatch agen dan untuk memperbarui konfigurasi agen.

Tutorial: Instal dan konfigurasikan CloudWatch agen menggunakan AWS CloudFormation template inline

Tutorial ini memandu Anda menggunakan AWS CloudFormation untuk menginstal CloudWatch agen pada instans Amazon EC2 baru. Tutorial ini melakukan instalasi pada instans baru yang menjalankan Amazon Linux 2 menggunakan template inline, yang tidak memerlukan penggunaan file konfigurasi JSON atau Parameter Store. Templat inline mencakup konfigurasi agen dalam templat. Dalam tutorial ini, Anda menggunakan konfigurasi agen default yang terkandung dalam template.

Setelah prosedur untuk memasang agen, tutorial berlanjut dengan cara memperbarui agen.

Untuk digunakan AWS CloudFormation untuk menginstal CloudWatch agen pada instance baru

Unduh template dari GitHub. Dalam tutorial ini, unduh template inline untuk Amazon Linux 2 sebagai berikut:


curl -O https://raw.githubusercontent.com/aws-cloudformation/aws-cloudformation-templates/main/Solutions/AmazonCloudWatchAgent/inline/amazon_linux.yaml

Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Pilih Create stack.
Untuk Pilih template, pilih Unggah template ke Amazon S3, pilih template yang diunduh, dan pilih Berikutnya.
Pada halaman Tentukan Detail, isilah parameter-parameter berikut dan kemudian pilih Berikutnya:
- Nama tumpukan: Pilih nama tumpukan untuk AWS CloudFormation tumpukan Anda.
- IamRole: Pilih peran IAM yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Buat peran IAM untuk digunakan dengan CloudWatch agen di instans Amazon EC2.
- InstanceAMI: Pilih AMI yang valid di Wilayah tempat Anda akan meluncurkan tumpukan Anda.
- InstanceType: Pilih jenis instance yang valid.
- KeyName: Untuk mengaktifkan akses SSH ke instans baru, pilih key pair Amazon EC2 yang sudah ada. Jika Anda belum memiliki pasangan kunci Amazon EC2, maka Anda dapat membuatnya di AWS Management Console. Untuk informasi selengkapnya, lihat Pasangan Kunci Amazon EC2 di Panduan Pengguna Amazon EC2.
- SSHLocation: Menentukan rentang alamat IP yang dapat digunakan untuk terhubung ke instans menggunakan SSH. Standar tersebut memungkinkan akses dari alamat IP mana pun.
Di halaman Opsi Anda dapat memilih untuk menandai sumber daya tumpukan Anda. Pilih Berikutnya.
Pada halamanPeninjauan, periksa informasi Anda, akui bahwa tumpukan mungkin membuat sumber daya IAM, kemudian pilih Buat.

Jika menyegarkan konsol, Anda melihat bahwa tumpukan baru memiliki CREATE_IN_PROGRESS status.
Saat instans dibuat, Anda dapat melihatnya di konsol Amazon EC2. Atau, Anda dapat terhubung ke host dan memeriksa kemajuannya.

Gunakan perintah berikut untuk mengonfirmasi bahwa agen diinstal:
```
rpm -qa amazon-cloudwatch-agent
```
Gunakan perintah berikut untuk mengonfirmasi bahwa agen menjalankan:
```
ps aux | grep amazon-cloudwatch-agent
```

Prosedur selanjutnya menunjukkan penggunaan AWS CloudFormation untuk memperbarui CloudWatch agen menggunakan template inline. Templat inline bawaan mengumpulkan mem_used_percent metrik. Dalam tutorial ini, Anda mengubah konfigurasi agen untuk berhenti mengumpulkan metrik tersebut.

Untuk digunakan AWS CloudFormation untuk memperbarui CloudWatch agen

Dalam template yang Anda unduh dalam prosedur sebelumnya, hapus baris berikut lalu simpan template:



"mem": {
                        
     "measurement": [
         "mem_used_percent"
       ]
 },

Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Di AWS CloudFormation dasbor, pilih tumpukan yang Anda buat dan pilih Update Stack.
Untuk Pilih Template, pilih Unggah template ke Amazon S3, pilih template yang Anda ubah, dan pilih Berikutnya.
Pada halaman Option, pilih Berikutnya dan kemudian Berikutnya.
Pada halaman Review, periksa informasi Anda dan pilih Update.

Setelah beberapa saat, Anda akan melihat UPDATE_COMPLETE.

Tutorial: Instal CloudWatch agen menggunakan AWS CloudFormation dan Parameter Store

Tutorial ini memandu Anda menggunakan AWS CloudFormation untuk menginstal CloudWatch agen pada instans Amazon EC2 baru. Tutorial ini melakukan instalasi di instans baru yang menjalankan Amazon Linux 2 menggunakan file konfigurasi agen yang Anda buat dan simpan di Parameter Store.

Setelah prosedur untuk menginstal agen, tutorial berlanjut dengan cara memperbarui agen.

Untuk menggunakan AWS CloudFormation untuk menginstal CloudWatch agen pada instance baru menggunakan konfigurasi dari Parameter Store

Jika Anda belum melakukannya, unduh paket CloudWatch agen ke salah satu komputer Anda sehingga Anda dapat membuat file konfigurasi agen. Untuk informasi selengkapnya dan mengunduh agen menggunakan Parameter Store, silakan lihat Unduh dan konfigurasikan CloudWatch agen. Untuk informasi selengkapnya tentang mengunduh paket menggunakan baris perintah, silakan lihat Unduh dan konfigurasikan CloudWatch agen menggunakan baris perintah.
Buat file konfigurasi agen dan simpan di Parameter Store. Untuk informasi selengkapnya, lihat Buat file konfigurasi CloudWatch agen.

Unduh template dari GitHub sebagai berikut:


curl -O https://raw.githubusercontent.com/awslabs/aws-cloudformation-templates/master/aws/solutions/AmazonCloudWatchAgent/ssm/amazon_linux.template

Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Pilih Create stack.
Untuk Pilih template, pilih Unggah template ke Amazon S3, pilih template yang Anda unduh, lalu pilih Berikutnya.
Pada halaman Tentukan Detail, isilah parameter-parameter berikut dengan sesuai dan pilih Berikutnya:
- Nama tumpukan: Pilih nama tumpukan untuk AWS CloudFormation tumpukan Anda.
- IamRole: Pilih peran IAM yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Buat peran IAM untuk digunakan dengan CloudWatch agen di instans Amazon EC2.
- InstanceAMI: Pilih AMI yang valid di Wilayah tempat Anda akan meluncurkan tumpukan Anda.
- InstanceType: Pilih jenis instance yang valid.
- KeyName: Untuk mengaktifkan akses SSH ke instans baru, pilih key pair Amazon EC2 yang sudah ada. Jika Anda belum memiliki pasangan kunci Amazon EC2, maka Anda dapat membuatnya di AWS Management Console. Untuk informasi selengkapnya, lihat Pasangan Kunci Amazon EC2 di Panduan Pengguna Amazon EC2.
- SSHLocation: Menentukan rentang alamat IP yang dapat digunakan untuk terhubung ke instans menggunakan SSH. Standar tersebut memungkinkan akses dari alamat IP mana pun.
- SSMKey: Menentukan file konfigurasi agen yang Anda buat dan simpan di Parameter Store.
Di halaman Opsi Anda dapat memilih untuk menandai sumber daya tumpukan Anda. Pilih Berikutnya.
Pada halamanPeninjauan, periksa informasi Anda, akui bahwa tumpukan mungkin membuat sumber daya IAM, kemudian pilih Buat.

Jika menyegarkan konsol, Anda melihat bahwa tumpukan baru memiliki CREATE_IN_PROGRESS status.
Saat instans dibuat, Anda dapat melihatnya di konsol Amazon EC2. Atau, Anda dapat terhubung ke host dan memeriksa kemajuannya.

Gunakan perintah berikut untuk mengonfirmasi bahwa agen diinstal:
```
rpm -qa amazon-cloudwatch-agent
```
Gunakan perintah berikut untuk mengonfirmasi bahwa agen menjalankan:
```
ps aux | grep amazon-cloudwatch-agent
```

Prosedur selanjutnya menunjukkan penggunaan AWS CloudFormation untuk memperbarui CloudWatch agen, menggunakan konfigurasi agen yang Anda simpan di Parameter Store.

Untuk digunakan AWS CloudFormation untuk memperbarui CloudWatch agen menggunakan konfigurasi di Parameter Store

Ubah file konfigurasi agen yang disimpan di Parameter Store ke konfigurasi baru yang Anda inginkan.
Di AWS CloudFormation templat yang Anda unduh dalam Tutorial: Instal CloudWatch agen menggunakan AWS CloudFormation dan Parameter Store topik, ubah nomor versi. Misalnya, Anda mungkin mengubah VERSION=1.0 untuk VERSION=2.0.
Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Di AWS CloudFormation dasbor, pilih tumpukan yang Anda buat dan pilih Update Stack.
Untuk Memilih Template, pilih Unggah template ke Amazon S3, pilih template yang baru saja Anda modifikasi, dan pilih Berikutnya.
Pada halaman Option, pilih Berikutnya dan kemudian Berikutnya.
Pada halaman Review, periksa informasi Anda dan pilih Update.

Setelah beberapa saat, Anda akan melihat UPDATE_COMPLETE.

Memecahkan masalah pemasangan agen dengan CloudWatch AWS CloudFormation

Bagian ini membantu Anda memecahkan masalah dengan menginstal dan memperbarui CloudWatch agen menggunakan. AWS CloudFormation

Mendeteksi saat ada pembaruan yang mengalami kegagalan

Jika Anda menggunakannya AWS CloudFormation untuk memperbarui konfigurasi CloudWatch agen, dan menggunakan konfigurasi yang tidak valid, agen akan berhenti mengirim metrik apa pun. CloudWatch Cara cepat untuk memeriksa apakah pembaruan konfigurasi agen berhasil adalah dengan melihat file cfn-init-cmd.log. Pada server Linux, file tersebut terletak di /var/log/cfn-init-cmd.log. Pada instans Windows, file tersebut terletak di C:\cfn\log\cfn-init-cmd.log.

Metrik tidak ada

Jika Anda tidak melihat metrik yang Anda harapkan untuk dilihat setelah melakukan instalasi atau memperbarui agen, pastikan bahwa agen dikonfigurasi untuk mengumpulkan metrik tersebut. Untuk melakukan hal itu, periksa amazon-cloudwatch-agent.json untuk memastikan bahwa metrik dicantumkan, dan periksa bahwa Anda mencari di namespace metrik yang benar. Untuk informasi selengkapnya, lihat CloudWatch file dan lokasi agen.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menginstal CloudWatch agen di server lokal

CloudWatch preferensi kredensial agen