Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Perpustakaan Produser Kinesis (KPL) untuk Amazon Kinesis Data Streams menerbitkan metrik Amazon khusus atas nama Anda. CloudWatch Anda dapat melihat metrik ini dengan menavigasi ke CloudWatch konsol
Ada biaya nominal untuk metrik yang diunggah CloudWatch oleh KPL; khususnya, biaya Amazon CloudWatch Custom Metrics dan CloudWatch Amazon API Requests berlaku. Untuk informasi selengkapnya, lihat CloudWatch Harga Amazon
Topik
Metrik, dimensi, dan ruang nama
Anda dapat menentukan nama aplikasi saat meluncurkan KPL, yang kemudian digunakan sebagai bagian dari namespace saat mengunggah metrik. Ini opsional; KPL memberikan nilai default jika nama aplikasi tidak disetel.
Anda juga dapat mengonfigurasi KPL untuk menambahkan dimensi tambahan yang sewenang-wenang ke metrik. Ini berguna jika Anda menginginkan data berbutir halus dalam metrik Anda. CloudWatch Misalnya, Anda dapat menambahkan nama host sebagai dimensi, yang kemudian memungkinkan Anda mengidentifikasi distribusi beban yang tidak merata di seluruh armada Anda. Semua pengaturan konfigurasi KPL tidak dapat diubah, sehingga Anda tidak dapat mengubah dimensi tambahan ini setelah instance KPL diinisialisasi.
Tingkat metrik dan granularitas
Ada dua opsi untuk mengontrol jumlah metrik yang diunggah ke: CloudWatch
- tingkat metrik
-
Ini adalah ukuran kasar tentang seberapa penting metrik. Setiap metrik diberi level. Saat Anda menetapkan level, metrik dengan level di bawah ini yang tidak dikirim ke CloudWatch. Levelnya adalah
NONE
,SUMMARY
, danDETAILED
. Pengaturan defaultnya adalahDETAILED
; yaitu, semua metrik.NONE
berarti tidak ada metrik sama sekali, jadi tidak ada metrik yang benar-benar ditetapkan ke level itu. - granularitas
-
Ini mengontrol apakah metrik yang sama dipancarkan pada tingkat granularitas tambahan. Levelnya adalah
GLOBAL
,STREAM
, danSHARD
. Pengaturan defaultnya adalahSHARD
, yang berisi metrik paling granular.Kapan
SHARD
dipilih, metrik dipancarkan dengan nama aliran dan ID pecahan sebagai dimensi. Selain itu, metrik yang sama juga dipancarkan hanya dengan dimensi nama aliran, dan metrik tanpa nama aliran. Ini berarti bahwa, untuk metrik tertentu, dua aliran dengan dua pecahan masing-masing akan menghasilkan tujuh CloudWatch metrik: satu untuk setiap pecahan, satu untuk setiap aliran, dan satu keseluruhan; semua menggambarkan statistik yang sama tetapi pada tingkat granularitas yang berbeda. Untuk ilustrasi, lihat diagram berikut.Tingkat granularitas yang berbeda membentuk hierarki, dan semua metrik dalam sistem membentuk pohon, berakar pada nama metrik:
MetricName (GLOBAL): Metric X Metric Y | | ----------------- ------------ | | | | StreamName (STREAM): Stream A Stream B Stream A Stream B | | -------- --------- | | | | ShardID (SHARD): Shard 0 Shard 1 Shard 0 Shard 1
Tidak semua metrik tersedia pada tingkat pecahan; beberapa di antaranya adalah tingkat aliran atau global secara alami. Ini tidak diproduksi pada tingkat pecahan, bahkan jika Anda telah mengaktifkan metrik tingkat shard (
Metric Y
dalam diagram sebelumnya).Saat Anda menentukan dimensi tambahan, Anda harus memberikan nilai untuk
tuple:<DimensionName, DimensionValue, Granularity>
. Granularitas digunakan untuk menentukan di mana dimensi kustom dimasukkan dalam hierarki:GLOBAL
berarti bahwa dimensi tambahan dimasukkan setelah nama metrik,STREAM
berarti itu dimasukkan setelah nama aliran, danSHARD
berarti itu dimasukkan setelah ID pecahan. Jika beberapa dimensi tambahan diberikan per tingkat granularitas, mereka dimasukkan dalam urutan yang diberikan.
Akses lokal dan CloudWatch unggahan Amazon
Metrik untuk instans KPL saat ini tersedia secara lokal secara real time; Anda dapat menanyakan KPL kapan saja untuk mendapatkannya. KPL secara lokal menghitung jumlah, rata-rata, minimum, maksimum, dan hitungan setiap metrik, seperti dalam. CloudWatch
Anda bisa mendapatkan statistik yang kumulatif dari awal program hingga saat ini dalam waktu, atau menggunakan jendela bergulir selama N detik terakhir, di mana N adalah bilangan bulat antara 1 dan 60.
Semua metrik tersedia untuk diunggah. CloudWatch Ini sangat berguna untuk mengumpulkan data di beberapa host, pemantauan, dan mengkhawatirkan. Fungsi ini tidak tersedia secara lokal.
Seperti yang dijelaskan sebelumnya, Anda dapat memilih metrik mana yang akan diunggah dengan pengaturan tingkat metrik dan granularitas. Metrik yang tidak diunggah tersedia secara lokal.
Mengunggah titik data secara individual tidak dapat dipertahankan karena dapat menghasilkan jutaan unggahan per detik, jika lalu lintas tinggi. Untuk alasan ini, KPL menggabungkan metrik secara lokal ke dalam bucket 1 menit dan mengunggah objek statistik ke CloudWatch satu kali per menit, per metrik yang diaktifkan.
Daftar metrik
Metrik | Deskripsi |
---|---|
UserRecordsReceived |
Hitung berapa banyak catatan pengguna logis yang diterima oleh inti KPL untuk operasi put. Tidak tersedia pada tingkat pecahan. Tingkat metrik: Detil Unit: Jumlah |
UserRecordsPending |
Sampel periodik berapa banyak catatan pengguna yang saat ini tertunda. Catatan tertunda jika saat ini di-buffer dan menunggu untuk dikirim, atau dikirim dan dalam penerbangan ke layanan backend. Tidak tersedia pada tingkat pecahan. KPL menyediakan metode khusus untuk mengambil metrik ini di tingkat global bagi pelanggan untuk mengelola tarif put mereka. Tingkat metrik: Detil Unit: Jumlah |
UserRecordsPut |
Hitung berapa banyak catatan pengguna logis yang berhasil dimasukkan. KPL tidak menghitung catatan gagal untuk metrik ini. Hal ini memungkinkan rata-rata untuk memberikan tingkat keberhasilan, hitungan untuk memberikan total upaya, dan perbedaan antara hitungan dan jumlah untuk memberikan hitungan kegagalan. Tingkat metrik: Ringkasan Unit: Jumlah |
UserRecordsDataPut |
Byte dalam catatan pengguna logis berhasil dimasukkan. Tingkat metrik: Detil Unit: Bita |
KinesisRecordsPut |
Hitungan berapa banyak catatan Kinesis Data Streams berhasil dimasukkan (setiap catatan Kinesis Data Streams dapat berisi beberapa catatan pengguna). KPL menghasilkan nol untuk catatan yang gagal. Hal ini memungkinkan rata-rata untuk memberikan tingkat keberhasilan, hitungan untuk memberikan total upaya, dan perbedaan antara hitungan dan jumlah untuk memberikan hitungan kegagalan. Tingkat metrik: Ringkasan Unit: Jumlah |
KinesisRecordsDataPut |
Byte dalam catatan Kinesis Data Streams. Tingkat metrik: Detil Unit: Bita |
ErrorsByCode |
Hitung setiap jenis kode kesalahan. Ini memperkenalkan dimensi tambahan Kesalahan API Kinesis Data Streams dihitung satu kali per catatan Kinesis Data Streams. Beberapa catatan pengguna dalam catatan Kinesis Data Streams tidak menghasilkan beberapa hitungan. Tingkat metrik: Ringkasan Unit: Jumlah |
AllErrors |
Ini dipicu oleh kesalahan yang sama seperti Errors by Code, tetapi tidak membedakan antara tipe. Ini berguna sebagai monitor umum tingkat kesalahan tanpa memerlukan jumlah manual dari hitungan dari semua jenis kesalahan yang berbeda. Tingkat metrik: Ringkasan Unit: Jumlah |
RetriesPerRecord |
Jumlah percobaan ulang yang dilakukan per catatan pengguna. Nol dipancarkan untuk catatan yang berhasil dalam satu percobaan. Data dipancarkan pada saat catatan pengguna selesai (ketika berhasil atau tidak dapat lagi dicoba lagi). Jika catatan time-to-live adalah nilai yang besar, metrik ini mungkin tertunda secara signifikan. Tingkat metrik: Detil Unit: Jumlah |
BufferingTime |
Waktu antara catatan pengguna tiba di KPL dan berangkat ke backend. Informasi ini dikirimkan kembali ke pengguna berdasarkan per catatan, tetapi juga tersedia sebagai statistik agregat. Tingkat metrik: Ringkasan Satuan: Milidetik |
Request Time |
Waktu yang dibutuhkan untuk tampil Tingkat metrik: Detil Satuan: Milidetik |
User Records per Kinesis Record |
Jumlah catatan pengguna logis yang dikumpulkan ke dalam catatan Kinesis Data Streams tunggal. Tingkat metrik: Detil Unit: Jumlah |
Amazon Kinesis Records per
PutRecordsRequest |
Jumlah catatan Kinesis Data Streams dikumpulkan menjadi satu. Tingkat metrik: Detil Unit: Jumlah |
User Records per
PutRecordsRequest |
Jumlah total catatan pengguna yang terkandung dalam file Tingkat metrik: Detil Unit: Jumlah |