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

# Publikasikan metrik SDK dari AWS SDK for Java 2.x
<a name="metrics"></a>

Dengan AWS SDK for Java 2.x Anda dapat mengumpulkan metrik tentang klien layanan dan permintaan dalam aplikasi Anda, menganalisis output di Amazon CloudWatch Logs, dan kemudian menindaklanjutinya.

Secara default, koleksi metrik dinonaktifkan di SDK. Topik ini membantu Anda mengaktifkan dan mengonfigurasinya.

## Memulai dengan metrik SDK
<a name="getting-started-with-metrics"></a>

Untuk mengaktifkan pengumpulan metrik dalam aplikasi Anda, pilih implementasi `[MetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/MetricPublisher.html)` antarmuka yang sesuai berdasarkan kasus penggunaan Anda dan ikuti petunjuk penyiapan terperinci:

**Untuk aplikasi yang berjalan lama:**
+ Gunakan `[CloudWatchMetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/publishers/cloudwatch/CloudWatchMetricPublisher.html)`
+ Lihat [Menerbitkan metrik SDK dari aplikasi yang sudah berjalan lama](metric-pub-impl-cwmp.md) untuk petunjuk penyiapan lengkap, contoh kode, dan opsi konfigurasi.

**Untuk AWS Lambda fungsi:**
+ Gunakan `[EmfMetricLoggingPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/publishers/emf/EmfMetricLoggingPublisher.html)`
+ Lihat [Menerbitkan metrik SDK untuk AWS Lambda fungsi untuk](metric-pub-impl-emf.md) petunjuk penyiapan lengkap, dependensi, dan konfigurasi khusus Lambda.

**Untuk pemecahan masalah dan keluaran konsol:**
+ Gunakan `[LoggingMetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/LoggingMetricPublisher.html)`
+ Lihat [Metrik SDK keluaran ke konsol untuk pengembangan dan debugging untuk](metric-pub-impl-logging.md) petunjuk penyiapan, opsi pemformatan, dan contoh untuk pengembangan dan pemecahan masalah lokal.

## Pratinjau implementasi cepat
<a name="quick-implementation-preview"></a>

Inilah yang mengaktifkan metrik untuk setiap kasus penggunaan:

**Aplikasi yang berjalan lama:**

```
MetricPublisher metricsPub = CloudWatchMetricPublisher.create();
DynamoDbClient ddb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
    .build();
```

**Fungsi Lambda:**

```
EmfMetricLoggingPublisher emfPublisher = EmfMetricLoggingPublisher.builder()
    .namespace("MyApp")
    .build();
DynamoDbClient dynamoDb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(emfPublisher))
    .build();
```

**Pengembangan dan debugging:**

```
MetricPublisher loggingPublisher = LoggingMetricPublisher.create();
S3Client s3 = S3Client.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(loggingPublisher))
    .build();
```

## Batasan metrik klien S3 AWS berbasis CRT
<a name="metrics-using-s3-crt-based-client"></a>

[Klien S3 AWS berbasis CRT](crt-based-s3-client.md) saat ini tidak mendukung pengumpulan metrik SDK. Builder untuk instance klien S3 AWS berbasis CRT, [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3CrtAsyncClientBuilder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3CrtAsyncClientBuilder.html), tidak menyediakan metode untuk mengonfigurasi penerbit metrik.

## Kapan metrik tersedia?
<a name="when-are-metrics-available"></a>

Metrik umumnya tersedia dalam waktu 5-10 menit setelah SDK for Java memancarkannya. Untuk akurasi dan up-to-date metrik, periksa Cloudwatch setidaknya 10 menit setelah memancarkan metrik dari aplikasi Java Anda. 

## Informasi apa yang dikumpulkan?
<a name="what-information-is-collected"></a>

Koleksi metrik meliputi:
+ Jumlah permintaan API, termasuk apakah mereka berhasil atau gagal
+ Informasi tentang panggilan Layanan AWS Anda dalam permintaan API Anda, termasuk pengecualian yang dikembalikan
+ Durasi untuk berbagai operasi seperti Marshalling, Signing, dan permintaan HTTP
+ Metrik klien HTTP, seperti jumlah koneksi terbuka, jumlah permintaan yang tertunda, dan nama klien HTTP yang digunakan

**catatan**  
Metrik yang tersedia bervariasi menurut klien HTTP.

Untuk daftar lengkapnya, lihat [Metrik klien layanan](metrics-list.md).

## Bagaimana saya bisa menggunakan informasi ini?
<a name="how-can-i-use-this-information"></a>

Anda dapat menggunakan metrik yang dikumpulkan SDK untuk memantau klien layanan dalam aplikasi Anda. Anda dapat melihat tren penggunaan secara keseluruhan, mengidentifikasi anomali, meninjau pengecualian klien layanan yang dikembalikan, atau menggali untuk memahami masalah tertentu. Menggunakan Amazon CloudWatch Logs, Anda juga dapat membuat alarm untuk memberi tahu Anda segera setelah aplikasi Anda mencapai kondisi yang Anda tentukan.

Untuk informasi selengkapnya, lihat [Menggunakan Metrik CloudWatch Log Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) dan [Menggunakan Alarm CloudWatch Log Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) di [Panduan Pengguna CloudWatch Log Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).