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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
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.](metrics.md)
## Metrik dikumpulkan dengan setiap permintaan
| Nama metrik | Deskripsi | Tipe |
| --- | --- | --- |
| ApiCallDuration | Durasi panggilan API. Ini termasuk semua upaya panggilan yang dilakukan. | Durasi\$1 |
| ApiCallSuccessful | Benar jika panggilan API berhasil, false sebaliknya. | Boolean |
| CredentialsFetchDuration | Durasi waktu untuk mengambil kredensyal penandatanganan untuk panggilan API. | Durasi\$1 |
| EndpointResolveDuration | Durasi waktu untuk menyelesaikan titik akhir yang digunakan untuk panggilan API. | Durasi\$1 |
| MarshallingDuration | Durasi waktu untuk mengirim permintaan SDK ke permintaan HTTP. | Durasi\$1 |
| 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](retry-strategy.md#retry-strategies) | 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\$1 |
\$1 [java.time.duration.](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html)
## 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 `[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/retries/api/BackoffStrategy.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/retries/api/BackoffStrategy.html)` set pada klien. Lihat [Coba lagi strategi](retry-strategy.md#retry-strategies) bagian dalam panduan ini untuk informasi lebih lanjut. | Durasi\$1 |
| ErrorType | Jenis kesalahan yang terjadi untuk upaya panggilan. Berikut adalah nilai yang mungkin: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) | String |
| ReadThroughput | Throughput baca klien, didefinisikan sebagai`NumberOfResponseBytesRead / (TTLB - TTFB)`. Nilai ini dalam byte per detik. Perhatikan bahwa metrik ini hanya mengukur byte yang dibaca dari dalam `ResponseTransformer` atau`AsyncResponseTransformer`. Data yang dibaca di luar transformator — misalnya ketika aliran respons dikembalikan sebagai hasil transformator — tidak termasuk dalam perhitungan. | Ganda |
| WriteThroughput | Throughput tulis klien, didefinisikan sebagai`RequestBytesWritten / (LastByteWrittenTime - FirstByteWrittenTime)`. Nilai ini dalam byte per detik. Metrik ini mengukur tingkat di mana SDK menyediakan badan permintaan ke klien HTTP. Ini tidak termasuk pengaturan koneksi, waktu jabat tangan TLS, dan waktu pemrosesan server. Metrik ini hanya dilaporkan untuk permintaan yang memiliki badan streaming seperti S3 PutObject. Perhatikan bahwa metrik ini tidak memperhitungkan buffering di lapisan klien HTTP. Tingkat transmisi jaringan yang sebenarnya mungkin lebih rendah jika klien HTTP buffer data sebelum mengirim. Metrik ini mewakili batas atas throughput jaringan. | 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\$1 |
| SigningDuration | Durasi waktu untuk menandatangani permintaan HTTP. | Durasi\$1 |
| TimeToFirstByte | Durasi waktu dari mengirim permintaan HTTP (termasuk memperoleh koneksi) ke layanan, dan menerima byte pertama header dalam respons. | Durasi\$1 |
| 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 itu, metrik ini mencakup waktu hingga `ResponseTransformer` atau `AsyncResponseTransformer` selesai. | Durasi\$1 |
| UnmarshallingDuration | Durasi waktu untuk menghapus respons HTTP terhadap respons SDK. Catatan: Untuk operasi streaming, ini tidak termasuk waktu untuk membaca payload respons. | Durasi\$1 |
\$1 [java.time.duration.](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html)
### Metrik HTTP
| Nama metrik | Deskripsi | Tipe | Klien HTTP diperlukan\$1 |
| --- | --- | --- | --- |
| 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) | Durasi\$1 | 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) 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 mengeksekusi 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sdk-for-java/latest/developer-guide/metrics-list.html) 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 |
\$1 [java.time.duration.](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/Duration.html)
Istilah yang digunakan dalam kolom berarti:
+ Apache: klien HTTP berbasis Apache () `[ApacheHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/apache/ApacheHttpClient.html)`
+ Netty: klien HTTP berbasis Netty () `[NettyNioAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html)`
+ CRT: klien HTTP AWS berbasis CRT () `[AwsCrtAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/crt/AwsCrtAsyncHttpClient.html)`
+ Setiap: pengumpulan data metrik tidak bergantung pada klien HTTP; ini termasuk klien HTTP URLConnection berbasis (`[UrlConnectionHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/urlconnection/UrlConnectionHttpClient.html)`)