Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal CloudWatch agen pada instance baru menggunakan CloudFormation
Bagian ini menjelaskan cara menginstal CloudWatch agen pada instans Amazon EC2 baru menggunakan. AWS CloudFormation
**catatan**
Amazon mengunggah beberapa CloudFormation templat GitHub yang dapat membantu Anda menginstal dan memperbarui CloudWatch agen pada instans Amazon EC2 baru. Untuk informasi selengkapnya tentang penggunaan CloudFormation, lihat [Apa itu AWS CloudFormation?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) .
Lokasi template adalah [Menyebarkan CloudWatch agen Amazon ke instans EC2](https://github.com/aws-cloudformation/aws-cloudformation-templates/tree/main/Solutions/AmazonCloudWatchAgent) 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](CloudWatch-Agent-Configuration-File-Details.md).
```
{
"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 (\$1) 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](create-cloudwatch-agent-configuration-file.md).
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](CloudWatch-Agent-SELinux.md)
## Tutorial: Instal dan konfigurasikan CloudWatch agen menggunakan CloudFormation template inline
Tutorial ini memandu Anda menggunakan 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 menginstal agen, tutorial berlanjut dengan cara memperbarui agen.
**Untuk digunakan CloudFormation untuk menginstal CloudWatch agen pada instance baru**
1. 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
```
1. Buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Pilih **Create stack**.
1. Untuk **Pilih template**, pilih **Unggah template ke Amazon S3**, pilih template yang diunduh, dan pilih **Berikutnya**.
1. 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](prerequisites.md).
+ **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 Konsol Manajemen AWS. Untuk informasi selengkapnya, lihat [Pasangan Kunci Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) di Panduan Pengguna *Amazon EC2*.
+ **SSHLocation**: Menentukan rentang alamat IP yang dapat digunakan untuk terhubung ke instance menggunakan SSH. Standar tersebut memungkinkan akses dari alamat IP mana pun.
1. Di halaman **Opsi** Anda dapat memilih untuk menandai sumber daya tumpukan Anda. Pilih **Berikutnya**.
1. Pada halaman**Peninjauan**, 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.
1. 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 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**
1. Dalam template yang Anda unduh dalam prosedur sebelumnya, hapus baris berikut lalu simpan template:
```
"mem": {
"measurement": [
"mem_used_percent"
]
},
```
1. Buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Di CloudFormation dasbor, pilih tumpukan yang Anda buat dan pilih **Update Stack**.
1. Untuk **Pilih Template**, pilih **Unggah template ke Amazon S3**, pilih template yang Anda ubah, dan pilih **Berikutnya**.
1. Pada halaman **Option**, pilih **Berikutnya** dan kemudian **Berikutnya**.
1. 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 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 CloudFormation untuk menginstal CloudWatch agen pada instance baru menggunakan konfigurasi dari Parameter Store**
1. 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](download-CloudWatch-Agent-on-EC2-Instance-commandline-first.md).
1. Buat file konfigurasi agen dan simpan di Parameter Store. Untuk informasi selengkapnya, lihat [Buat file konfigurasi CloudWatch agen](create-cloudwatch-agent-configuration-file.md).
1. Unduh template dari GitHub sebagai berikut:
```
curl -O https://raw.githubusercontent.com/awslabs/aws-cloudformation-templates/master/aws/solutions/AmazonCloudWatchAgent/ssm/amazon_linux.template
```
1. Buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Pilih **Create stack**.
1. Untuk **Pilih template**, pilih **Unggah template ke Amazon S3**, pilih template yang Anda unduh, lalu pilih **Berikutnya**.
1. 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](prerequisites.md).
+ **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 Konsol Manajemen AWS. Untuk informasi selengkapnya, lihat [Pasangan Kunci Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) di Panduan Pengguna *Amazon EC2*.
+ **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.
1. Di halaman **Opsi** Anda dapat memilih untuk menandai sumber daya tumpukan Anda. Pilih **Berikutnya**.
1. Pada halaman**Peninjauan**, 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.
1. 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 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**
1. Ubah file konfigurasi agen yang disimpan di Parameter Store ke konfigurasi baru yang Anda inginkan.
1. Di CloudFormation templat yang Anda unduh dalam [Tutorial: Instal CloudWatch agen menggunakan CloudFormation dan Parameter Store](#installing-CloudWatch-Agent-using-CloudFormation-Templates) topik, ubah nomor versi. Misalnya, Anda mungkin mengubah `VERSION=1.0` untuk `VERSION=2.0`.
1. Buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Di CloudFormation dasbor, pilih tumpukan yang Anda buat dan pilih **Update Stack**.
1. Untuk **Memilih Template**, pilih **Unggah template ke Amazon S3**, pilih template yang baru saja Anda modifikasi, dan pilih **Berikutnya**.
1. Pada halaman **Option**, pilih **Berikutnya** dan kemudian **Berikutnya**.
1. 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](troubleshooting-CloudWatch-Agent.md#CloudWatch-Agent-files-and-locations).