Instal CloudWatch agen di server lokal

Jika Anda telah mengunduh CloudWatch agen di satu komputer dan membuat file konfigurasi agen yang Anda inginkan, Anda dapat menggunakan file konfigurasi tersebut untuk menginstal agen di server lokal lainnya.

Unduh CloudWatch agen di server lokal

Anda dapat mengunduh paket CloudWatch agen menggunakan Systems Manager Run Command atau tautan unduhan Amazon S3. Untuk informasi tentang penggunaan tautan unduhan Amazon S3, silakan lihat Unduh paket CloudWatch agen.

Unduh Menggunakan Systems Manager

Untuk menggunakan Systems Manager Run Command, Anda harus mendaftarkan server lokal Anda dengan Amazon EC2 Systems Manager. Untuk informasi selengkapnya, silakan lihat Menyiapkan Systems Manager dalam Lingkungan Hibrid dalam AWS Systems Manager Panduan Pengguna.

Jika Anda telah mendaftarkan server Anda, perbarui SSM Agen ke versi terbaru.

Untuk informasi tentang memperbarui SSM Agen di server yang menjalankan Linux, lihat Menginstal SSM Agen untuk Lingkungan Hybrid (Linux) di Panduan AWS Systems Manager Pengguna.

Untuk informasi tentang memperbarui SSM Agen di server yang menjalankan Windows Server, lihat Menginstal SSM Agen untuk Lingkungan Hybrid (Windows) di Panduan AWS Systems Manager Pengguna.

Untuk menggunakan SSM Agen untuk mengunduh paket CloudWatch agen di server lokal

1. Buka konsol Systems Manager di https://console.aws.amazon.com/systems-manager/.

2. Pada panel navigasi, silakan pilih Perintah Eksekusi.

   -atau-

   Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih Jelajahi Jalankan Perintah.

3. Pilih Jalankan perintah.

4. Dalam daftar dokumen Command, pilih tombol di sebelah AWS-C onfigureAWSPackage.

5. Di area Target, pilih server untuk menginstal CloudWatch agen. Jika Anda tidak melihat server tertentu, server tersebut mungkin tidak dikonfigurasikan untuk Perintah Proses. Untuk informasi selengkapnya, silakan lihat Mengatur AWS Systems Manager untuk Lingkungan Hibrid di Panduan Pengguna AWS Systems Manager .

6. Di daftar Tindakan pilih, Instal.

7. Di Nama , masukkan AmazonCloudWatchAgent.

8. Simpan Versi kosong untuk menginstal versi terbaru agen.

9. Pilih Jalankan.

   Paket agen diunduh, dan langkah selanjutnya adalah mengonfigurasi dan memulainya.

(Menginstal di server lokal) Tentukan IAM kredensil dan Wilayah AWS

Untuk mengaktifkan CloudWatch agen mengirim data dari server lokal, Anda harus menentukan kunci akses dan kunci rahasia IAM pengguna yang Anda buat sebelumnya. Untuk informasi selengkapnya tentang membuat pengguna ini, silakan lihat Buat IAM peran dan pengguna untuk digunakan dengan CloudWatch agen.

Anda juga harus menentukan AWS Wilayah untuk mengirim metrik ke, menggunakan region bidang.

Berikut ini adalah contoh file ini.

[AmazonCloudWatchAgent]
aws_access_key_id=my_access_key
aws_secret_access_key=my_secret_key
region = us-west-1

Untuk my_access_key and my_secret_key, gunakan kunci dari IAM pengguna yang tidak memiliki izin untuk menulis ke Systems Manager Parameter Store. Untuk informasi selengkapnya tentang IAM pengguna yang dibutuhkan untuk CloudWatch agen, lihatMembuat IAM pengguna untuk digunakan dengan CloudWatch agen di server lokal.

Jika Anda namai profil ini AmazonCloudWatchAgent, Anda tidak perlu melakukan apa pun lagi. Atau, Anda dapat memberikan nama yang berbeda dan menentukan nama tersebut sebagai nilai untuk shared_credential_profile dalam common-config.toml file, yang dijelaskan di bagian berikut.

Berikut ini adalah contoh menggunakan aws configure perintah untuk membuat profil bernama untuk CloudWatch agen. Contoh ini mengasumsikan bahwa Anda sedang menggunakan nama profil bawaan dari AmazonCloudWatchAgent.

Untuk membuat AmazonCloudWatchAgent profil untuk CloudWatch agen

1. Jika Anda belum melakukannya, instal AWS Command Line Interface di server. Untuk informasi selengkapnya, silakan lihat Menginstal AWS CLI.

2. Pada server Linux, masukkan perintah berikut dan ikuti petunjuknya:

   sudo aws configure --profile AmazonCloudWatchAgent

   Di Windows Server, buka PowerShell sebagai administrator, masukkan perintah berikut, dan ikuti petunjuknya.

   aws configure --profile AmazonCloudWatchAgent

(Opsional) Memodifikasi konfigurasi umum dan profil bernama untuk agen CloudWatch

CloudWatch Agen menyertakan file konfigurasi yang disebutcommon-config.toml. Secara opsional, Anda dapat menggunakan file ini sebagai pilihan untuk menentukan informasi proksi dan Wilayah.

Di server yang menjalankan Linux, file ini ada di /opt/aws/amazon-cloudwatch-agent/etc direktori. Pada server yang menjalankan Server Windows, file ini berada di direktori C:\ProgramData\Amazon\AmazonCloudWatchAgent.

common-config.toml bawaan adalah sebagai berikut:

# This common-config is used to configure items used for both ssm and cloudwatch access
 
 
## Configuration for shared credential.
## Default credential strategy will be used if it is absent here:
##            Instance role is used for EC2 case by default.
##            AmazonCloudWatchAgent profile is used for onPremise case by default.
# [credentials]
#    shared_credential_profile = "{profile_name}"
#    shared_credential_file= "{file_name}"
 
## Configuration for proxy.
## System-wide environment-variable will be read if it is absent here.
## i.e. HTTP_PROXY/http_proxy; HTTPS_PROXY/https_proxy; NO_PROXY/no_proxy
## Note: system-wide environment-variable is not accessible when using ssm run-command.
## Absent in both here and environment-variable means no proxy will be used.
# [proxy]
#    http_proxy = "{http_url}"
#    https_proxy = "{https_url}"
#    no_proxy = "{domain}"

Semua baris pada awalnya berkomentar. Untuk mengatur pengaturan profil kredensial atau proksi, hapus # dari baris tersebut dan tentukan nilai. Anda dapat mengedit file ini secara manual, atau menggunakan Perintah Eksekusi RunShellScript dalam Systems Manager:

• shared_credential_profile— Untuk server lokal, baris ini menentukan profil kredensi IAM pengguna yang akan digunakan untuk mengirim data. CloudWatch Jika Anda tetap baris ini berkomentar, AmazonCloudWatchAgent digunakan. Untuk informasi selengkapnya tentang membuat profil ini, silakan lihat (Menginstal di server lokal) Tentukan IAM kredensil dan Wilayah AWS.

  Pada sebuah EC2 instance, Anda dapat menggunakan baris ini untuk meminta CloudWatch agen mengirim data dari instance ini ke CloudWatch AWS Wilayah yang berbeda. Untuk melakukan hal itu, tentukan profil dengan nama yang mencakup region bidang yang menetapkan nama Wilayah yang akan dikirim.

  Jika menentukan shared_credential_profile, Anda juga harus menghapus # dari awal [credentials] yang sesuai.

• shared_credential_file – Untuk meminta agen mencari kredensial dalam file yang terletak di jalur selain jalur default, tentukan jalur dan nama file lengkap di sini. Jalur default adalah /root/.aws di Linux dan C:\\Users\\Administrator\\.aws pada Server Windows.

  Contoh pertama di bawah ini menunjukkan sintaks baris shared_credential_file yang valid untuk server Linux, dan contoh kedua valid untuk Server Windows. Pada Server Windows, Anda harus menghindari karakter \.

  shared_credential_file= "/usr/username/credentials"

  shared_credential_file= "C:\\Documents and Settings\\username\\.aws\\credentials"

  Jika menentukan shared_credential_file, Anda juga harus menghapus # dari awal [credentials] yang sesuai.

• Pengaturan proxy — Jika server Anda menggunakan HTTP atau HTTPS proxy untuk menghubungi AWS layanan, tentukan proxy tersebut di bidang dan. http_proxy https_proxy Jika ada URLs yang harus dikecualikan dari proxy, tentukan di no_proxy bidang, dipisahkan dengan koma.

Memulai CloudWatch agen

Anda dapat memulai CloudWatch agen menggunakan Systems Manager Run Command atau command line.

Untuk menggunakan SSM Agen untuk memulai CloudWatch agen di server lokal

1. Buka konsol Systems Manager di https://console.aws.amazon.com/systems-manager/.

2. Pada panel navigasi, silakan pilih Perintah Eksekusi.

   -atau-

   Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih Jelajahi Jalankan Perintah.

3. Pilih Jalankan perintah.

4. Dalam daftar dokumen Perintah, pilih tombol di sebelah AmazonCloudWatch- ManageAgent.

5. Di area Target, pilih contoh tempat Anda melakukan instalasi agen.

6. Di daftar Tindakan pilih, konfigurasi.

7. Di Mode pilih, onPremise.

8. Pada Optional Configuration Location masukkan nama file konfigurasi agen yang Anda buat dengan pemandu dan simpan di Parameter Store.

9. Pilih Jalankan.

   Agen memulai dengan konfigurasi yang Anda tentukan dalam file konfigurasi.

Untuk menggunakan baris perintah untuk memulai CloudWatch agen di server lokal

• Dalam perintah ini, -a fetch-config menyebabkan agen memuat versi terbaru dari file konfigurasi CloudWatch agen, dan -s memulai agen.

  Linux: Jika Anda menyimpan file konfigurasi di Systems Manager Parameter Store, masukkan yang berikut ini:

  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c ssm:configuration-parameter-store-name

  Linux: Jika Anda menyimpan file konfigurasi di komputer lokal, masukkan perintah berikut. Ganti configuration-file-path dengan jalur menuju file konfigurasi agen. File ini disebut config.json Jika kau membuatnya dengan wizard, dan bisa dipanggil amazon-cloudwatch-agent.json jika Anda membuatnya secara manual.

  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c file:configuration-file-path

  Windows Server: Jika Anda menyimpan file konfigurasi agen di Systems Manager Parameter Store, masukkan yang berikut dari PowerShell konsol:

  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c ssm:configuration-parameter-store-name

  Windows Server: Jika Anda menyimpan file konfigurasi agen di komputer lokal, masukkan yang berikut ini dari PowerShell konsol. Ganti configuration-file-path dengan jalur menuju file konfigurasi agen. File ini disebut config.json Jika kau membuatnya dengan wizard, dan bisa dipanggil amazon-cloudwatch-agent.json jika Anda membuatnya secara manual.

  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:configuration-file-path