Buat atau edit file konfigurasi CloudWatch agen secara manual - Amazon CloudWatch
Simpan file konfigusi agen secara manualUnggah file konfigurasi CloudWatch agen ke Systems Manager Parameter Store

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 JSON file dengan empat bagian:agent,metrics,logs, dantraces.

  • agent bagian ini mencakup kolom untuk konfigurasi agen secara keseluruhan.

  • metricsBagian ini menentukan metrik kustom untuk pengumpulan dan penerbitan. CloudWatch Jika menggunakan agen hanya untuk mengumpulkan log, Anda dapat menghilangkan bagian metrics dari file.

  • logsBagian 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.

  • tracesBagian 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/amazon-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.

catatan

Metrik, log, dan jejak yang dikumpulkan oleh CloudWatch agen menimbulkan biaya. Untuk informasi selengkapnya tentang harga, lihat CloudWatch Harga Amazon.

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.

    Nilai bawaannya adalah 60.

  • region— Menentukan Wilayah yang akan digunakan untuk CloudWatch titik akhir saat EC2 instans Amazon 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 EC2 instans Amazon berada.

    Jika Anda memantau server on-premise, bidang ini tidak digunakan, dan agen membaca Wilayah dari profil AmazonCloudWatchAgent file konfigurasi AWS .

  • credentials— Menentukan IAM peran yang akan 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) IAM peran 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.

  • debug – Opsional. Menentukan menjalankan CloudWatch agen dengan pesan log debug. Nilai default-nya 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 AWS SDK titik akhir. 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.

  • 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 default-nya 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.

  • user_agent – Opsional. Menentukan user-agent string yang digunakan oleh CloudWatch agen ketika membuat API panggilan 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 untukusage_data. Jika Anda menghilangkan parameter ini, default true digunakan dan agen mengirimkan data kesehatan dan performa.

    Jika menetapkan nilai inifalse, Anda harus berhenti dan memulai ulang agen agar berlaku.

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"
  }

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 EC2 metrik Amazon 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 instance sebagai nilai 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 Anda menentukan nilai yang bergantung pada EC2 metadata Amazon dan Anda menggunakan proxy, Anda harus memastikan bahwa server dapat mengakses titik akhir untuk Amazon. EC2 Untuk informasi selengkapnya tentang titik akhir ini, lihat Amazon Elastic Compute Cloud EC2 (Amazon) 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 FIPS titik akhir atau tautan pribadi untuk digunakan sebagai titik akhir tempat agen mengirimkan metrik. Menentukan ini dan menyetel tautan pribadi memungkinkan Anda mengirim metrik ke titik akhir AmazonVPC. Untuk informasi selengkapnya, lihat Apa itu AmazonVPC? .

    Nilai endpoint_override harus berupa string yang merupakanURL.

    Misalnya, bagian berikut dari bagian metrik dari file konfigurasi menyetel agen untuk menggunakan VPC Titik Akhir 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.

  • 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 IAM peran yang akan digunakan saat mengirim metrik ke akun yang berbeda. Jika ditentukan, bidang ini berisi satu parameter, role_arn.

    • role_arn— Menentukan IAM peran ARN yang akan digunakan untuk otentikasi saat mengirim metrik ke akun yang berbeda. Untuk informasi selengkapnya, lihat Mengirim metrik, log, dan jejak ke akun lain. Jika ditentukan di sini, nilai ini akan menggantikan role_arn yang ditentukan dalam agent dari file konfigurasi, jika ada.

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.

  • cpu – Opsional. Menentukan bahwa CPU metrik yang akan dikumpulkan. Bagian ini hanya valid untuk instans Linux. Anda harus menyertakan setidaknya satu totalcpu bidang resources dan untuk setiap CPU metrik 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.

    • 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.

    • 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 yang AMI Anda gunakan dan jumlah EBS volume Amazon yang Anda lampirkan ke server.

      Untuk melihat satuan bawaan untuk setiap disk metrik, silakan lihat Metrik yang dikumpulkan oleh CloudWatch agen di instans Linux dan macOS.

      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.

    • 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.

      Default-nya adalah 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.

    • 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 kustom lainnya.

      • "VolumeId":"${aws:VolumeId}"menambahkan VolumeId dimensi ke metrik disk perangkat blok Anda. Untuk EBS volume Amazon, ini akan menjadi ID EBS Volume Amazon. EC2Misalnya toko, ini akan menjadi serial perangkat. Menggunakan ini membutuhkan drop_device parameter yang akan disetel kefalse.

  • diskio – Opsional. Menentukan bahwa metrik disk i/o 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.

    • 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 * sebagai nilai untuk mengumpulkan metrik dari semua perangkat.

    • measurement – Menentukan larik metrik diskio yang akan dikumpulkan. Kemungkinan nilai adalah reads, writes, read_bytes, write_bytes, read_time, write_time, io_time, dan iops_in_progress. 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.

    • 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.

    • 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.

      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.

    • 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.

    • 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, 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.

      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.

    • 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.

    • 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.

      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.

    • 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.

    • 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 status TCP koneksi dan metrik UDP koneksi 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.

      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.

    • 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.

    • 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.

    • 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.

    • 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 NVIDIA GPU metrik yang akan dikumpulkan. Bagian ini hanya berlaku untuk instance Linux pada host yang dikonfigurasi dengan NVIDIA GPU akselerator dan memiliki NVIDIA System Management Interface (nvidia-smi) diinstal.

    NVIDIAGPUMetrik 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 array NVIDIA GPU metrik yang akan dikumpulkan. Untuk daftar nilai yang mungkin digunakan di sini, silakan lihat kolom Metrik dalam tabel diKumpulkan NVIDIA GPU metrik.

      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.

    • metrics_collection_interval – Opsional. Menentukan seberapa sering mengumpulkan NVIDIA GPU metrik, mengesampingkan global yang metrics_collection_interval ditentukan di agent bagian file konfigurasi.

  • 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.

  • 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.

  • ethtool – Opsional. Menentukan bahwa Anda ingin mengambil metrik jaringan menggunakan plugin ethtool. Plugin ini dapat mengimpor metrik yang dikumpulkan oleh utilitas ethtool standar, serta metrik kinerja jaringan dari instans Amazon. EC2 Untuk informasi selengkapnya tentang opsi konfigurasi yang tersedia untuk ethtool, silakan lihat Mengumpulkan metrik performa jaringan.

