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

Instal CloudWatch agen pada instance baru menggunakan CloudFormation

Bagian ini menjelaskan cara menginstal CloudWatch agen pada EC2 instans Amazon baru menggunakan AWS CloudFormation.

catatan

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

Lokasi template adalah Menyebarkan CloudWatch agen Amazon ke EC2 instance yang menggunakan. 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 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.

Untuk informasi tentang pengaturan agen pada sistem yang mengaktifkan Linux (SELinux) yang disempurnakan keamanan, lihat. Siapkan CloudWatch agen dengan Linux yang disempurnakan keamanan () SELinux

Tutorial: Instal dan konfigurasikan CloudWatch agen menggunakan CloudFormation template inline

Tutorial ini memandu Anda menggunakan CloudFormation untuk menginstal CloudWatch agen pada EC2 instance Amazon 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 menginstal agen, tutorial berlanjut dengan cara memperbarui agen.

Untuk digunakan 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 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 CloudFormation tumpukan Anda.
- IAMRole: Pilih peran IAM yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Prasyarat.
- 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 EC2 key pair Amazon yang sudah ada. Jika Anda belum memiliki EC2 key pair Amazon, Anda dapat membuatnya di Konsol Manajemen AWS. Untuk informasi selengkapnya, lihat Pasangan EC2 Kunci Amazon di Panduan EC2 Pengguna Amazon.
- SSHLocation: Menentukan rentang alamat IP yang dapat digunakan untuk terhubung ke instance 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 instance dibuat, Anda dapat melihatnya di EC2 konsol Amazon. 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 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 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 CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Di 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 CloudFormation dan Parameter Store

Tutorial ini memandu Anda menggunakan CloudFormation untuk menginstal CloudWatch agen pada EC2 instance Amazon 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 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 paket CloudWatch agen.
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 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 CloudFormation tumpukan Anda.
- IAMRole: Pilih peran IAM yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Prasyarat.
- 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 EC2 key pair Amazon yang sudah ada. Jika Anda belum memiliki EC2 key pair Amazon, Anda dapat membuatnya di Konsol Manajemen AWS. Untuk informasi selengkapnya, lihat Pasangan EC2 Kunci Amazon di Panduan EC2 Pengguna Amazon.
- SSHLocation: Menentukan rentang alamat IP yang dapat digunakan untuk terhubung ke instance 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 instance dibuat, Anda dapat melihatnya di EC2 konsol Amazon. 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 CloudFormation untuk memperbarui CloudWatch agen, menggunakan konfigurasi agen yang Anda simpan di Parameter Store.

Untuk digunakan 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 CloudFormation templat yang Anda unduh dalam Tutorial: Instal CloudWatch agen menggunakan CloudFormation dan Parameter Store topik, ubah nomor versi. Misalnya, Anda mungkin mengubah VERSION=1.0 untuk VERSION=2.0.
Buka CloudFormation konsol di https://console.aws.amazon.com/cloudformation.
Di 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 CloudFormation

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

Mendeteksi saat ada pembaruan yang mengalami kegagalan

Jika Anda menggunakannya CloudFormation untuk memperbarui konfigurasi CloudWatch agen Anda, 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

Instal CloudWatch agen di server lokal

Instal CloudWatch agen dengan add-on Amazon CloudWatch Observability EKS atau bagan Helm