Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ambil metrik kustom dengan StatSD
Anda dapat mengambil metrik khusus tambahan dari aplikasi atau layanan menggunakan CloudWatch agen dengan `StatsD` protokol. StatsD adalah solusi open-source populer yang dapat mengumpulkan metrik dari berbagai macam aplikasi. StatsD sangat berguna untuk melengkapi metrik Anda sendiri. Untuk contoh penggunaan CloudWatch agen dan statSD bersama-sama, lihat [ Cara memonitor metrik aplikasi kustom Anda dengan lebih baik menggunakan CloudWatch Agen ](https://aws.amazon.com/blogs/devops/new-how-to-better-monitor-your-custom-application-metrics-using-amazon-cloudwatch-agent/) Amazon.
`StatsD`didukung pada server Linux dan server yang menjalankan Windows Server. CloudWatch mendukung `StatsD` format berikut:
```
{{MetricName}}:{{value}}|{{type}}|@{{sample_rate}}|#{{tag1}}:
{{value}},{{tag1}}...
```
+ `MetricName` – String tanpa titik dua, bar, \# karakter, atau @ karakter.
+ `value` – Ini dapat berupa integer atau float.
+ `type` – Tentukan `c` untuk konter, `g` untuk pengukur, `ms` untuk pengatur waktu, `h` untuk histogram, atau `s` untuk pengaturan.
+ `sample_rate` – (Opsional) Pengapungan antara 0 dan 1, inklusif. Gunakan hanya untuk counter, histogram, dan metrik timer. Nilai bawaannya adalah 1 (menampilkan 100% dari waktu).
+ `tags`— (Opsional) Daftar tag yang dipisahkan koma. `StatsD`tag mirip dengan dimensi di CloudWatch. Gunakan tanda titik dua untuk key/value tag, seperti`env:prod`.
Anda dapat menggunakan `StatsD` klien apa pun yang mengikuti format ini untuk mengirim metrik ke CloudWatch agen. Untuk informasi lebih lanjut tentang beberapa `StatsD` klien yang tersedia, lihat halaman klien [ StatsD di GitHub](https://github.com/etsy/statsd/wiki#client-implementations).
Untuk mengumpulkan metrik kustom ini, tambahkan `"statsd": {}` masuk ke `metrics_collected` bagian dari file konfigurasi agen. Anda dapat menambahkan baris ini secara manual. Jika Anda menggunakan pemandu untuk membuat file konfigurasi, sudah selesai untuk Anda. Untuk informasi selengkapnya, lihat [Buat file konfigurasi CloudWatch agen](create-cloudwatch-agent-configuration-file.md).
`StatsD` Konfigurasi default berfungsi untuk sebagian besar pengguna. Ada bidang opsional yang dapat Anda tambahkan ke bagian **statsd** dari file konfigurasi agen sesuai kebutuhan:
+ `service_address`— Alamat layanan yang harus di CloudWatch dengarkan oleh agen. Formatnya adalah `{{ip}}:{{port}}`. Jika Anda menghilangkan alamat IP, agen akan mendengarkan semua antarmuka yang tersedia. Hanya format UDP yang didukung, sehingga Anda tidak perlu menentukan prefiks UDP.
Nilai bawaannya adalah `:8125`.
+ `metrics_collection_interval` – Seberapa sering dalam hitungan detik `StatsD` plugin berjalan dan mengumpulkan metrik. Nilai bawaannya adalah 10 detik. Rentangnya adalah 1–172.000.
+ `metrics_aggregation_interval` – Seberapa sering dalam hitungan detik CloudWatch mengagregasi metrik menjadi titik data tunggal. Nilai bawaannya adalah 60 detik.
Misalnya, jika `metrics_collection_interval` 10 dan `metrics_aggregation_interval` 60, CloudWatch mengumpulkan data setiap 10 detik. Setelah setiap menit, enam pembacaan data dari menit tersebut dikumpulkan menjadi satu titik data, yang dikirim ke CloudWatch.
Rentangnya adalah 0–172.000. Pengaturan `metrics_aggregation_interval` menjadi 0 menonaktifkan agregasi `StatsD` metrik.
+ `allowed_pending_messages` – Jumlah pesan UDP yang diizinkan untuk mengantri. Ketika antrian penuh, server StatSD mulai menjatuhkan paket. Nilai bawaannya adalah 10000.
+ `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 ke CloudWatch, Anda dapat menentukan parameter ini dengan daftar metrik. Metrik yang ditentukan bersama dengan parameter ini tidak dilaporkan metrik berdasarkan dimensi CloudWatch. Sebaliknya, hanya metrik-metrik agregat saja yang dilaporkan. Hal ini akan mengurangi jumlah metrik yang dikumpulkan oleh agen, dan akan mengurangi biaya Anda.
Berikut ini adalah contoh bagian **statsd** dari file konfigurasi agen, menggunakan port default dan interval pengumpulan dan agregasi kustom.
```
{
"metrics":{
"metrics_collected":{
"statsd":{
"service_address":":8125",
"metrics_collection_interval":60,
"metrics_aggregation_interval":300
}
}
}
}
```
## Melihat metrik StatsD yang diimpor oleh agen CloudWatch
Setelah mengimpor metrik StatsD ke CloudWatch, Anda dapat melihat metrik ini sebagai grafik deret waktu, dan membuat alarm yang dapat menonton metrik ini dan memberi tahu Anda jika metrik tersebut melanggar ambang batas yang Anda tentukan. Prosedur berikut menunjukkan cara melihat metrik StatsD sebagai grafik deret waktu. Untuk informasi selengkapnya tentang menyetel alarm, silakan lihat [Menggunakan CloudWatch alarm Amazon](CloudWatch_Alarms.md).
**Untuk melihat metrik StatsD di konsol CloudWatch**
1. Buka CloudWatch konsol di [ https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Pada panel navigasi, silakan pilih **Metrik**.
1. Pilih namespace untuk metrik-metrik yang dikumpulkan oleh agen. Secara default, ini adalah ** CWAgent**, tetapi Anda mungkin telah menentukan namespace yang berbeda dalam file konfigurasi CloudWatch agen.
1. Pilih dimensi metrik (misalnya, ** Per-Instance Metrik**).
1. Tab **Jelajahi** menampilkan semua metrik untuk dimensi pada namespace. Anda dapat melakukan tindakan berikut:
1. Untuk membuat grafik sebuah metrik, pilih kotak centang di sebelah metrik. Untuk memilih semua metrik, pilih kotak centang di baris judul tabel.
1. Untuk menyortir tabel, gunakan judul kolomnya.
1. Untuk menyaring berdasarkan sumber daya, pilih ID sumber daya, kemudian pilih **Tambahkan ke pencarian**.
1. Untuk menyaring berdasarkan metrik, pilih nama metrik, kemudian pilih **Tambahkan ke pencarian**.
1. (Opsional) Untuk menambahkan grafik ini ke CloudWatch dasbor, pilih Tind ** akan**, ** Tambahkan ke dasbor**.