Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal CloudWatch agen di server lokal
Jika Anda mengunduh CloudWatch agen di komputer dan membuat file konfigurasi agen, 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.
### Unduh Menggunakan Systems Manager
Untuk menggunakan Perintah Eksekusi Systems Manager, Anda harus mendaftarkan server on-premise Anda dengan Amazon EC2 Systems Manager. Untuk informasi selengkapnya, silakan lihat [ Menyiapkan Systems Manager dalam Lingkungan Hibrid](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) dalam *AWS Systems Manager Panduan Pengguna*.
Jika Anda sudah mendaftarkan server Anda, perbarui Agen SSM ke versi terbaru.
Untuk informasi tentang memperbarui SSM Agent di server yang menjalankan Linux, silakan lihat [Instal Agen SSM untuk Lingkungan Hibrid (Linux)](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html#sysman-install-managed-linux) di *AWS Systems Manager Panduan Pengguna*.
Untuk informasi tentang memperbarui Agen SSM di server yang menjalankan Windows Server, silakan lihat [ Instal Agen SSM untuk Lingkungan Hibrid (Windows)](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html#sysman-install-managed-win) di *AWS Systems Manager Panduan Pengguna *.
**Untuk menggunakan Agen SSM untuk mengunduh paket CloudWatch agen di server lokal**
1. Buka konsol Systems Manager di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Pada panel navigasi, silakan pilih **Perintah Eksekusi**.
-atau-
Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih **Jelajahi Jalankan Perintah**.
1. Pilih **Jalankan perintah**.
1. Dalam daftar **dokumen Command**, pilih tombol di sebelah **AWS-configure AWSPackage**.
1. Di **Target** , pilih server untuk menginstal CloudWatch agen pada. Jika Anda tidak melihat server tertentu, server tersebut mungkin tidak dikonfigurasikan untuk Perintah Proses. Untuk informasi selengkapnya, lihat [AWS Systems Manager Menyiapkan Lingkungan Hybrid](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) di *Panduan AWS Systems Manager Pengguna*.
1. Di daftar **Tindakan** pilih, **Instal**.
1. Di kotak **Nama**, masukkan*AmazonCloudWatchAgent*.
1. Simpan **Versi** kosong untuk melakukan instalasi versi terbaru agen.
1. Pilih **Jalankan**.
Paket agen diunduh, dan langkah selanjutnya adalah mengonfigurasi dan memulainya.
## (Menginstal di server lokal) Tentukan kredensyal IAM dan Wilayah AWS
Untuk mengaktifkan CloudWatch agen mengirim data dari server lokal, Anda harus menentukan kunci akses dan kunci rahasia pengguna IAM yang Anda buat sebelumnya.
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\$1access\$1key* dan*my\$1secret\$1key*, gunakan kunci dari pengguna IAM yang tidak memiliki izin untuk menulis ke Systems Manager Parameter Store.
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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).
1. 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 disebut`common-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 pengguna IAM 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 kredensyal IAM dan Wilayah AWS](#install-CloudWatch-Agent-iam_user-SSM-onprem).
Pada instans EC2, 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 \$1.
```
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 proxy HTTP atau HTTPS untuk menghubungi layanan AWS , tentukan proxy tersebut di bidang `http_proxy` dan `https_proxy`. Jika ada URLs yang harus dikecualikan dari proxy, tentukan di `no_proxy` bidang, dipisahkan dengan koma.