AWS SDK for Java 2.x: Referensi Metrik Komprehensif - AWS SDK for Java 2.x

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS SDK for Java 2.x: Referensi Metrik Komprehensif

Dengan itu AWS SDK for Java 2.x, Anda dapat mengumpulkan metrik dari klien layanan di aplikasi Anda dan kemudian menerbitkan (mengeluarkan) metrik tersebut ke Amazon. CloudWatch

Tabel ini mencantumkan metrik yang dapat Anda kumpulkan dan persyaratan penggunaan klien HTTP apa pun.

Untuk informasi selengkapnya tentang mengaktifkan dan mengonfigurasi metrik untuk SDK, lihat Mengaktifkan metrik SDK.

Metrik dikumpulkan dengan setiap permintaan

Nama metrik Deskripsi Tipe

ApiCallDuration

Durasi panggilan API. Ini termasuk semua upaya panggilan yang dilakukan.

Durasi*

ApiCallSuccessful

Benar jika panggilan API berhasil, false sebaliknya.

Boolean

CredentialsFetchDuration

Durasi waktu untuk mengambil kredensyal penandatanganan untuk panggilan API.

Durasi*

EndpointResolveDuration Durasi waktu untuk menyelesaikan titik akhir yang digunakan untuk panggilan API. Durasi*

MarshallingDuration

Durasi waktu untuk mengirim permintaan SDK ke permintaan HTTP.

Durasi*

OperationName

Nama operasi layanan yang dipanggil.

String

RetryCount

Jumlah percobaan ulang yang dilakukan SDK dalam pelaksanaan permintaan. 0 menyiratkan bahwa permintaan berfungsi pertama kali dan tidak ada percobaan ulang yang dicoba.

Untuk informasi selengkapnya tentang mengonfigurasi perilaku coba lagi, lihat. Coba lagi strategi

Bilangan Bulat

ServiceId

ID unik untuk layanan ini.

String

ServiceEndpoint

Titik akhir untuk layanan.

URI

TokenFetchDuration

Durasi waktu untuk mengambil kredensyal penandatanganan untuk panggilan API. Durasi*

* java.time.duration.

Metrik dikumpulkan untuk setiap upaya permintaan

Setiap panggilan API mungkin memerlukan beberapa upaya sebelum respons diterima. Metrik ini dikumpulkan untuk setiap upaya.

Metrik inti

Nama metrik Deskripsi Tipe

AwsExtendedRequestId

ID permintaan yang diperpanjang dari permintaan layanan.

String

AwsRequestId

ID permintaan permintaan layanan.

String

BackoffDelayDuration

Durasi waktu yang telah ditunggu SDK sebelum upaya panggilan API ini. Nilai didasarkan pada BackoffStrategy set pada klien. Lihat Coba lagi strategi bagian dalam panduan ini untuk informasi lebih lanjut.

Durasi*

ErrorType

Jenis kesalahan yang terjadi untuk upaya panggilan.

Berikut adalah nilai yang mungkin:

  • Throttling: Layanan merespons dengan kesalahan pelambatan.

  • ServerError: Layanan merespons dengan kesalahan selain pelambatan.

  • ConfiguredTimeout: Terjadi batas waktu klien, baik pada tingkat panggilan API, atau tingkat upaya panggilan API.

  • IO: I/O Terjadi kesalahan.

  • Other: Tangkap semua untuk kesalahan lain yang tidak termasuk dalam salah satu daftar kategori di atas.

String
ReadThroughput

Throughput baca klien, didefinisikan sebagaiNumberOfResponseBytesRead / (TTLB - TTFB). Nilai ini dalam byte per detik.

Perhatikan bahwa metrik ini hanya mengukur byte yang dibaca dari dalam ResponseTransformer atauAsyncResponseTransformer. Data yang dibaca di luar transformator — misalnya ketika aliran respons dikembalikan sebagai hasil transformator — tidak termasuk dalam perhitungan.

Ganda

ServiceCallDuration

Durasi waktu untuk terhubung ke layanan (atau memperoleh koneksi dari kumpulan koneksi), mengirim permintaan serial dan menerima respons awal (misalnya kode status HTTP dan header). Ini TIDAK termasuk waktu untuk membaca seluruh tanggapan dari layanan.

Durasi*

SigningDuration

Durasi waktu untuk menandatangani permintaan HTTP.

Durasi*

TimeToFirstByte Durasi waktu dari mengirim permintaan HTTP (termasuk memperoleh koneksi) ke layanan, dan menerima byte pertama header dalam respons. Durasi*
TimeToLastByte

Durasi waktu dari mengirim permintaan HTTP (termasuk memperoleh koneksi) ke layanan, dan menerima byte terakhir dari respons.

Perhatikan APIs bahwa untuk respons streaming kembali, metrik ini mencakup waktu hingga ResponseTransformer atau AsyncResponseTransformer selesai.

Durasi*

UnmarshallingDuration

Durasi waktu untuk menghapus respons HTTP terhadap respons SDK.