Berikut ini adalah contoh metrics untuk server Linux. Dalam contoh ini, tiga CPU metrik, tiga metrik netstat, tiga metrik proses, dan satu metrik disk dikumpulkan, dan agen diatur untuk menerima metrik tambahan dari klien. collectd

"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 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.

  • 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 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.

Ada bagian opsional lain yang dapat Anda sertakan dalammetrics_collected:

  • statsd – Memungkinkan Anda mengambil kembali 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, lihat Ambil metrik kustom dengan StatSD.

  • procstat – Memungkinkan Anda mengambil metrik dari proses individu. Untuk informasi selengkapnya, lihat Kumpulkan Metrik Proses dengan Plugin procstat.

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"],[]]
    }
  }

logs bagian ini mencakup kolom berikut:

  • 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.

          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 initrue, 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 samafile_path, agen menghapus OLD file, jadi Anda harus memastikan bahwa Anda selesai menulis ke OLD file sebelum membuat file. NEW Pustaka RUST penelusuran memiliki ketidakcocokan yang diketahui karena berpotensi membuat file NEW log dan kemudian masih mencoba menulis ke file OLD log.

          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 nama grup log, Anda dapat menggunakan{instance_id},{hostname},{local_hostname}, dan {ip_address} sebagai variabel dalam nama. {hostname}mengambil nama host dari EC2 metadata, 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, '_' (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.

          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 EC2 metadata, 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. -1Nilai 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

          IAMPeran atau IAM pengguna agen harus memilikinya logs:PutRetentionPolicy agar dapat menetapkan kebijakan retensi. Untuk informasi selengkapnya, lihat Mengizinkan CloudWatch agen menyetel kebijakan retensi log.

          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. Denganinclude, entri log harus cocok dengan ekspresi yang akan dipublikasikan ke CloudWatch Log. Denganexclude, setiap entri log yang cocok dengan filter tidak dikirim ke CloudWatch Log.

          • expression— Sebuah string ekspresi reguler yang mengikuti RE2Sintaks.

            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

          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.

          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 agen CloudWatch Log lama. Untuk rangkuman perbedaan ini, silakan lihat Perbedaan stempel waktu antara CloudWatch agen terpadu dan agen Log sebelumnya CloudWatch

          %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 danUTC. Misalnya, -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

    • 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 – Menentukan tingkat-tingkat kejadian yang akan dicatat lognya. Anda harus menentukan setiap level yang akan dicatat log-nya. Nilai yang mungkin termasuk adalah INFORMATION, WARNING, ERROR, CRITICAL, dan VERBOSE. Bidang ini diperlukan untuk setiap jenis peristiwa Windows yang akan dicatat log-nya.

        • 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 EC2 metadata, 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. xmlmenggunakan XML format seperti pada Windows Event Viewer. textmenggunakan 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

          IAMPeran atau IAM pengguna agen harus memilikinya logs:PutRetentionPolicy agar dapat menetapkan kebijakan retensi. Untuk informasi selengkapnya, lihat Mengizinkan CloudWatch agen menyetel kebijakan retensi log.

          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 – Wajib. 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 FIPS endpoint atau link pribadi untuk digunakan sebagai endpoint di mana agen mengirim log. Menentukan bidang ini dan menyetel tautan pribadi memungkinkan Anda mengirim log ke titik VPC akhir Amazon. Untuk informasi selengkapnya, lihat Apa itu AmazonVPC? .

    Nilai endpoint_override harus berupa string yang merupakanURL.

    Misalnya, bagian berikut dari bagian log dari file konfigurasi menetapkan agen untuk menggunakan VPC Endpoint saat mengirim log. 

    {
  "logs": {
    "endpoint_override": "vpce-XXXXXXXXXXXXXXXXXXXXXXXXX.logs.us-east-1.vpce.amazonaws.com",
   ......
   },
}

  • force_flush_interval – Menentukan lamanya waktu maksimum log tetap berada dalam buffer memori sebelum dikirim ke server, dalam satuan detik. 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 IAM peran untuk digunakan saat mengirim log ke AWS akun yang berbeda. Jika ditentukan, bidang ini berisi satu parameter, role_arn.

    • role_arn— Menentukan IAM peran ARN yang akan digunakan untuk otentikasi saat mengirim log ke akun yang berbeda AWS . Untuk informasi selengkapnya, lihat Mengirim metrik, log, dan jejak ke akun lain. 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 Untuk informasi lebih lanjut tentang konfigurasi ini, lihatAktifkan Sinyal CloudWatch Aplikasi.

    • kubernetes— Bidang ini dapat berisi enhanced_container_insights parameter, yang dapat Anda gunakan untuk mengaktifkan Wawasan Kontainer dengan peningkatan observabilitas untuk Amazon. EKS

    • 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.

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",
                       "timestamp_format": "%H: %M: %S%y%b%-d"
                   },
                   {
                       "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_levels": [
                           "INFORMATION",
                           "ERROR"
                       ],
                       "log_group_name": "System",
                       "log_stream_name": "System"
                   },
                   {
                       "event_name": "CustomizedName",
                       "event_levels": [
                           "INFORMATION",
                           "ERROR"
                       ],
                       "log_group_name": "CustomizedLogGroup",
                       "log_stream_name": "CustomizedLogStream"
                   }
               ]
           }
       },
       "log_stream_name": "my_log_stream_name",
       "metrics_collected": {
           "kubernetes": {
                "enhanced_container_insights": true
      }
    }
  }

