Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat atau edit file konfigurasi CloudWatch agen secara manual
File konfigurasi CloudWatch agen adalah file JSON dengan empat bagian:`agent`,, `metrics``logs`, dan`traces`.
+ `agent` bagian ini mencakup kolom untuk konfigurasi agen secara keseluruhan.
+ `metrics`Bagian ini menentukan metrik kustom untuk pengumpulan dan penerbitan. CloudWatch Jika menggunakan agen hanya untuk mengumpulkan log, Anda dapat menghilangkan bagian `metrics` dari file.
+ `logs`Bagian ini menentukan file log apa yang dipublikasikan ke CloudWatch Log. Ini dapat mencakup kejadian dari Windows Event Log (Log Kejadian) jika server menjalankan Server Windows.
+ `traces`Bagian ini menentukan sumber untuk jejak yang dikumpulkan dan dikirim ke AWS X-Ray.
Bagian ini menjelaskan struktur dan bidang file konfigurasi CloudWatch agen. Anda dapat melihat definisi skema untuk file konfigurasi ini. Definisi skema terletak di server Linux dan `installation-directory/doc/amazon-cloudwatch-agent-schema.json` `installation-directory/amazon-cloudwatch-agent-schema.json` di server yang menjalankan Windows Server.
Jika membuat atau mengedit file konfigurasi agen secara manual, Anda dapat memberinya nama apa pun. Untuk kemudahan dalam pemecahan masalah, kami sarankan Anda menamainya `/opt/aws/amazon-cloudwatch-agent/etc/cloudwatch-agent.json` di server Linux dan `$Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` pada server yang menjalankan Server Windows. Setelah membuat file, Anda dapat menyalinnya ke server lain tempat Anda ingin melakukan instalasi agen.
Ketika agen dimulai, ia membuat salinan dari setiap file konfigurasi dalam `/opt/aws/amazon-cloudwatch/etc/amazon-cloudwatch-agent.d` direktori, dengan nama file diawali dengan baik `file_` (untuk sumber file lokal) atau `ssm_` (untuk sumber penyimpanan parameter Systems Manager) untuk menunjukkan asal konfigurasi.
**catatan**
Metrik, log, dan jejak yang dikumpulkan oleh CloudWatch agen menimbulkan biaya. Untuk informasi selengkapnya tentang harga, lihat [ CloudWatchHarga Amazon](https://aws.amazon.com/cloudwatch/pricing).
## CloudWatch file konfigurasi agen: Bagian Agen
Bagian `agent` dapat mencakup bidang-bidang berikut. Pemandu tidak membuat `agent` bagian. Sebaliknya, pemandu menghilangkannya dan menggunakan nilai default untuk semua bidang di bagian ini.
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering semua metrik yang ditentukan dalam file konfigurasi ini akan dikumpulkan. Anda dapat mengganti nilai ini untuk jenis metrik tertentu.
Nilai ini ditentukan dalam detik. Misalnya, menentukan 10 metrik yang akan dikumpulkan setiap 10 detik, dan menetapkannya menjadi 300 metrik kustom untuk dikumpulkan setiap 5 menit.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
Nilai bawaannya adalah 60.
+ `region`— Menentukan Wilayah yang akan digunakan untuk CloudWatch titik akhir saat instans Amazon EC2 sedang dipantau. Metrik yang dikumpulkan dikirim ke Wilayah ini, seperti `us-west-1`. Jika Anda menghilangkan bidang ini, agen akan mengirimkan metrik ke Wilayah tempat instans Amazon EC2 berada.
Jika Anda memantau server on-premise, bidang ini tidak digunakan, dan agen membaca Wilayah dari profil `AmazonCloudWatchAgent` file konfigurasi AWS .
+ `credentials`— Menentukan peran IAM untuk digunakan saat mengirim metrik, log, dan jejak ke akun yang berbeda. AWS Jika ditentukan, bidang ini berisi satu parameter, `role_arn`.
+ `role_arn`— Menentukan Nama Sumber Daya Amazon (ARN) dari peran IAM yang akan digunakan untuk otentikasi saat mengirim metrik, log, dan jejak ke akun lain. AWS Untuk informasi selengkapnya, lihat [Mengirim metrik, log, dan jejak ke akun lain](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-send-to-different-AWS-account).
+ `debug` – Opsional. Menentukan menjalankan CloudWatch agen dengan pesan log debug. Nilai bawaannya adalah `false`.
+ `aws_sdk_log_level` – Opsional. Hanya didukung di versi 1.247350.0 dan agen yang lebih baru. CloudWatch
Anda dapat menentukan bidang ini agar agen melakukan pencatatan untuk titik akhir AWS SDK. Nilai untuk bidang ini dapat mencakup satu atau beberapa opsi berikut. Pisahkan beberapa opsi dengan karakter `|`.
+ `LogDebug`
+ `LogDebugWithSigning`
+ `LogDebugWithHTTPBody`
+ `LogDebugRequestRetries`
+ `LogDebugWithEventStreamBody`
Untuk informasi selengkapnya tentang opsi ini, lihat [LogLevelType](https://docs.aws.amazon.com/sdk-for-go/api/aws/#LogLevelType).
+ `logfile`— Menentukan lokasi di mana CloudWatch agen menulis pesan log. Jika Anda menentukan string kosong, log akan beralih ke stderr. Jika Anda tidak menentukan opsi ini, lokasi defaultnya adalah sebagai berikut:
+ Linux: `/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log`
+ Server Windows: `c:\\ProgramData\\Amazon\\CloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log`
CloudWatch Agen secara otomatis memutar file log yang dibuatnya. File log dirotasi ketika ukurannya mencapai 100 MB. Agen menyimpan file log yang dirotasi selama hingga tujuh hari, dan menyimpan sebanyak lima file log cadangan yang telah dirotasi. File log cadangan memiliki stempel waktu yang ditambahkan ke nama file mereka. Jadwal menunjukkan tanggal dan waktu file dirotasi: misalnya, `amazon-cloudwatch-agent-2018-06-08T21-01-50.247.log.gz`.
+ `omit_hostname` – Opsional. Secara bawaan, nama host dipublikasikan sebagai dimensi metrik yang dikumpulkan oleh agen, kecuali jika Anda menggunakan bidang `append_dimensions` di bagian `metrics`. Atur `omit_hostname ` ke `true` untuk mencegah nama host diterbitkan sebagai dimensi bahkan jika Anda tidak menggunakan `append_dimensions`. Nilai bawaannya adalah `false`.
+ `run_as_user` – Opsional. Menentukan pengguna yang akan digunakan untuk menjalankan CloudWatch agen. Jika Anda tidak menetapkan parameter ini, pengguna root akan digunakan. Opsi ini hanya valid di server Linux.
Jika Anda menentukan opsi ini, pengguna harus ada sebelum Anda memulai CloudWatch agen. Untuk informasi selengkapnya, lihat [Menjalankan CloudWatch agen sebagai pengguna yang berbeda](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-run-as-user).
+ `user_agent` – Opsional. Menentukan `user-agent` string yang digunakan oleh CloudWatch agen ketika membuat panggilan API ke CloudWatch backend. Nilai bawaannya adalah string yang terdiri dari versi agen, versi bahasa pemrograman Go yang digunakan untuk mengompilasi agen, sistem operasi runtime dan arsitektur, waktu pembuatan, dan plugin yang diaktifkan.
+ `usage_data` – Opsional. Secara default, CloudWatch agen mengirimkan data kesehatan dan kinerja tentang dirinya sendiri CloudWatch kapan pun ia menerbitkan metrik atau log ke. CloudWatch Data ini tidak membebankan biaya untuk Anda. Anda dapat mencegah agen mengirim data ini dengan menentukan `false` untuk`usage_data`. Jika Anda menghilangkan parameter ini, default `true` digunakan dan agen mengirimkan data kesehatan dan performa.
Jika menetapkan nilai ini`false`, Anda harus berhenti dan memulai ulang agen agar berlaku.
+ `service.name` – Opsional. Menentukan nama layanan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `deployment.environment` – Opsional. Menentukan nama lingkungan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `use_dualstack_endpoint` – Opsional. Jika demikian`true`, CloudWatch agen akan menggunakan [titik akhir tumpukan ganda](https://docs.aws.amazon.com/general/latest/gr/rande.html#dual-stack-endpoints) untuk semua panggilan API.
Berikut ini adalah contoh dari sebuah bagian `agent`.
```
"agent": {
"metrics_collection_interval": 60,
"region": "us-west-1",
"logfile": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
"debug": false,
"run_as_user": "cwagent"
}
```
## CloudWatch file konfigurasi agen: Bagian metrik
### Bidang umum untuk Linux dan Windows
Pada server yang menjalankan Linux atau Windows Server, `metrics` bagian ini mencakup kolom berikut:
+ `namespace` – Opsional. Ruangnama yang digunakan untuk metrik yang dikumpulkan oleh agen. Nilai bawaannya adalah `CWAgent`. Panjang maksimalnya adalah 255 karakter. Berikut ini salah satu contohnya:
```
{
"metrics": {
"namespace": "Development/Product1Metrics",
......
},
}
```
+ `append_dimensions` – Opsional. Menambahkan dimensi metrik Amazon EC2 ke semua metrik yang dikumpulkan oleh agen. Hal ini juga menyebabkan agen untuk tidak menerbitkan nama host sebagai dimensi.
Satu-satunya pasangan nilai kunci yang didukung untuk `append_dimensions` ditampilkan dalam daftar berikut. Pasangan kunci lainnya diabaikan. Agen mendukung pasangan nilai kunci ini persis seperti yang ditampilkan dalam daftar berikut. Anda tidak dapat mengubah nilai kunci untuk menerbitkan nama dimensi yang berbeda untuknya.
+ `"ImageId":"${aws:ImageId}"` menetapkan AMI ID instans sebagai nilai dari `ImageId` dimensi.
+ `"InstanceId":"${aws:InstanceId}"` menetapkan ID instans dari instans sebagai nilai `InstanceId` dimensi.
+ `"InstanceType":"${aws:InstanceType}"` menetapkan tipe instans dari instans sebagai nilai dimensi `InstanceType`.
+ `"AutoScalingGroupName":"${aws:AutoScalingGroupName}"` menetapkan nama contoh grup Auto Scaling `AutoScalingGroupName` dimensi tertentu.
Jika Anda ingin menambahkan dimensi ke metrik dengan pasangan nilai kunci arbitrer, gunakan `append_dimensions` di bidang untuk tipe metrik tertentu.
Jika menentukan nilai yang bergantung pada metadata EC2 Amazon dan menggunakan proksi, Anda harus memastikan bahwa server dapat mengakses titik akhir untuk Amazon EC2. Untuk informasi selengkapnya tentang titik akhir ini, silakan lihat [Amazon Elastic Compute Cloud (Amazon EC2)](https://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) di. *Referensi Umum Amazon Web Services*
+ `aggregation_dimensions` – Opsional. Menentukan dimensi yang akan digabungkan dengan metrik yang dikumpulkan. Sebagai contoh, jika Anda menggulir metrik pada `AutoScalingGroupName` dimensi, metrik dari semua instans dalam setiap kelompok grup Auto Scaling dikumpulkan dan dapat dilihat secara keseluruhan.
Anda dapat menggulirkan metrik di sepanjang dimensi tunggal atau ganda. Misalnya, menentukan `[["InstanceId"], ["InstanceType"], ["InstanceId","InstanceType"]]` mengagregasi metrik untuk ID instans secara tunggal, tipe instans secara tunggal, dan untuk kombinasi kedua dimensi tersebut.
Anda juga dapat menentukan `[]` untuk menggulirkan semua metrik menjadi satu koleksi, mengabaikan semua dimensi.
+ `endpoint_override` – Menentukan titik akhir FIPS atau tautan privat untuk digunakan sebagai titik akhir tempat agen mengirimkan metrik. Menentukan hal ini dan mengatur tautan privat memungkinkan Anda mengirimkan metrik ke titik akhir VPC Amazon VPC. Untuk informasi selengkapnya, silakan lihat [Apa Itu Amazon VPC?](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html).
Nilai dari `endpoint_override` harus string yang berupa URL.
Misalnya, bagian berikut dari bagian metrik pada file konfigurasi menetapkan agen untuk menggunakan Titik Akhir VPC saat mengirim metrik.
```
{
"metrics": {
"endpoint_override": "vpce-XXXXXXXXXXXXXXXXXXXXXXXXX.monitoring.us-east-1.vpce.amazonaws.com",
......
},
}
```
+ `metrics_collected` – Wajib. Menentukan metrik mana yang akan dikumpulkan, termasuk metrik kustom yang dikumpulkan melalui atau `StatsD` atau `collectd`. Bagian ini mencakup beberapa subbagian.
Isi dari `metrics_collected` bergantung pada apakah file konfigurasi ini untuk server yang menjalankan Linux atau Windows Server.
+ `metrics_destinations` – Opsional. Menentukan satu atau lebih tujuan untuk semua metrik didefinisikan dalam. `metrics_collected` Jika ditentukan di sini, itu mengesampingkan tujuan default. `cloudwatch`
+ `cloudwatch`— Amazon CloudWatch.
+ `amp`- Layanan Dikelola Amazon untuk Prometheus.
+ `workspace_id`— ID yang sesuai dengan Layanan Terkelola Amazon untuk ruang kerja Prometheus.
```
{
"metrics": {
"metrics_destinations": {
"cloudwatch": {},
"amp": {
"workspace_id": "ws-abcd1234-ef56-7890-ab12-example"
}
}
}
}
```
+ `force_flush_interval` – Menentukan dalam hitungan detik lamanya waktu maksimal metrik itu tetap berada dalam buffer memori sebelum dikirim ke server. Apa pun pengaturannya, jika ukuran metrik di buffer mencapai 1 MB atau 1000 metrik berbeda, metrik akan segera dikirim ke server.
Nilai bawaannya adalah 60.
+ `credentials` – Menentukan peran IAM yang akan digunakan saat mengirim metrik ke akun yang berbeda. Jika ditentukan, bidang ini berisi satu parameter, `role_arn`.
+ `role_arn` – Menentukan ARN peran IAM yang akan digunakan untuk autentikasi saat mengirim metrik ke akun yang berbeda. Untuk informasi selengkapnya, lihat [Mengirim metrik, log, dan jejak ke akun lain](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-send-to-different-AWS-account). Jika ditentukan di sini, nilai ini akan menggantikan `role_arn` yang ditentukan dalam `agent` dari file konfigurasi, jika ada.
+ `service.name` – Opsional. Menentukan nama layanan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `deployment.environment` – Opsional. Menentukan nama lingkungan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
### Bagian Linux
Di server yang menjalankan Linux, `metrics_collected` bagian file konfigurasi juga dapat berisi bidang-bidang berikut.
Banyak dari bidang ini dapat mencakup `measurement` bagian yang mencantumkan metrik yang ingin Anda kumpulkan untuk sumber daya tersebut. Ini `measurement` Anda dapat menentukan nama metrik lengkap seperti `swap_used`, atau hanya bagian dari nama metrik yang akan ditambahkan ke jenis sumber daya. Misalnya, menentukan `reads` dalam `measurement` bagian dari `diskio` menyebabkan `diskio_reads` metrik yang akan dikumpulkan.
+ `collectd` – Opsional. Menentukan bahwa Anda ingin mengambil metrik kustom menggunakan `collectd` protokol. Anda menggunakan `collectd` perangkat lunak untuk mengirim metrik ke CloudWatch agen. Untuk informasi selengkapnya tentang opsi konfigurasi yang tersedia untuk yang dikumpulkan, silakan lihat [Ambil Metrik Kustom dengan koleksi](CloudWatch-Agent-custom-metrics-collectd.md).
+ `cpu` – Opsional. Menentukan bahwa metrik CPU harus dikumpulkan. Bagian ini hanya valid untuk instans Linux. Anda harus memasukkan setidaknya satu `resources` dan `totalcpu` untuk setiap metrik CPU yang akan dikumpulkan. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `resources` – Opsional. Tentukan bidang ini dengan nilai `*` untuk mengumpulkan metrik per-cpu. Satu-satunya nilai yang diperbolehkan adalah `*`.
+ `totalcpu` – Opsional. Menentukan apakah pelaporan metrik cpu dikumpulkan di seluruh inti permasalahan. Bawaannya adalah benar.
+ `measurement` – Tentukan rangkaian metrik cpu yang akan dikumpulkan. Kemungkinan nilai adalah `time_active`, `time_guest`, `time_guest_nice`, `time_idle`, `time_iowait`, `time_irq`, `time_nice`, `time_softirq`, `time_steal`, `time_system`, `time_user`, `usage_active`, `usage_guest`, `usage_guest_nice`, `usage_idle`, `usage_iowait`, `usage_irq`, `usage_nice`, `usage_softirq`, `usage_steal`, `usage_system`, dan `usage_user`. Kolom ini wajib diisi jika Anda menyertakan `cpu`.
Secara bawaan, unit untuk `cpu_usage_*` adalah `Percent`, dan `cpu_time_*` metrik tidak memiliki unit.
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik cpu, menggulingkan global `metrics_collection_interval` yang ditentukan dalam bagian `agent` dari file konfigurasi.
Nilai ini ditentukan dalam detik. Misalnya, menentukan 10 metrik yang akan dikumpulkan setiap 10 detik, dan menetapkannya menjadi 300 metrik kustom untuk dikumpulkan setiap 5 menit.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya pada metrik cpu. Jika Anda menentukan bidang ini, maka bidang tersebut digunakan sebagai tambahan dimensi yang ditentukan dalam `append_dimensions` global yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `disk` – Opsional. Menentukan bahwa metrik disk harus dikumpulkan. Mengumpulkan metrik hanya untuk volume yang dipasang. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `resources` – Opsional. Menentukan rangkaian titik pemasangan disk. Bidang ini membatasi CloudWatch untuk mengumpulkan metrik hanya dari titik pemasangan yang terdaftar. Anda dapat menentukan `*` sebagai nilai untuk mengumpulkan metrik dari semua titik pemasangan. Nilai bawaannya adalah mengumpulkan metrik dari semua titik dudukan.
+ `measurement` – Menentukan larik metrik disk yang akan dikumpulkan. Kemungkinan nilai adalah `free`, `total`, `used`, `used_percent`, `inodes_free`, `inodes_used`, dan `inodes_total`. Kolom ini wajib diisi jika Anda menyertakan `disk`.
**catatan**
Metrik-metrik `disk` tersebut memiliki sebuah dimensi untuk `Partition`, yang berarti bahwa jumlah metrik kustom yang dihasilkan tergantung pada jumlah partisi yang dikaitkan dengan instans Anda. Jumlah partisi disk yang Anda miliki tergantung pada AMI mana yang Anda gunakan dan jumlah volume EBS Amazon yang Anda lampirkan di server.
Untuk melihat satuan bawaan untuk setiap `disk` metrik, silakan lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent).
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` dari `None` untuk metrik tersebut. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `ignore_file_system_types` – Menentukan jenis sistem file untuk dikecualikan saat mengumpulkan metrik disk. Nilai yang valid termasuk `sysfs`, `devtmpfs`, dan sebagainya.
+ `drop_device` – Mengatur ini untuk `true` penyebab `Device` tidak disertakan sebagai dimensi untuk metrik disk.
Dengan mencegah `Device` agar tidak digunakan sebagai sebuah dimensi dapat berguna pada instans yang menggunakan sistem Nitro karena pada instans tersebut, nama perangkat berubah untuk setiap pemasangan disk ketika instans dinyalakan ulang. Hal ini dapat menyebabkan data tidak konsisten dalam metrik Anda dan menyebabkan alarm berdasarkan metrik tersebut masuk `INSUFFICIENT DATA` kondisi.
Nilai default-nya `false`.
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik disk, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya, lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Tentukan pasangan nilai kunci yang akan digunakan sebagai dimensi tambahan hanya untuk metrik disk. Jika Anda menentukan bidang ini, maka bidang ini akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
Satu pasangan kunci-nilai yang dapat Anda gunakan adalah sebagai berikut. Anda juga dapat menentukan pasangan nilai kunci khusus lainnya.
+ `"VolumeId":"${aws:VolumeId}"`menambahkan `VolumeId` dimensi ke metrik disk perangkat blok Anda. Untuk volume Amazon EBS, ini akan menjadi ID Volume Amazon EBS. Untuk penyimpanan instans EC2, ini akan menjadi serial perangkat. Menggunakan ini membutuhkan `drop_device` parameter yang akan disetel ke`false`.
+ `diskio` – Opsional. Menentukan bahwa i/o metrik disk yang akan dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `resources` – Opsional. Jika Anda menentukan larik perangkat, CloudWatch kumpulkan metrik hanya dari perangkat tersebut. Jika tidak, metrik untuk semua perangkat akan dikumpulkan. Anda juga dapat menentukan \$1 sebagai nilai untuk mengumpulkan metrik dari semua perangkat.
+ `measurement`— Menentukan larik metrik driver diskio dan AWS NVMe yang akan dikumpulkan untuk volume Amazon EBS dan volume penyimpanan instans yang dilampirkan ke instans Amazon EC2. Nilai diskio yang mungkin adalah`reads`,`writes`,`read_bytes`,`write_bytes`,, `read_time` `write_time``io_time`, dan. `iops_in_progress` Untuk daftar metrik driver NVMe untuk volume Amazon EBS dan volume penyimpanan instans Amazon EC2, lihat dan. [Kumpulkan metrik NVMe driver Amazon EBS](Container-Insights-metrics-EBS-Collect.md) [Kumpulkan metrik driver volume NVMe penyimpanan instans Amazon EC2](Container-Insights-metrics-instance-store-Collect.md) Kolom ini wajib diisi jika Anda menyertakan `diskio`.
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` dari `None` untuk metrik tersebut. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
Untuk informasi tentang unit default dan deskripsi metrik, lihat[Kumpulkan metrik NVMe driver Amazon EBS](Container-Insights-metrics-EBS-Collect.md).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik diskio, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya untuk diskio metrics. Jika Anda menentukan bidang ini, maka bidang ini akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `swap` – Opsional. Menentukan bahwa metrik memori swap harus dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `measurement` – Menentukan rangkaian metrik swap yang akan dikumpulkan. Nilai yang mungkin adalah `free`, `used`, dan `used_percent`. Kolom ini wajib diisi jika Anda menyertakan `swap`.
Untuk melihat satuan bawaan untuk setiap `swap` metrik, silakan lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent).
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` dari `None` untuk metrik tersebut. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik swap, menggulingkan `metrics_collection_interval` yang ditentukan dalam bagian `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya pada metrik swap. Jika Anda menentukan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` global yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen. Ini dikumpulkan sebagai metrik resolusi tinggi.
+ `mem` – Opsional. Menentukan bahwa metrik memori harus dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `measurement` – Menentukan susunan metrik memori yang akan dikumpulkan. Kemungkinan nilai adalah `active`, `available`, `available_percent`, `buffered`, `cached`, `free`, `inactive`, `shared`, `total`, `used`, dan `used_percent`. Kolom ini wajib diisi jika Anda menyertakan `mem`.
Untuk melihat satuan bawaan untuk setiap `mem` metrik, silakan lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent).
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik mem, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya untuk metrik mem. Jika Anda menetapkan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `net` – Opsional. Menentukan bahwa metrik jaringan akan dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `resources` – Opsional. Jika Anda menentukan array antarmuka jaringan, CloudWatch kumpulkan metrik hanya dari antarmuka tersebut. Jika tidak, metrik untuk semua perangkat akan dikumpulkan. Anda juga dapat menentukan `*` sebagai nilai untuk mengumpulkan metrik dari semua antarmuka.
+ `measurement` – Menentukan susunan metrik jaringan yang akan dikumpulkan. Kemungkinan nilai adalah `bytes_sent`, `bytes_recv`, `drop_in`, `drop_out`, `err_in`, `err_out`, `packets_sent`, dan `packets_recv`. Kolom ini wajib diisi jika Anda menyertakan `net`.
Untuk melihat satuan bawaan untuk setiap `net` metrik, silakan lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent).
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik bersih, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik. Misalnya, menentukan 10 metrik yang akan dikumpulkan setiap 10 detik, dan menetapkannya menjadi 300 metrik kustom untuk dikumpulkan setiap 5 menit.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya pada metrik bersih. Jika Anda menentukan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `netstat` – Opsional. Menentukan bahwa metrik status koneksi TCP dan koneksi UDP akan dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `measurement` – Menentukan susunan metrik netstat yang akan dikumpulkan. Kemungkinan nilai adalah `tcp_close`, `tcp_close_wait`, `tcp_closing`, `tcp_established`, `tcp_fin_wait1`, `tcp_fin_wait2`, `tcp_last_ack`, `tcp_listen`, `tcp_none`, `tcp_syn_sent`, `tcp_syn_recv`, `tcp_time_wait`, dan `udp_socket`. Kolom ini wajib diisi jika Anda menyertakan `netstat`.
Untuk melihat satuan bawaan untuk setiap `netstat` metrik, silakan lihat [Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS](metrics-collected-by-CloudWatch-agent.md#linux-metrics-enabled-by-CloudWatch-agent).
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik netstat, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya tentang metrik resolusi tinggi, silakan lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya pada metrik netstat. Jika Anda menentukan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `processes` – Opsional. Menentukan bahwa metrik proses akan dikumpulkan. Bagian ini hanya valid untuk instans Linux. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `measurement` – Menentukan rangkaian metrik proses yang akan dikumpulkan. Kemungkinan nilai adalah `blocked`, `dead`, `idle`, `paging`, `running`, `sleeping`, `stopped`, `total`, `total_threads`, `wait`, dan `zombies`. Kolom ini wajib diisi jika Anda menyertakan `processes`.
Untuk semua `processes` metrik, unit bawaan adalah `None`.
Di dalam entri untuk setiap metrik individu, secara opsional Anda dapat menentukan salah satu atau kedua hal berikut:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik proses, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik. Misalnya, menentukan 10 metrik yang akan dikumpulkan setiap 10 detik, dan menetapkannya menjadi 300 metrik kustom untuk dikumpulkan setiap 5 menit.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya, lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Dimensi tambahan untuk digunakan hanya pada metrik proses. Jika Anda menentukan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `nvidia_gpu` – Opsional. Menentukan bahwa metrik NVIDIA GPU harus dikumpulkan. Bagian ini hanya berlaku untuk instans Linux pada host yang dikonfigurasi dengan akselerator GPU NVIDIA dan melakukan instalasi Antarmuka Manajemen Sistem NVIDIA (nvidia-smi).
Metrik GPU NVIDIA yang dikumpulkan diawali dengan string `nvidia_smi_` untuk membedakannya dari metrik yang dikumpulkan untuk jenis akselerator lainnya. Bagian ini dapat mencakup bidang-bidang berikut:
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
+ `measurement` – Menentukan larik metrik NVIDIA GPU yang akan dikumpulkan. Untuk daftar nilai yang mungkin digunakan di sini, silakan lihat kolom **Metrik** dalam tabel di[Kumpulkan metrik GPU NVIDIA](CloudWatch-Agent-NVIDIA-GPU.md).
Di dalam entri untuk setiap metrik individu, Anda dapat menentukan salah satu atau kedua hal berikut secara opsional:
+ `rename` – Menentukan nama yang berbeda untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini, membatalkan unit default `None` untuk metrik. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik GPU NVIDIA, membatalkan global yang `metrics_collection_interval` ditentukan dalam `agent` bagian file konfigurasi.
+ `jmx` – Opsional. Menentukan bahwa Anda ingin mengambil metrik Java Management Extensions (JMX) dari instance. Untuk informasi selengkapnya tentang parameter yang dapat Anda gunakan di bagian ini dan metrik yang dapat Anda kumpulkan, lihat[Kumpulkan metrik Java Management Extensions (JMX)](CloudWatch-Agent-JMX-metrics.md).
+ `otlp` – Opsional. Menentukan bahwa Anda ingin mengumpulkan metrik dari SDK. OpenTelemetry Untuk informasi selengkapnya tentang bidang yang dapat Anda gunakan di bagian ini, lihat[Kumpulkan metrik dan jejak dengan OpenTelemetry](CloudWatch-Agent-OpenTelemetry-metrics.md).
+ `procstat` – Opsional. Menjelaskan bahwa Anda ingin mengambil metrik dari proses individu. Untuk informasi selengkapnya tentang opsi konfigurasi yang tersedia untuk procstat, silakan lihat [Kumpulkan Metrik Proses dengan Plugin procstat](CloudWatch-Agent-procstat-process-metrics.md).
+ `statsd` – Opsional. Menentukan bahwa Anda ingin mengambil metrik kustom menggunakan `StatsD` protokol. CloudWatch Agen bertindak sebagai daemon untuk protokol. Anda menggunakan `StatsD` klien standar apa pun untuk mengirim metrik ke CloudWatch agen. Untuk informasi selengkapnya tentang opsi konfigurasi yang tersedia untuk StatsD, silakan lihat [Ambil metrik kustom dengan StatSD](CloudWatch-Agent-custom-metrics-statsd.md).
+ `ethtool` – Opsional. Menentukan bahwa Anda ingin mengambil metrik jaringan menggunakan plugin `ethtool`. Plugin ini dapat mengimpor metrik yang dikumpulkan oleh utilitas ettool standar, serta metrik performa jaringan dari instans Amazon EC2. Untuk informasi selengkapnya tentang opsi konfigurasi yang tersedia untuk ethtool, silakan lihat [Mengumpulkan metrik performa jaringan](CloudWatch-Agent-network-performance.md).
Berikut ini adalah contoh `metrics` untuk server Linux. Dalam contoh ini, tiga metrik CPU, tiga metrik netstat, tiga metrik proses, dan satu metrik disk dikumpulkan, dan agen diatur untuk menerima metrik tambahan dari `collectd` klien mereka.
```
"metrics": {
"aggregation_dimensions" : [["AutoScalingGroupName"], ["InstanceId", "InstanceType"],[]],
"metrics_collected": {
"collectd": {},
"cpu": {
"resources": [
"*"
],
"measurement": [
{"name": "cpu_usage_idle", "rename": "CPU_USAGE_IDLE", "unit": "Percent"},
{"name": "cpu_usage_nice", "unit": "Percent"},
"cpu_usage_guest"
],
"totalcpu": false,
"drop_original_metrics": [ "cpu_usage_guest" ],
"metrics_collection_interval": 10,
"append_dimensions": {
"test": "test1",
"date": "2017-10-01"
}
},
"netstat": {
"measurement": [
"tcp_established",
"tcp_syn_sent",
"tcp_close"
],
"metrics_collection_interval": 60
},
"disk": {
"measurement": [
"used_percent"
],
"resources": [
"*"
],
"drop_device": true
},
"processes": {
"measurement": [
"running",
"sleeping",
"dead"
]
}
},
"append_dimensions": {
"ImageId": "${aws:ImageId}",
"InstanceId": "${aws:InstanceId}",
"InstanceType": "${aws:InstanceType}",
"AutoScalingGroupName": "${aws:AutoScalingGroupName}"
}
}
```
### Server Windows
Di bagian `metrics_collected` untuk Windows Server, Anda dapat memiliki subbagian untuk setiap objek performa Windows, seperti `Memory`, `Processor`, dan `LogicalDisk`. Untuk informasi tentang apa objek dan counter tersedia, silakan lihat [Performance Counters](https://learn.microsoft.com/en-us/windows/win32/perfctrs/performance-counters-portal) di dokumentasi Microsoft Windows.
Dalam subbagian untuk setiap objek, Anda menentukan `measurement` baris konter untuk mengumpulkan. `measurement` larik diperlukan untuk setiap objek yang Anda tentukan dalam file konfigurasi. Anda juga dapat menentukan `resources` untuk menamai kejadian untuk mengumpulkan metrik. Anda juga dapat menentukan `*` untuk `resources` untuk mengumpulkan metrik terpisah untuk setiap instans. Jika Anda menghilangkan `resources` penghitung yang memiliki instans, data untuk semua instans dikumpulkan menjadi satu set. Jika Anda menghilangkan `resources` penghitung yang tidak memiliki instance, penghitung tidak dikumpulkan oleh agen. CloudWatch Untuk menentukan apakah counter memiliki instans, Anda dapat menggunakan salah satu dari perintah berikut.
PowerShell:
```
Get-Counter -ListSet *
```
Baris perintah (bukan Powershell):
```
TypePerf.exe –q
```
Dalam setiap bagian objek, Anda juga dapat menentukan kolom opsional berikut:
+ `metrics_collection_interval` – Opsional. Menentukan seberapa sering mengumpulkan metrik untuk objek ini, menggulingkan `metrics_collection_interval` yang ditentukan dalam `agent` di file konfigurasi.
Nilai ini ditentukan dalam detik. Misalnya, menentukan 10 metrik yang akan dikumpulkan setiap 10 detik, dan menetapkannya menjadi 300 metrik kustom untuk dikumpulkan setiap 5 menit.
Jika Anda mengatur nilai ini di bawah 60 detik, setiap metrik dikumpulkan sebagai metrik resolusi tinggi. Untuk informasi selengkapnya, lihat [Metrik resolusi tinggi](publishingMetrics.md#high-resolution-metrics).
+ `append_dimensions` – Opsional. Menentukan dimensi tambahan untuk digunakan hanya pada metrik untuk objek ini. Jika Anda menentukan bidang ini, maka bidang tersebut akan digunakan sebagai tambahan dimensi yang ditentukan dalam bidang `append_dimensions` global yang digunakan untuk semua jenis metrik yang dikumpulkan oleh agen.
+ `drop_original_metrics` – Opsional. Jika Anda menggunakan bidang `aggregation_dimensions` di bagian `metrics` untuk menggulung metrik ke dalam hasil agregat, maka secara default agen mengirimkan metrik-metrik agregat dan metrik asli yang dipisahkan untuk setiap nilai dimensi. Jika Anda tidak ingin metrik asli dikirim CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak memiliki metrik berdasarkan dimensi yang dilaporkan. CloudWatch Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
Dalam setiap bagian penghitung, Anda juga dapat menentukan kolom opsional berikut:
+ `rename`- Menentukan nama yang berbeda untuk digunakan dalam CloudWatch untuk metrik ini.
+ `unit` – Menentukan unit yang akan digunakan untuk metrik ini. Unit yang Anda tentukan harus merupakan satuan CloudWatch metrik yang valid, seperti yang tercantum dalam `Unit` deskripsi di [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html).
Ada bagian opsional lain yang dapat Anda sertakan dalam`metrics_collected`:
+ `statsd` – Memungkinkan Anda mengambil kembali metrik kustom menggunakan `StatsD` protokol. CloudWatch Agen bertindak sebagai daemon untuk protokol. Anda menggunakan standar `StatsD` untuk mengirim metrik ke CloudWatch agen. Untuk informasi selengkapnya, lihat [Ambil metrik kustom dengan StatSD](CloudWatch-Agent-custom-metrics-statsd.md).
+ `procstat` – Memungkinkan Anda mengambil metrik dari proses individu. Untuk informasi selengkapnya, lihat [Kumpulkan Metrik Proses dengan Plugin procstat](CloudWatch-Agent-procstat-process-metrics.md).
+ `jmx` – Opsional. Menentukan bahwa Anda ingin mengambil metrik Java Management Extensions (JMX) dari instance. Untuk informasi selengkapnya tentang bidang yang dapat Anda gunakan di bagian ini dan metrik yang dapat Anda kumpulkan, lihat[Kumpulkan metrik Java Management Extensions (JMX)](CloudWatch-Agent-JMX-metrics.md).
+ `otlp` – Opsional. Menentukan bahwa Anda ingin mengumpulkan metrik dari SDK. OpenTelemetry Untuk informasi selengkapnya tentang bidang yang dapat Anda gunakan di bagian ini, lihat[Kumpulkan metrik dan jejak dengan OpenTelemetry](CloudWatch-Agent-OpenTelemetry-metrics.md).
Berikut ini adalah contoh `metrics` untuk digunakan di Server Windows. Dalam contoh ini, banyak metrik Windows yang dikumpulkan, dan komputer juga diatur untuk menerima metrik tambahan dari `StatsD` klien mereka.
```
"metrics": {
"metrics_collected": {
"statsd": {},
"Processor": {
"measurement": [
{"name": "% Idle Time", "rename": "CPU_IDLE", "unit": "Percent"},
"% Interrupt Time",
"% User Time",
"% Processor Time"
],
"resources": [
"*"
],
"append_dimensions": {
"d1": "win_foo",
"d2": "win_bar"
}
},
"LogicalDisk": {
"measurement": [
{"name": "% Idle Time", "unit": "Percent"},
{"name": "% Disk Read Time", "rename": "DISK_READ"},
"% Disk Write Time"
],
"resources": [
"*"
]
},
"Memory": {
"metrics_collection_interval": 5,
"measurement": [
"Available Bytes",
"Cache Faults/sec",
"Page Faults/sec",
"Pages/sec"
],
"append_dimensions": {
"d3": "win_bo"
}
},
"Network Interface": {
"metrics_collection_interval": 5,
"measurement": [
"Bytes Received/sec",
"Bytes Sent/sec",
"Packets Received/sec",
"Packets Sent/sec"
],
"resources": [
"*"
],
"append_dimensions": {
"d3": "win_bo"
}
},
"System": {
"measurement": [
"Context Switches/sec",
"System Calls/sec",
"Processor Queue Length"
],
"append_dimensions": {
"d1": "win_foo",
"d2": "win_bar"
}
}
},
"append_dimensions": {
"ImageId": "${aws:ImageId}",
"InstanceId": "${aws:InstanceId}",
"InstanceType": "${aws:InstanceType}",
"AutoScalingGroupName": "${aws:AutoScalingGroupName}"
},
"aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]]
}
}
```
## CloudWatch file konfigurasi agen: Bagian Log
`logs` bagian ini mencakup kolom berikut:
+ `service.name` – Opsional. Menentukan nama layanan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `deployment.environment` – Opsional. Menentukan nama lingkungan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `backpressure_mode` – Opsional. Menentukan perilaku ketika CloudWatch agen menelan log lebih cepat daripada yang dapat dikirim ke CloudWatch Log, menghasilkan tekanan balik. Tekanan balik dapat terjadi dari masalah jaringan, pelambatan API, atau volume log tinggi.
Agen mendukung nilai-nilai berikut:
+ `fd_release`— Merilis deskriptor file untuk file yang dihapus selama kondisi tekanan balik. Opsi ini dapat membantu mencegah kelelahan ruang disk ketika rotasi log eksternal atau proses pembersihan menghapus file sementara agen mempertahankan deskriptor file terbuka. `auto_removal`Opsi ini lebih diutamakan daripada `backpressure_mode` opsi yang disetel ke. `fd_release` Ketika `auto_removal` diaktifkan, CloudWatch agen memproses file hingga selesai tanpa melepaskan deskriptor file.
**penting**
Menggunakan `fd_release` dapat mengakibatkan CloudWatch agen tidak dapat membaca file log hingga selesai, menyebabkan kehilangan log.
+ `concurrency` – Opsional. Menentukan jumlah penerbit log bersama yang digunakan untuk mempublikasikan file log secara bersamaan ke Log. CloudWatch
Jika Anda menghilangkan bidang ini, setiap tujuan file log (grup log, kombinasi aliran) memiliki satu penerbit log bersama, yang dapat menyebabkan kemacetan untuk file besar atau saat menulis beberapa file ke tujuan yang sama. Mengaktifkan konkurensi dapat membantu dengan throughput.
+ `logs_collected` – Wajib jika bagian `logs` ini disertakan. Menentukan file log dan log kejadian Windows mana yang harus dikumpulkan dari server. Ini dapat mencakup dua bidang, `files` dan `windows_events`.
+ `files`— Menentukan file log reguler CloudWatch agen untuk mengumpulkan. Ini berisi satu bidang, `collect_list`, yang selanjutnya mendefinisikan file-file ini.
+ `collect_list` – Wajib jika `files` disertakan. Berisi serangkaian entri, masing-masing menentukan satu file log yang akan dikumpulkan. Masing-masing entri ini dapat menyertakan kolom berikut:
+ `file_path`- Menentukan jalur file log untuk meng-upload ke CloudWatch Log. Aturan pencocokan lob Unix standar diterima, dengan tambahan `**` sebagai *bintang super besar*. Misalnya, menentukan `/var/log/**.log` menyebabkan semua `.log` file dalam `/var/log` pohon direktori yang akan dikumpulkan. Untuk contoh lainnya, silakan lihat [Glob Library](https://github.com/gobwas/glob).
Anda juga dapat menggunakan tanda bintang standar sebagai wildcard standar. Misalnya, `/var/log/system.log*` sesuaikan file seperti `system.log_1111`, `system.log_2222`, dan lainnya di `/var/log`.
Hanya file terbaru yang didorong ke CloudWatch Log berdasarkan waktu modifikasi file. Kami merekomendasikan bahwa Anda menggunakan wildcard untuk menentukan serangkaian file dari jenis yang sama, seperti `access_log.2018-06-01-01` dan `access_log.2018-06-01-02`, tetapi tidak banyak jenis file, seperti `access_log_80` dan `access_log_443`. Untuk menentukan beberapa jenis file, tambahkan log stream lain ke file konfigurasi agen sehingga setiap jenis file log pergi ke aliran log yang berbeda.
+ `auto_removal` – Opsional. Jika ini`true`, CloudWatch agen secara otomatis menghapus file log ini setelah membacanya dan telah diputar. Biasanya file log dihapus setelah seluruh isinya diunggah ke CloudWatch Log, tetapi jika agen mencapai EOF (akhir file) dan juga mendeteksi file log baru lainnya yang cocok dengan yang sama`file_path`, agen menghapus file LAMA, jadi Anda harus memastikan bahwa Anda sudah selesai menulis ke file LAMA sebelum membuat file BARU. [Pustaka penelusuran RUST](https://docs.rs/tracing/latest/tracing/) memiliki ketidakcocokan yang diketahui karena berpotensi membuat file log BARU dan kemudian masih mencoba menulis ke file log LAMA.
Agen hanya menghapus file lengkap dari log yang membuat beberapa file, seperti log yang membuat file terpisah untuk setiap tanggal. Jika lg terus menerus menulis ke file tunggal, log tersebut tidak dihapus.
Jika Anda sudah memiliki metode rotasi atau penghapusan file log, sebaiknya hapus kolom ini atau atur menjadi `false`.
Jika Anda menghilangkan kolom ini, nilai bawaan dari `false` digunakan.
+ `log_group_name` – Opsional. Menentukan apa yang harus digunakan sebagai nama grup log di CloudWatch Log.
Kami sarankan Anda untuk menggunakan bidang ini untuk menentukan nama grup log untuk mencegah kebingungan. Jika Anda menghilangkan `log_group_name`, nilai dari `file_path` hingga titik terakhir digunakan sebagai nama grup log. Sebagai contoh, jika alur filenya `/tmp/TestLogFile.log.2017-07-11-14`, nama grup log adalah `/tmp/TestLogFile.log`.
Jika Anda menentukan sebuah nama grup log, Anda dapat menggunakan `{instance_id}`, `{hostname}`, `{local_hostname}`, dan `{ip_address}` sebagai variabel dalam nama tersebut. `{hostname}` mengambil nama host dari metadata EC2, dan `{local_hostname}` menggunakan nama host dari file konfigurasi jaringan.
Jika Anda menggunakan variabel ini untuk membuat banyak grup log yang berbeda, ingatlah batas 1.000.000 grup log per Wilayah per akun.
Karakter yang diperbolehkan termasuk a–z, A–Z, 0–9, '\$1' (garis bawah), '-' (tanda hubung), '/' (garis miring berikutnya), dan '.' (period).
+ `log_group_class` – Opsional. Menentukan kelas grup log mana yang akan digunakan untuk grup log baru. Untuk informasi selengkapnya tentang kelas grup log, silakan lihat [Kelas log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html).
Nilai yang valid adalah `STANDARD` dan `INFREQUENT_ACCESS`. Jika Anda menghilangkan bidang ini, `STANDARD` default akan digunakan.
**penting**
Setelah sebuah grup log dibuat, kelas log itu tidak dapat diubah.
+ `log_stream_name` – Opsional. Menentukan apa yang harus digunakan sebagai nama log stream di CloudWatch Log. Sebagai bagian dari nama, Anda dapat menggunakan `{instance_id}`, `{hostname}`, `{local_hostname}`, dan `{ip_address}` sebagai variabel dalam nama. `{hostname}` mengambil nama host dari metadata EC2, dan `{local_hostname}` menggunakan nama host dari file konfigurasi jaringan.
Jika Anda menghilangkan kolom ini, nilai `log_stream_name` di seluruh dunia `logs` yang digunakan. Jika itu juga dihilangkan, nilai bawaan `{instance_id}` digunakan.
Jika belum ada, maka aliran log stream akan dibuat secara otomatis.
+ `retention_in_days` – Opsional. Menentukan jumlah hari untuk mempertahankan log acara dalam grup log yang ditentukan.
+ Jika agen tersebut membuat grup log ini sekarang, dan Anda menghilangkan bidang ini, maka retensi grup log baru ini akan diatur untuk tidak pernah mengalami kedaluwarsa.
+ Jika grup log ini sudah ada dan Anda menentukan bidang ini, maka retensi baru yang Anda tentukan akan digunakan. Jika Anda menghilangkan bidang ini untuk grup log yang sudah ada, maka retensi grup log tidak akan diubah.
Wizard CloudWatch agen digunakan `-1` sebagai nilai default untuk bidang ini saat digunakan untuk membuat file konfigurasi agen dan Anda tidak menentukan nilai untuk retensi log. `-1`Nilai yang ditetapkan oleh wizard ini menentukan bahwa peristiwa dalam grup log tidak akan pernah kedaluwarsa. Namun demikian, mengedit nilai ini secara manual tidak `-1` berpengaruh.
Nilai yang valid adalah 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1.827, 2.192, 2.557, 2.922, 3.288, dan 3.653
Jika Anda mengonfigurasi agen untuk menulis beberapa aliran log stream ke grup log yang sama, menentukan `retention_in_days` di satu tempat akan mengatur retensi log untuk seluruh grup log. Jika Anda menentukan `retention_in_days` untuk grup log yang sama di beberapa tempat, maka retensi akan disetel jika semua nilai tersebut sama. Namun demikian, jika `retention_in_days` nilai yang berbeda ditentukan untuk grup log yang sama di beberapa tempat, retensi log tidak akan disetel dan agen akan berhenti, mengembalikan kesalahan.
**catatan**
Peran IAM atau pengguna IAM yang dimiliki agen harus memiliki `logs:PutRetentionPolicy` agar dapat menetapkan kebijakan retensi.
**Awas**
Jika Anda menetapkan `retention_in_days` untuk sebuah grup log yang sudah ada, maka semua log dalam grup log yang diterbitkan sebelum jumlah hari yang Anda tentukan akan dihapus. Sebagai contoh, menyetelnya menjadi 3 akan menyebabkan semua log dari 3 hari yang lalu dan sebelumnya dihapus.
+ `filters` – Opsional. Dapat berisi array entri, yang masing-masing menentukan ekspresi reguler dan jenis filter untuk menentukan apakah akan menerbitkan atau menjatuhkan entri log yang cocok dengan filter. Jika Anda menghilangkan bidang ini, semua log dalam file log dipublikasikan ke CloudWatch Log. Jika Anda menyertakan bidang ini, agen akan memproses setiap pesan log dengan semua filter yang Anda tentukan, dan hanya peristiwa log yang meneruskan semua filter yang dipublikasikan ke CloudWatch Log. Entri log yang tidak melewati semua filter akan tetap berada di file log host, tetapi tidak akan dikirim ke CloudWatch Log.
Setiap entri dalam larik filter dapat mencakup bidang berikut:
+ `type`– Menunjukkan jenis filter. Nilai yang valid adalah `include` dan `exclude`. Dengan`include`, entri log harus cocok dengan ekspresi yang akan dipublikasikan ke CloudWatch Log. Dengan`exclude`, setiap entri log yang cocok dengan filter tidak dikirim ke CloudWatch Log.
+ `expression`— Sebuah string ekspresi reguler yang mengikuti [RE2 Sintaks](https://github.com/google/re2/wiki/Syntax).
**catatan**
CloudWatch Agen tidak memeriksa kinerja ekspresi reguler apa pun yang Anda berikan, atau membatasi waktu proses evaluasi ekspresi reguler. Kami menyarankan Anda berhati-hati untuk tidak menulis ekspresi yang sulit untuk dievaluasi. Untuk informasi selengkapnya tentang kemungkinan masalah, lihat [Ekspresi reguler Denial of Service - ReDo S](https://owasp.org/www-community/attacks/Regular_expression_Denial_of_Service_-_ReDoS)
Misalnya, kutipan berikut dari file konfigurasi CloudWatch agen menerbitkan log yang PUT dan POST permintaan ke Log, tetapi tidak termasuk CloudWatch log yang berasal dari Firefox.
```
"collect_list": [
{
"file_path": "/opt/aws/amazon-cloudwatch-agent/logs/test.log",
"log_group_name": "test.log",
"log_stream_name": "test.log",
"filters": [
{
"type": "exclude",
"expression": "Firefox"
},
{
"type": "include",
"expression": "P(UT|OST)"
}
]
},
.....
]
```
**catatan**
Urutan filter dalam file konfigurasi penting untuk performa. Dalam contoh sebelumnya, agen menjatuhkan semua log yang cocok `Firefox` sebelum mulai mengevaluasi filter kedua. Untuk menyebabkan lebih sedikit entri log dievaluasi oleh lebih dari satu filter, letakkan filter yang Anda harapkan untuk mengesampingkan lebih banyak log terlebih dahulu di file konfigurasi.
+ `timezone` – Opsional. Menentukan zona waktu yang akan digunakan saat menempatkan stempel waktu pada kejadian log. Nilai yang valid adalah `UTC` dan `Local`. Nilai bawaannya adalah `Local`.
Parameter ini diabaikan jika Anda tidak menentukan nilai untuk `timestamp_format`.
+ `timestamp_format` – Opsional. Menentukan format stempel waktu, menggunakan teks biasa dan simbol khusus yang dimulai dengan %. Jika Anda menghilangkan bidang ini, waktu saat ini akan digunakan. Jika menggunakan kolom ini, Anda dapat menggunakan simbol dalam daftar berikut sebagai bagian dari format.
**catatan**
Parameter ini tidak dipertimbangkan ketika `file_path` diatur ke `amazon-cloudwatch-agent.log`
Jika satu entri log berisi dua stempel waktu yang cocok dengan format, maka stempel pertama akan digunakan.
Daftar simbol ini berbeda dari daftar yang digunakan oleh yang lebih lama CloudWatch Agen log. Untuk rangkuman perbedaan ini, silakan lihat [Perbedaan stempel waktu antara CloudWatch agen dan agen Log sebelumnya CloudWatch](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-logs-timestamp-differences)
`%y`
Tahun tanpa abad sebagai angka desimal penambah nol. Misalnya, `19` untuk mewakili 2019.
`%Y`
Tahun dengan abad sebagai angka desimal. Misalnya, `2019`.
`%b`
Bulan sebagai nama singkat lokal
`%B`
Bulan sebagai nama lengkap daerah
`%m`
Bulan sebagai angka desimal bernilai nol
`%-m`
Bulan sebagai angka desimal (bukan nol-tambahan)
`%d`
Tanggal dalam bulan sebagai angka desimal bernilai nol
`%-d`
Tanggal dalam bulan sebagai angka desimal (bukan nol-tambahan)
`%A`
Nama lengkap hari kerja, seperti `Monday`
`%a`
Singkatan hari kerja, seperti `Mon`
`%H`
Jam (dalam waktu 24 jam) sebagai angka desimal bernilai nol
`%I`
Jam (dalam waktu 12 jam) sebagai angka desimal bernilai nol
`%-I`
Jam (dalam waktu 12 jam) sebagai angka desimal (bukan nol tambahan)
`%p`
Pagi atau Sore
`%M`
Menit sebagai angka desimal penambah nol
`%-M`
Menit sebagai angka desimal (bukan penambahan nol)
`%S`
Detik sebagai angka desimal nol-padded
`%-S`
Detik sebagai angka desimal (bukan nol padded)
`%f`
detik pecah sebagai angka desimal (1-9 digit), penambahan nol di sebelah kiri.
`%Z`
Zona waktu, misalnya `PST`
`%z`
Zona waktu, dinyatakan sebagai offset antara zona waktu lokal dan UTC. Sebagai contoh, `-0700`. Hanya format ini yang didukung. Misalnya, `-07:00` bukan format yang valid.
+ `multi_line_start_pattern` – Menentukan pola untuk mengidentifikasi awal pesan log. Pesan log dibuat dari garis yang sesuai dengan pola dan setiap garis berikutnya yang tidak cocok dengan pola.
Jika Anda menghilangkan kolom ini, mode multi-line dinonaktifkan, dan semua garis yang dimulai dengan karakter non-ruangan putih menutup pesan log sebelumnya dan memulai pesan log baru.
Jika Anda menyertakan bidang ini, Anda dapat menentukan `{timestamp_format}` menggunakan ekspresi reguler yang sama dengan format stempel waktu Anda. Jika tidak, Anda dapat menentukan ekspresi reguler yang berbeda untuk CloudWatch Log yang akan digunakan untuk menentukan baris awal entri multi-baris.
+ `encoding` – Menentukan pengkodean file log sehingga dapat dibaca dengan benar. Jika Anda menentukan kode yang salah, mungkin ada kehilangan data karena karakter yang tidak dapat didekodekan diganti dengan karakter lain.
Nilai bawaannya adalah `utf-8`. Berikut ini adalah semua nilai yang mungkin:
`ascii, big5, euc-jp, euc-kr, gbk, gb18030, ibm866, iso2022-jp, iso8859-2, iso8859-3, iso8859-4, iso8859-5, iso8859-6, iso8859-7, iso8859-8, iso8859-8-i, iso8859-10, iso8859-13, iso8859-14, iso8859-15, iso8859-16, koi8-r, koi8-u, macintosh, shift_jis, utf-8, utf-16, utf-16le, UTF-16, UTF-16LE, windows-874, windows-1250, windows-1251, windows-1252, windows-1253, windows-1254, windows-1255, windows-1256, windows-1257, windows-1258, x-mac-cyrillic`
+ `service.name` – Opsional. Menentukan nama layanan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `deployment.environment` – Opsional. Menentukan nama lingkungan yang akan digunakan untuk mengisi entitas untuk [menemukan telemetri terkait](ExploreRelated.md).
+ `trim_timestamp` – Opsional. Jika ini benar, CloudWatch agen akan menghapus stempel waktu yang cocok dengan `timestamp_format` dari baris sebelum mengirimnya ke Log. CloudWatch LogEvent Wasiat masih berisi `timestamp` bidang.
Jika Anda menghilangkan kolom ini, nilai bawaan dari `false` digunakan.
+ `windows_events` menentukan jenis peristiwa Windows yang dikumpulkan dari server yang menjalankan Server Windows. Ini mencakup kolom-kolom berikut:
+ `collect_list` – Wajib jika `windows_events` disertakan. Menentukan jenis dan tingkat acara Windows yang akan dikumpulkan. Setiap log yang akan dikumpulkan memiliki entri di bagian ini, yang dapat mencakup kolom berikut:
+ `event_name` – Menentukan jenis peristiwa Windows untuk log. Ini setara dengan nama saluran log peristiwa Windows: misalnya, `System`, `Security`, `Application`, dan sebagainya. Bidang ini diperlukan untuk setiap jenis peristiwa Windows yang akan dicatat log-nya.
**catatan**
Saat CloudWatch mengambil pesan dari saluran log Windows, ia mencari saluran log berdasarkan `Full Name` propertinya. Sementara itu, panel navigasi Peraga Peristiwa Windows menampilkan properti `Log Name` saluran log. `Full Name` dan `Log Name` tidak selalu cocok. Untuk mengonfirmasi saluran `Full Name`, klik kanan di penampil Windows Event dan buka **Properti**.
+ `event_levels` – Opsional. Menentukan tingkat acara untuk log. Anda harus menentukan setiap level yang akan dicatat log-nya. Nilai yang mungkin termasuk adalah `INFORMATION`, `WARNING`, `ERROR`, `CRITICAL`, dan `VERBOSE`. Bidang ini opsional untuk setiap jenis acara Windows untuk log. dan dapat digunakan dengan opsi penyaringan lain seperti `event_ids` dan. `filters`
+ `event_ids` – Opsional. Berisi array Peristiwa Windows IDs untuk menentukan peristiwa mana yang akan dikumpulkan dari Log Peristiwa Windows. Ketika bidang ini dikecualikan, semua peristiwa dari log peristiwa yang ditentukan dikumpulkan. Ketika bidang ini disertakan, agen hanya mengumpulkan acara yang cocok dengan Acara yang ditentukan. IDs
Setiap entri dalam `event_ids` array harus berupa nilai ID Peristiwa numerik dan dapat digunakan dengan opsi penyaringan lainnya. Lihat entri ketiga dalam contoh konfigurasi di bawah ini.
**catatan**
Penggunaan `event_ids` untuk pemfilteran disarankan melalui ekspresi regex saat Anda perlu memfilter berdasarkan ID Peristiwa, karena memberikan kinerja yang lebih baik.
+ `filters` – Opsional. Berisi array entri. Setiap entri menentukan ekspresi reguler dan jenis filter untuk menentukan apakah akan mempublikasikan atau menjatuhkan entri log yang cocok dengan filter. Saat bidang disertakan, agen memproses setiap pesan log dengan semua filter yang Anda tentukan, dan hanya peristiwa log yang meneruskan semua filter yang dipublikasikan ke CloudWatch Log. Log peristiwa windows yang tidak melewati semua filter akan dijatuhkan dan tidak dikirim ke CloudWatch Log. Bagian filter juga dapat digunakan dengan mekanisme penyaringan lain seperti id peristiwa [4624, 4625] dan tingkat sistem (Informasi, Kesalahan, atau Kritis) untuk secara efektif memfilter log dan mendorong ke. CloudWatch
Setiap entri dalam larik filter dapat mencakup bidang berikut:
+ `type`- Menentukan jenis filter. Nilai yang valid adalah `include` dan `exclude`. Dengan include, entri peristiwa windows harus cocok dengan ekspresi yang akan dipublikasikan ke CloudWatch Log. Dengan pengecualian, setiap entri log peristiwa windows yang cocok dengan filter tidak dikirim ke CloudWatch Log.
+ `expression`— Sebuah string ekspresi reguler yang mengikuti RE2 Sintaks.
**catatan**
CloudWatch Agen tidak memvalidasi ekspresi reguler yang Anda berikan. Ini juga tidak membatasi waktu evaluasi mereka. Tulis ekspresi Anda dengan hati-hati untuk menghindari masalah kinerja. Untuk informasi selengkapnya tentang trik keamanan, lihat [Ekspresi reguler Denial of Service - ReDo S](https://owasp.org/www-community/attacks/Regular_expression_Denial_of_Service_-_ReDoS).
Dalam contoh konfigurasi agen di bawah ini:
Untuk entri pertama, agen mendorong log yang berisi pesan kegagalan database, aktivitas terkait otentikasi apa pun, dan semua peristiwa login (baik upaya yang berhasil maupun yang gagal). CloudWatch Log apa pun yang tidak cocok dengan pola ini akan dijatuhkan.
Pada entri kedua, pemfilteran awal dilakukan berdasarkan id acara untuk langganan acara windows. Agen mengumpulkan semua log yang berisi pengguna string, membuang log yang tidak cocok dengan pola ini. Agen kemudian menjatuhkan log yang berisi `successful` sebelum mengirim log yang tersisa ke CloudWatch Log. Setiap jenis filter diterapkan ke setiap log peristiwa windows sebelum dikirim ke CloudWatch.
```
"collect_list": [
{
"event_name": "Application",
"log_group_name": "ApplicationEvents",
"log_stream_name": "ApplicationEvents",
"filters": [
{
"type": "include",
"expression": "Database.*failed|Authentication.*|login.*"
}
]
},
{
"event_name": "System",
"log_group_name": "SystemEvents",
"log_stream_name": "Logon-events",
"event_ids": [
4624,
4625
],
"filters": [
{
"type": "include",
"expression": ".*user.*"
},
{
"type": "exclude",
"expression": ".*successful.*"
}
]
}
.....
]
```
**catatan**
Urutan filter dalam konfigurasi akan memengaruhi kinerja. Pada entri kedua, agen menjatuhkan semua log yang tidak cocok dengan pengguna sebelum mulai mengevaluasi ekspresi filter kedua. Untuk kinerja optimal, pesan filter dari tingkat pengecualian tertinggi ke terendah.
Meskipun Anda dapat memfilter log pada id peristiwa dan tingkat sistem dalam ekspresi filter, disarankan untuk menggunakan `event_ids` dan `log_level` seperti yang ditunjukkan pada entri kedua untuk meningkatkan kinerja.
**Awas**
Meskipun semua mekanisme penyaringan (event\$1levels, event\$1ids, filter) bersifat opsional, setidaknya satu diperlukan selama konfigurasi agen untuk memfilter log.
+ `log_group_name` – Wajib. Menentukan apa yang harus digunakan sebagai nama grup log di CloudWatch Log.
+ `log_stream_name` – Opsional. Menentukan apa yang harus digunakan sebagai nama log stream di CloudWatch Log. Sebagai bagian dari nama, Anda dapat menggunakan `{instance_id}`, `{hostname}`, `{local_hostname}`, dan `{ip_address}` sebagai variabel dalam nama. `{hostname}` mengambil nama host dari metadata EC2, dan `{local_hostname}` menggunakan nama host dari file konfigurasi jaringan.
Jika Anda menghilangkan kolom ini, nilai `log_stream_name` di seluruh dunia `logs` yang digunakan. Jika itu juga dihilangkan, nilai bawaan `{instance_id}` digunakan.
Jika belum ada, maka aliran log stream akan dibuat secara otomatis.
+ `event_format` – Opsional. Menentukan format yang akan digunakan saat menyimpan peristiwa Windows di CloudWatch Log. `xml`menggunakan format XMLseperti pada Windows Event Viewer. `text`menggunakan format agen CloudWatch Log lama.
+ `retention_in_days` – Opsional. Menentukan jumlah hari untuk mempertahankan acara Windows di grup log yang ditentukan.
+ Jika agen tersebut membuat grup log ini sekarang, dan Anda menghilangkan bidang ini, maka retensi grup log baru ini akan diatur untuk tidak pernah mengalami kedaluwarsa.
+ Jika grup log ini sudah ada dan Anda menentukan bidang ini, maka retensi baru yang Anda tentukan akan digunakan. Jika Anda menghilangkan bidang ini untuk grup log yang sudah ada, maka retensi grup log tidak akan diubah.
Wizard CloudWatch agen digunakan `-1` sebagai nilai default untuk bidang ini saat digunakan untuk membuat file konfigurasi agen dan Anda tidak menentukan nilai untuk retensi log. `-1` Nilai ini menentukan ditetapkan oleh pemandu menentukan bahwa peristiwa dalam grup log tidak kedaluwarsa. Namun demikian, mengedit nilai ini secara manual tidak `-1` berpengaruh.
Nilai yang valid adalah 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1.827, 2.192, 2.557, 2.922, 3.288, dan 3.653
Jika Anda mengonfigurasi agen untuk menulis beberapa aliran log stream ke grup log yang sama, menentukan `retention_in_days` di satu tempat akan mengatur retensi log untuk seluruh grup log. Jika Anda menentukan `retention_in_days` untuk grup log yang sama di beberapa tempat, maka retensi akan disetel jika semua nilai tersebut sama. Namun demikian, jika `retention_in_days` nilai yang berbeda ditentukan untuk grup log yang sama di beberapa tempat, retensi log tidak akan disetel dan agen akan berhenti, mengembalikan kesalahan.
**catatan**
Peran IAM atau pengguna IAM yang dimiliki agen harus memiliki `logs:PutRetentionPolicy` agar dapat menetapkan kebijakan retensi.
**Awas**
Jika Anda menetapkan `retention_in_days` untuk sebuah grup log yang sudah ada, maka semua log dalam grup log yang diterbitkan sebelum jumlah hari yang Anda tentukan akan dihapus. Sebagai contoh, menyetelnya menjadi 3 akan menyebabkan semua log dari 3 hari yang lalu dan sebelumnya dihapus.
+ `log_stream_name` – Opsional. Menentukan nama aliran log stream default yang akan digunakan untuk setiap log atau kejadian Windows yang tidak memiliki nama aliran log stream individu yang ditentukan di parameter `log_stream_name` dalam entri mereka di `collect_list`.
+ `endpoint_override` – Menentukan titik akhir FIPS atau tautan privat untuk digunakan sebagai titik akhir tempat agen mengirimkan log. Menentukan bidang ini dan mengatur tautan privat memungkinkan Anda mengirim log ke titik akhir VPC Amazon. Untuk informasi selengkapnya, silakan lihat [Apa Itu Amazon VPC?](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html).
Nilai dari `endpoint_override` harus string yang berupa URL.
Misalnya, bagian log berikut pada file konfigurasi mengatur agen untuk menggunakan Titik Akhir VPC saat mengirim log.
```
{
"logs": {
"endpoint_override": "vpce-XXXXXXXXXXXXXXXXXXXXXXXXX.logs.us-east-1.vpce.amazonaws.com",
......
},
}
```
+ `force_flush_interval` – Menentukan dalam hitungan detik lamanya waktu maksimum log tetap berada dalam buffer memori sebelum dikirim ke server. Apa pun pengaturan yang Anda tetapkan untuk bidang ini, jika ukuran log dalam penyangga mencapai 1 MB, log akan segera dikirim ke server saat itu juga. Nilai bawaannya adalah 5.
Jika Anda menggunakan agen untuk melaporkan metrik resolusi tinggi dalam format metrik tersemat, dan Anda menyetel alarm pada metrik tersebut, tetapkan parameter ini ke nilai default 5. Jika tidak, metrik dilaporkan dengan penundaan yang dapat menyebabkan kekhawatiran pada data sebagian atau tidak lengkap.
+ `credentials`- Menentukan peran IAM untuk digunakan saat mengirim log ke akun yang berbeda AWS . Jika ditentukan, bidang ini berisi satu parameter, `role_arn`.
+ `role_arn`— Menentukan ARN dari peran IAM untuk digunakan untuk otentikasi saat mengirim log ke akun yang berbeda. AWS Untuk informasi selengkapnya, lihat [Mengirim metrik, log, dan jejak ke akun lain](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-send-to-different-AWS-account). Jika disebutkan di sini, ini akan menggantikan `role_arn` yang ditentukan dalam `agent` dari file konfigurasi, jika ada.
+ `metrics_collected`— Bidang ini dapat berisi bagian untuk menentukan bahwa agen akan mengumpulkan log untuk mengaktifkan kasus penggunaan seperti Sinyal CloudWatch Aplikasi dan Wawasan Kontainer dengan peningkatan observabilitas untuk Amazon EKS.
+ `application_signals`(Opsional) Menentukan bahwa Anda ingin mengaktifkan [Sinyal CloudWatch Aplikasi](CloudWatch-Application-Monitoring-Sections.md) Untuk informasi lebih lanjut tentang konfigurasi ini, lihat[Aktifkan Sinyal CloudWatch Aplikasi](CloudWatch-Agent-Application_Signals.md).
+ `kubernetes` – Bidang ini dapat berisi `enhanced_container_insights` parameter, yang dapat Anda gunakan untuk mengaktifkan Wawasan Kontainer dengan peningkatan observabilitas untuk Amazon EKS.
+ `enhanced_container_insights` – Setel ini ke `true` untuk mengaktifkan Insights kontainer dengan peningkatan observabilitas untuk Amazon EKS. Untuk informasi selengkapnya, lihat [Wawasan Kontainer dengan peningkatan observabilitas untuk Amazon EKS](container-insights-detailed-metrics.md).
+ `accelerated_compute_metrics`— Setel ini `false` untuk memilih keluar dari pengumpulan metrik GPU Nvidia di kluster Amazon EKS. Untuk informasi selengkapnya, lihat [Metrik GPU NVIDIA](Container-Insights-metrics-enhanced-EKS.md#Container-Insights-metrics-EKS-GPU).
+ `emf` – Untuk mengumpulkan metrik yang disematkan dalam log, tidak perlu lagi menambahkan `emf` bidang ini. Ini adalah bidang warisan yang menentukan bahwa agen akan mengumpulkan log yang berada dalam format metrik tersemat. Anda dapat membuat data metrik dari log ini. Untuk informasi selengkapnya, lihat [Menyematkan metrik dalam log](CloudWatch_Embedded_Metric_Format.md).
+ `otlp` – Opsional. Menentukan bahwa Anda ingin mengumpulkan metrik dari SDK. OpenTelemetry Untuk informasi selengkapnya tentang bidang yang dapat Anda gunakan di bagian ini, lihat[Kumpulkan metrik dan jejak dengan OpenTelemetry](CloudWatch-Agent-OpenTelemetry-metrics.md).
Berikut ini adalah contoh bagian `logs`.
```
"logs":{
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log",
"log_group_name": "amazon-cloudwatch-agent.log",
"log_stream_name": "my_log_stream_name_1"
},
{
"file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\test.log",
"log_group_name": "test.log",
"log_stream_name": "my_log_stream_name_2"
}
]
},
"windows_events": {
"collect_list": [
{
"event_name": "System",
"event_ids": [
1001,
1008
],
"log_group_name": "System",
"log_stream_name": "System"
},
{
"event_name": "CustomizedName",
"event_levels": [
"INFORMATION",
"ERROR"
],
"log_group_name": "CustomizedLogGroup",
"log_stream_name": "CustomizedLogStream"
},
{
"event_name": "Application",
"event_levels": [
"INFORMATION",
"ERROR"
],
"event_ids":[
7369,
5624
],
"log_group_name": "CustomizedLogGroup",
"log_stream_name": "CustomizedLogStream"
}
]
}
},
"log_stream_name": "my_log_stream_name",
"metrics_collected": {
"kubernetes": {
"enhanced_container_insights": true
}
}
}
```
## CloudWatch file konfigurasi agen: Bagian Jejak
Dengan menambahkan `traces` bagian ke file konfigurasi CloudWatch agen, Anda dapat mengaktifkan Sinyal CloudWatch Aplikasi atau mengumpulkan jejak dari X-Ray dan dari SDK OpenTelemetry instrumentasi dan mengirimkannya ke X-Ray.
**penting**
Peran IAM agen atau pengguna IAM harus memiliki **AWSXrayWriteOnlyAccess**kebijakan untuk mengirim data jejak ke X-Ray.
Untuk memulai dengan cepat untuk mengumpulkan jejak, Anda dapat menambahkan hanya yang berikut ke file konfigurasi CloudWatch agen.
```
"traces_collected": {
"xray": {
},
"otlp": {
}
}
```
Jika Anda menambahkan bagian sebelumnya ke file konfigurasi CloudWatch agen dan memulai ulang agen, ini menyebabkan agen mulai mengumpulkan jejak menggunakan opsi dan nilai default berikut. Untuk informasi selengkapnya tentang parameter ini, silakan lihat definisi parameter nanti di bagian ini.
```
"traces_collected": {
"xray": {
"bind_address": "127.0.0.1:2000",
"tcp_proxy": {
"bind_address": "127.0.0.1:2000"
}
},
"otlp": {
"grpc_endpoint": "127.0.0.1:4317",
"http_endpoint": "127.0.0.1:4318"
}
}
```
Bagian `traces` dapat mencakup bidang-bidang berikut:
+ `traces_collected` – Wajib jika bagian `traces` ini disertakan. Menentukan yang SDKs untuk mengumpulkan jejak dari. Hal ini dapat mencakup kolom berikut:
+ `application_signals` – Opsional. Menentukan bahwa Anda ingin mengaktifkan [Sinyal CloudWatch Aplikasi](CloudWatch-Application-Monitoring-Sections.md) Untuk informasi lebih lanjut tentang konfigurasi ini, lihat[Aktifkan Sinyal CloudWatch Aplikasi](CloudWatch-Agent-Application_Signals.md).
+ `xray` – Opsional. Menentukan bahwa Anda ingin mengumpulkan jejak dari X-Ray SDK. Bagian ini dapat mencakup bidang-bidang berikut:
+ `bind_address` – Opsional. Menentukan alamat UDP untuk CloudWatch agen yang akan digunakan untuk mendengarkan jejak X-Ray. Formatnya adalah `ip:port`. Alamat ini harus sesuai dengan alamat yang ditetapkan dalam X-Ray SDK.
Jika Anda menghilangkan bidang ini, `127.0.0.1:2000` default akan digunakan.
+ `tcp_proxy` – Opsional. Mengkonfigurasi alamat untuk proxy yang digunakan untuk mendukung X-Ray remote sampling. Untuk informasi selengkapnya, silakan lihat [Configuring sampling rules](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-sampling.html) dalam dokumentasi X-Ray.
Bagian ini dapat berisi kolom berikut.
+ `bind_address` – Opsional. Menentukan alamat TCP yang CloudWatch agen harus mengatur proxy. Formatnya adalah `ip:port`. Alamat ini harus sesuai dengan alamat yang ditetapkan dalam X-Ray SDK.
Jika Anda menghilangkan bidang ini, `127.0.0.1:2000` default akan digunakan.
+ `otlp` – Opsional. Menentukan bahwa Anda ingin mengumpulkan jejak dari OpenTelemetry SDK. Untuk informasi selengkapnya tentang bidang yang dapat Anda gunakan di bagian ini, lihat[Kumpulkan metrik dan jejak dengan OpenTelemetry](CloudWatch-Agent-OpenTelemetry-metrics.md)). Untuk informasi selengkapnya tentang AWS Distro OpenTelemetry, lihat [AWS Distro](https://aws.amazon.com/otel/) untuk. OpenTelemetry Untuk informasi selengkapnya tentang AWS Distro OpenTelemetry SDKs, lihat [Pendahuluan](https://aws-otel.github.io/docs/introduction).
Bagian ini dapat mencakup bidang-bidang berikut:
+ `grpc_endpoint` – Opsional. Menentukan alamat CloudWatch agen yang akan digunakan untuk mendengarkan OpenTelemetry jejak yang dikirim menggunakan Panggilan Prosedur Jarak Jauh gRPC. Formatnya adalah `ip:port`. Alamat ini harus cocok dengan alamat yang ditetapkan untuk eksportir gRPC di SDK. OpenTelemetry
Jika Anda menghilangkan bidang ini, `127.0.0.1:4317` default akan digunakan.
+ `http_endpoint` – Opsional. Menentukan alamat untuk CloudWatch agen yang akan digunakan untuk mendengarkan jejak OTLP yang dikirim melalui HTTP. Formatnya adalah `ip:port`. Alamat ini harus cocok dengan alamat yang ditetapkan untuk eksportir HTTP di OpenTelemetry SDK.
Jika Anda menghilangkan bidang ini, `127.0.0.1:4318` default akan digunakan.
+ `concurrency` – Opsional. Menentukan jumlah maksimal panggilan bersamaan ke X-Ray yang dapat digunakan untuk meng-upload jejak. Nilai bawaannya adalah `8`.
+ `local_mode` – Opsional. Jika `true`, agen tidak mengumpulkan metadata instans Amazon EC2. Bawaannya adalah `false`
+ `endpoint_override` – Opsional. Menentukan endpoint FIPS atau link pribadi untuk digunakan sebagai endpoint di mana agen mengirimkan jejak. CloudWatch Menentukan bidang ini dan mengatur tautan privat memungkinkan Anda mengirim jejak ke titik akhir VPC Amazon. Untuk informasi selengkapnya, silakan lihat [Apa Itu Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html)
Nilai dari `endpoint_override` harus berupa string yang berupa URL.
+ `region_override` – Opsional. Menentukan Wilayah yang akan digunakan untuk titik akhir X-Ray. CloudWatch Agen mengirimkan jejak ke X-Ray di Wilayah yang ditentukan. Jika Anda menghilangkan bidang ini, agen akan mengirimkan jejak ke Wilayah tempat instans Amazon EC2 berada.
Jika Anda menentukan Wilayah di sini, itu lebih diutamakan daripada pengaturan `region` parameter di `agent` bagian file konfigurasi.
+ `proxy_override` – Opsional. Menentukan alamat server proxy untuk CloudWatch agen yang akan digunakan saat mengirim permintaan ke X-Ray. Protokol server proksi harus ditentukan sebagai bagian dari alamat ini.
+ `credentials`— Menentukan peran IAM untuk digunakan saat mengirim jejak ke akun yang berbeda AWS . Jika ditentukan, bidang ini berisi satu parameter, `role_arn`.
+ `role_arn`— Menentukan ARN peran IAM yang akan digunakan untuk otentikasi saat mengirim jejak ke akun yang berbeda. AWS Untuk informasi selengkapnya, lihat [Mengirim metrik, log, dan jejak ke akun lain](CloudWatch-Agent-common-scenarios.md#CloudWatch-Agent-send-to-different-AWS-account). Jika disebutkan di sini, ini akan menggantikan `role_arn` yang ditentukan dalam `agent` dari file konfigurasi, jika ada.
+ `transit_spans_in_otlp_format` – Opsional. Jika`true`, mengirimkan jejak ke X-Ray dalam format OpenTelemetry Protokol, yang mendukung peristiwa rentang di Pencarian Transaksi. Untuk informasi selengkapnya, lihat [Menambahkan atribut khusus](CloudWatch-Transaction-Search-add-custom-attributes.md). Nilai default-nya `false`.
## CloudWatch file konfigurasi agen: Contoh lengkap
Berikut ini adalah contoh file konfigurasi CloudWatch agen lengkap untuk server Linux.
Item yang tercantum dalam `measurement` bagian untuk metrik yang ingin Anda kumpulkan dapat menentukan nama metrik lengkap atau hanya sebagian nama metrik yang akan ditambahkan ke jenis sumber daya. Misalnya, menentukan `reads` atau `diskio_reads` dalam `measurement` bagian dari `diskio` bagian ini akan menyebabkan `diskio_reads` metrik yang akan dikumpulkan.
Contoh ini mencakup kedua cara menentukan metrik dalam `measurement` bagian.
```
{
"agent": {
"metrics_collection_interval": 10,
"logfile": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log"
},
"metrics": {
"namespace": "MyCustomNamespace",
"metrics_collected": {
"cpu": {
"resources": [
"*"
],
"measurement": [
{"name": "cpu_usage_idle", "rename": "CPU_USAGE_IDLE", "unit": "Percent"},
{"name": "cpu_usage_nice", "unit": "Percent"},
"cpu_usage_guest"
],
"totalcpu": false,
"metrics_collection_interval": 10,
"append_dimensions": {
"customized_dimension_key_1": "customized_dimension_value_1",
"customized_dimension_key_2": "customized_dimension_value_2"
}
},
"disk": {
"resources": [
"/",
"/tmp"
],
"measurement": [
{"name": "free", "rename": "DISK_FREE", "unit": "Gigabytes"},
"total",
"used"
],
"ignore_file_system_types": [
"sysfs", "devtmpfs"
],
"metrics_collection_interval": 60,
"append_dimensions": {
"customized_dimension_key_3": "customized_dimension_value_3",
"customized_dimension_key_4": "customized_dimension_value_4"
}
},
"diskio": {
"resources": [
"*"
],
"measurement": [
"reads",
"writes",
"read_time",
"write_time",
"io_time"
],
"metrics_collection_interval": 60
},
"swap": {
"measurement": [
"swap_used",
"swap_free",
"swap_used_percent"
]
},
"mem": {
"measurement": [
"mem_used",
"mem_cached",
"mem_total"
],
"metrics_collection_interval": 1
},
"net": {
"resources": [
"eth0"
],
"measurement": [
"bytes_sent",
"bytes_recv",
"drop_in",
"drop_out"
]
},
"netstat": {
"measurement": [
"tcp_established",
"tcp_syn_sent",
"tcp_close"
],
"metrics_collection_interval": 60
},
"processes": {
"measurement": [
"running",
"sleeping",
"dead"
]
}
},
"append_dimensions": {
"ImageId": "${aws:ImageId}",
"InstanceId": "${aws:InstanceId}",
"InstanceType": "${aws:InstanceType}",
"AutoScalingGroupName": "${aws:AutoScalingGroupName}"
},
"aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]],
"force_flush_interval" : 30
},
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
"log_group_name": "amazon-cloudwatch-agent.log",
"log_stream_name": "amazon-cloudwatch-agent.log",
"timezone": "UTC"
},
{
"file_path": "/opt/aws/amazon-cloudwatch-agent/logs/test.log",
"log_group_name": "test.log",
"log_stream_name": "test.log",
"timezone": "Local"
}
]
}
},
"log_stream_name": "my_log_stream_name",
"force_flush_interval" : 15,
"metrics_collected": {
"kubernetes": {
"enhanced_container_insights": true
}
}
}
}
```
Berikut ini adalah contoh file konfigurasi CloudWatch agen lengkap untuk server yang menjalankan Windows Server.
```
{
"agent": {
"metrics_collection_interval": 60,
"logfile": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log"
},
"metrics": {
"namespace": "MyCustomNamespace",
"metrics_collected": {
"Processor": {
"measurement": [
{"name": "% Idle Time", "rename": "CPU_IDLE", "unit": "Percent"},
"% Interrupt Time",
"% User Time",
"% Processor Time"
],
"resources": [
"*"
],
"append_dimensions": {
"customized_dimension_key_1": "customized_dimension_value_1",
"customized_dimension_key_2": "customized_dimension_value_2"
}
},
"LogicalDisk": {
"measurement": [
{"name": "% Idle Time", "unit": "Percent"},
{"name": "% Disk Read Time", "rename": "DISK_READ"},
"% Disk Write Time"
],
"resources": [
"*"
]
},
"customizedObjectName": {
"metrics_collection_interval": 60,
"customizedCounterName": [
"metric1",
"metric2"
],
"resources": [
"customizedInstances"
]
},
"Memory": {
"metrics_collection_interval": 5,
"measurement": [
"Available Bytes",
"Cache Faults/sec",
"Page Faults/sec",
"Pages/sec"
]
},
"Network Interface": {
"metrics_collection_interval": 5,
"measurement": [
"Bytes Received/sec",
"Bytes Sent/sec",
"Packets Received/sec",
"Packets Sent/sec"
],
"resources": [
"*"
],
"append_dimensions": {
"customized_dimension_key_3": "customized_dimension_value_3"
}
},
"System": {
"measurement": [
"Context Switches/sec",
"System Calls/sec",
"Processor Queue Length"
]
}
},
"append_dimensions": {
"ImageId": "${aws:ImageId}",
"InstanceId": "${aws:InstanceId}",
"InstanceType": "${aws:InstanceType}",
"AutoScalingGroupName": "${aws:AutoScalingGroupName}"
},
"aggregation_dimensions" : [["ImageId"], ["InstanceId", "InstanceType"], ["d1"],[]]
},
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log",
"log_group_name": "amazon-cloudwatch-agent.log",
"timezone": "UTC"
},
{
"file_path": "c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\test.log",
"log_group_name": "test.log",
"timezone": "Local"
}
]
},
"windows_events": {
"collect_list": [
{
"event_name": "System",
"event_levels": [
"INFORMATION",
"ERROR"
],
"log_group_name": "System",
"log_stream_name": "System",
"event_format": "xml"
},
{
"event_name": "CustomizedName",
"event_levels": [
"WARNING",
"ERROR"
],
"log_group_name": "CustomizedLogGroup",
"log_stream_name": "CustomizedLogStream",
"event_format": "xml"
}
]
}
},
"log_stream_name": "example_log_stream_name"
}
}
```
## Simpan file konfigurasi CloudWatch agen secara manual
Jika Anda membuat atau mengedit file konfigurasi CloudWatch agen secara manual, Anda dapat memberikan nama apa pun. Setelah Anda membuat file, Anda dapat menyalinnya ke server lain tempat Anda ingin menjalankan agen.
## Mengunggah file konfigurasi CloudWatch agen ke Systems Manager Parameter Store
Jika Anda berencana menggunakan Agen SSM untuk menginstal CloudWatch agen di server, setelah Anda mengedit file konfigurasi CloudWatch agen secara manual, Anda dapat mengunggahnya ke Systems Manager Parameter Store. Untuk melakukan hal itu, gunakan perintah Manajer Sistem `put-parameter`.
Untuk dapat menyimpan file di Parameter Store, Anda harus menggunakan peran IAM dengan izin yang memadai.
Gunakan perintah berikut, di *parameter name* mana nama yang akan digunakan untuk file ini di Parameter Store dan *configuration\$1file\$1pathname* merupakan jalur dan nama file dari file konfigurasi yang Anda edit.
```
aws ssm put-parameter --name "parameter name" --type "String" --value file://configuration_file_pathname
```