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

Instal CloudWatch agen pada instance baru menggunakan AWS CloudFormation

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

catatan

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

Lokasi template adalah Menyebarkan CloudWatch agen Amazon ke EC2 instance yang 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 EC2 instance Amazon baru. Tutorial ini menginstal pada instance baru yang menjalankan Amazon Linux 2 menggunakan templat inline, yang tidak memerlukan penggunaan file JSON konfigurasi 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 IAM peran yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Buat IAM peran untuk digunakan dengan CloudWatch agen di EC2 instans Amazon.
- Instance AMI: Pilih AMI yang valid di Wilayah tempat Anda akan meluncurkan tumpukan Anda.
- InstanceType: Pilih jenis instance yang valid.
- KeyName: Untuk mengaktifkan SSH akses ke instans baru, pilih EC2 key pair Amazon yang sudah ada. Jika Anda belum memiliki EC2 key pair Amazon, Anda dapat membuatnya di AWS Management Console. 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 menggunakanSSH. Standar tersebut memungkinkan akses dari alamat IP mana pun.
Di halaman Opsi Anda dapat memilih untuk menandai sumber daya tumpukan Anda. Pilih Berikutnya.
Pada halaman Tinjauan, tinjau informasi Anda, akui bahwa tumpukan dapat membuat IAM sumber daya, lalu 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 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 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 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, konfigurasikan, dan jalankan CloudWatch agen menggunakan SSM. 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 IAM peran yang memiliki izin untuk menulis CloudWatch metrik, log, dan jejak. Untuk informasi selengkapnya, lihat Buat IAM peran untuk digunakan dengan CloudWatch agen di EC2 instans Amazon.
- Instance AMI: Pilih AMI yang valid di Wilayah tempat Anda akan meluncurkan tumpukan Anda.
- InstanceType: Pilih jenis instance yang valid.
- KeyName: Untuk mengaktifkan SSH akses ke instans baru, pilih EC2 key pair Amazon yang sudah ada. Jika Anda belum memiliki EC2 key pair Amazon, Anda dapat membuatnya di AWS Management Console. 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 menggunakanSSH. 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 halaman Tinjauan, tinjau informasi Anda, akui bahwa tumpukan dapat membuat IAM sumber daya, lalu 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 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

Instal CloudWatch agen di server lokal

CloudWatch preferensi kredensi agen