Dengan menambahkan traces bagian ke file konfigurasi CloudWatch agen, Anda dapat mengaktifkan Sinyal CloudWatch Aplikasi atau mengumpulkan jejak dari X-Ray dan dari OpenTelemetry instrumentasi SDK dan mengirimkannya ke X-Ray.

penting

IAMPeran agen atau IAM pengguna harus memiliki AWSXrayWriteOnlyAccesskebijakan untuk mengirim data jejak ke X-Ray. Untuk informasi selengkapnya, lihat Buat IAM peran dan pengguna untuk digunakan dengan CloudWatch agen.

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 Untuk informasi lebih lanjut tentang konfigurasi ini, lihatAktifkan Sinyal CloudWatch Aplikasi.

    • xray – Opsional. Menentukan bahwa Anda ingin mengumpulkan jejak dari SDK X-Ray. Bagian ini dapat mencakup bidang-bidang berikut:

      • bind_address – Opsional. Menentukan UDP alamat 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-RaySDK.

        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 dalam dokumentasi X-Ray.

        Bagian ini dapat berisi kolom berikut.

        • bind_address – Opsional. Menentukan TCP alamat yang CloudWatch agen harus mengatur proxy. Formatnya adalah ip:port. Alamat ini harus sesuai dengan alamat yang ditetapkan dalam X-RaySDK.

          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 lebih lanjut tentang AWS Distro OpenTelemetry, lihat AWS Distro untuk. OpenTelemetry Untuk informasi selengkapnya tentang AWS Distro OpenTelemetry SDKs, lihat Pendahuluan.

      Bagian ini dapat mencakup bidang-bidang berikut:

      • grpc_endpoint – Opsional. Menentukan alamat CloudWatch agen yang akan digunakan untuk mendengarkan OpenTelemetry jejak yang dikirim menggunakan g Panggilan Prosedur RPC Jarak Jauh. Formatnya adalah ip:port. Alamat ini harus sesuai dengan alamat yang ditetapkan untuk RPC eksportir g di. OpenTelemetry SDK

        Jika Anda menghilangkan bidang ini, 127.0.0.1:4317 default akan digunakan.

      • http_endpoint – Opsional. Menentukan alamat untuk CloudWatch agen untuk digunakan untuk mendengarkan OTLP jejak yang dikirimHTTP. Formatnya adalah ip:port. Alamat ini harus sesuai dengan alamat yang ditetapkan untuk HTTP eksportir 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. Jikatrue, agen tidak mengumpulkan metadata EC2 instans Amazon. Bawaannya adalah false

  • endpoint_override – Opsional. Menentukan FIPS endpoint atau link pribadi untuk digunakan sebagai endpoint di mana CloudWatch agen mengirimkan jejak. Menentukan bidang ini dan menyetel tautan pribadi memungkinkan Anda mengirim jejak ke titik VPC akhir Amazon. Untuk informasi selengkapnya, lihat Apa itu Amazon VPC

    Nilai endpoint_override harus berupa string yang merupakanURL.

  • 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 EC2 instans Amazon 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 IAM peran yang akan digunakan saat mengirim jejak ke AWS akun yang berbeda. Jika ditentukan, bidang ini berisi satu parameter, role_arn.

    • role_arn— Menentukan IAM peran ARN 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. Jika disebutkan di sini, ini akan menggantikan role_arn yang ditentukan dalam agent dari file konfigurasi, jika ada.

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. Untuk kemudahan dalam pemecahan masalah, kami sarankan Anda menamainya /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json di server Linux dan $Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json pada server yang menjalankan Server Windows. 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 SSM Agen 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 IAM peran dengan izin yang memadai. Untuk informasi selengkapnya, lihat Buat IAM peran dan pengguna untuk digunakan dengan CloudWatch agen.

Gunakan perintah berikut, di mana parameter name adalah nama yang akan digunakan untuk file ini di Toko Parameter dan configuration_file_pathname adalah alur dan nama file dari file konfigurasi yang Anda edit.

aws ssm put-parameter --name "parameter name" --type "String" --value file://configuration_file_pathname