Catatan: Untuk operasi streaming, ini tidak termasuk waktu untuk membaca payload respons.

Durasi*

* java.time.duration.

Metrik HTTP

Nama metrik Deskripsi Tipe Klien HTTP diperlukan*

AvailableConcurrency

Jumlah permintaan bersamaan tambahan yang didukung klien HTTP tanpa membuat koneksi baru ke server target.

Untuk operasi HTTP/1, ini sama dengan jumlah koneksi TCP idle yang dibuat dengan layanan. Untuk operasi HTTP/2, ini sama dengan jumlah aliran idle.

Catatan: Nilai ini bervariasi menurut implementasi klien HTTP:

  • Klien Apache: Nilai berlaku untuk seluruh klien HTTP

  • Klien Netty: Nilai berlaku per titik akhir

  • AWS Klien berbasis CRT: Nilai berlaku per titik akhir

Nilai dicakup ke instance klien HTTP individual dan mengecualikan konkurensi dari klien HTTP lain di JVM yang sama.

Bilangan Bulat

Apache, Netty, CRT

ConcurrencyAcquireDuration

Durasi waktu untuk memperoleh saluran dari kolam koneksi.

Untuk operasi HTTP/1, saluran sama dengan koneksi TCP. Untuk operasi HTTP/2, saluran sama dengan saluran aliran HTTP/2.

Memperoleh saluran baru dapat mencakup waktu untuk:

  1. Menunggu izin konkurensi, sebagaimana dibatasi oleh konfigurasi konkurensi maks klien.

  2. Membangun koneksi baru, jika tidak ada koneksi yang ada tersedia di kolam renang.

  3. Melakukan jabat tangan dan negosiasi TLS, jika TLS diaktifkan.

Durasi*

Apache, Netty, CRT

HttpClientName

Nama HTTP yang digunakan untuk permintaan.

String

Apache, Netty, CRT

HttpStatusCode

Kode status respon HTTP.

Bilangan Bulat

Setiap

LeasedConcurrency

Jumlah permintaan yang saat ini dijalankan oleh klien HTTP.

Untuk operasi HTTP/1, ini sama dengan jumlah koneksi TCP aktif dengan layanan (tidak termasuk koneksi idle). Untuk operasi HTTP/2, ini sama dengan jumlah aliran HTTP aktif dengan layanan (tidak termasuk kapasitas aliran idle).

Catatan: Nilai ini bervariasi menurut implementasi klien HTTP:

  • Klien Apache: Nilai berlaku untuk seluruh klien HTTP

  • Klien Netty: Nilai berlaku per titik akhir

  • AWS Klien berbasis CRT: Nilai berlaku per titik akhir

Nilai dicakup ke instance klien HTTP individual dan mengecualikan konkurensi dari klien HTTP lain di JVM yang sama.

Bilangan Bulat

Apache, Netty, CRT

LocalStreamWindowSize

Ukuran jendela HTTP/2 lokal dalam byte untuk aliran yang menjalankan permintaan ini.

Bilangan Bulat

Netty

MaxConcurrency

Jumlah maksimum permintaan bersamaan yang didukung klien HTTP.

Untuk operasi HTTP/1, ini sama dengan jumlah maksimum koneksi TCP yang dapat dikumpulkan oleh klien HTTP. Untuk operasi HTTP/2, ini sama dengan jumlah maksimum aliran yang dapat dikumpulkan oleh klien HTTP.

Catatan: Nilai ini bervariasi menurut implementasi klien HTTP:

  • Klien Apache: Nilai berlaku untuk seluruh klien HTTP

  • Klien Netty: Nilai berlaku per titik akhir

  • AWS Klien berbasis CRT: Nilai berlaku per titik akhir

Nilai dicakup ke instance klien HTTP individual dan mengecualikan konkurensi dari klien HTTP lain di JVM yang sama.

Bilangan Bulat

Apache, Netty, CRT

PendingConcurrencyAcquires

Jumlah permintaan yang menunggu konkurensi dari klien HTTP.

Untuk operasi HTTP/1, ini sama dengan jumlah permintaan yang menunggu koneksi TCP dibuat atau dikembalikan dari kumpulan koneksi. Untuk operasi HTTP/2, ini sama dengan jumlah permintaan yang menunggu aliran baru (dan mungkin koneksi HTTP/2 baru) dari kumpulan koneksi.

Catatan: Nilai ini bervariasi menurut implementasi klien HTTP:

  • Klien Apache: Nilai berlaku untuk seluruh klien HTTP

  • Klien Netty: Nilai berlaku per titik akhir

  • AWS Klien berbasis CRT: Nilai berlaku per titik akhir

Nilai dicakup ke instance klien HTTP individual dan mengecualikan konkurensi dari klien HTTP lain di JVM yang sama.

Bilangan Bulat

Apache, Netty, CRT

RemoteStreamWindowSize

Ukuran jendela HTTP/2 jarak jauh dalam byte untuk aliran yang menjalankan permintaan ini.

Bilangan Bulat

Netty

* java.time.duration.

Istilah yang digunakan dalam kolom berarti: