

 AWS SDK untuk Java 1.x mencapai end-of-support pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)untuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.

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

# Mengaktifkan Metrik untuk AWS SDK untuk Java
<a name="generating-sdk-metrics"></a>

 AWS SDK untuk Java Dapat menghasilkan metrik untuk visualisasi dan pemantauan dengan [Amazon CloudWatch yang mengukur](https://aws.amazon.com/cloudwatch/):
+ kinerja aplikasi Anda saat mengakses AWS 
+ kinerja Anda JVMs saat digunakan dengan AWS 
+ Rincian lingkungan runtime seperti memori heap, jumlah thread, dan deskriptor file yang dibuka

## Cara Mengaktifkan Generasi Metrik SDK Java
<a name="how-to-enable-sdk-java-metric-generation"></a>

Anda perlu menambahkan dependensi Maven berikut untuk mengaktifkan SDK untuk mengirim metrik. CloudWatch

```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.12.490*</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-cloudwatchmetrics</artifactId>
    <scope>provided</scope>
  </dependency>
  <!-- Other SDK dependencies. -->
</dependencies>
```

 \$1 Ganti nomor versi dengan versi terbaru SDK yang tersedia di [Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) Central.

AWS SDK untuk Java metrik *dinonaktifkan secara default*. Untuk mengaktifkannya untuk lingkungan pengembangan lokal Anda, sertakan properti sistem yang menunjuk ke file kredensi AWS keamanan Anda saat memulai JVM. Contoh:

```
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
```

Anda perlu menentukan jalur ke file kredensyal Anda sehingga SDK dapat mengunggah titik data yang dikumpulkan untuk analisis selanjutnya. CloudWatch 

**catatan**  
Jika Anda mengakses AWS dari sebuah Amazon EC2 instance menggunakan layanan metadata Amazon EC2 instance, Anda tidak perlu menentukan file kredensyal. Dalam hal ini, Anda hanya perlu menentukan:  

```
-Dcom.amazonaws.sdk.enableDefaultMetrics
```

*Semua metrik yang ditangkap oleh AWS SDK untuk Java berada di bawah namespace **AWSSDK/Java**, dan diunggah ke CloudWatch wilayah default (us-east-1).* Untuk mengubah wilayah, tentukan dengan menggunakan `cloudwatchRegion` atribut di properti sistem. Misalnya, untuk menyetel CloudWatch wilayah ke *us-east-1*, gunakan:

```
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}
```

Setelah Anda mengaktifkan fitur, setiap kali ada permintaan layanan AWS dari, titik data metrik akan dibuat AWS SDK untuk Java, antri untuk ringkasan statistik, dan diunggah secara asinkron menjadi sekitar sekali setiap menit. CloudWatch Setelah metrik diunggah, Anda dapat memvisualisasikannya menggunakan [Konsol Manajemen AWS](https://console.aws.amazon.com/console/home)dan mengatur alarm pada potensi masalah seperti kebocoran memori, kebocoran deskriptor file, dan sebagainya.

## Jenis Metrik yang Tersedia
<a name="available-metric-types"></a>

Kumpulan metrik default dibagi menjadi tiga kategori utama:

 AWS Minta Metrik  
+ Mencakup area seperti latensi permintaan/respons HTTP, jumlah permintaan, pengecualian, dan percobaan ulang.  
![\[RequestMetric 131111\]](http://docs.aws.amazon.com/id_id/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)

 Layanan AWS Metrik  
+ Sertakan data Layanan AWS-spesifik, seperti throughput dan jumlah byte untuk unggahan dan unduhan S3.  
![\[ServiceMetric 131111\]](http://docs.aws.amazon.com/id_id/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)

Metrik Mesin  
+ Tutupi lingkungan runtime, termasuk memori heap, jumlah thread, dan deskriptor file terbuka.  
![\[MachineMetric 131111\]](http://docs.aws.amazon.com/id_id/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)

  Jika Anda ingin mengecualikan Metrik Mesin, tambahkan `excludeMachineMetrics` ke properti sistem:

  ```
  -Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
  ```

## Informasi Selengkapnya
<a name="more-information"></a>
+ Lihat [ringkasan paket amazonaws/metrics](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html) untuk daftar lengkap jenis metrik inti yang telah ditentukan sebelumnya.
+ Pelajari tentang bekerja dengan CloudWatch menggunakan AWS SDK untuk Java dalam [CloudWatch Contoh Menggunakan AWS SDK untuk Java](examples-cloudwatch.md).
+ Pelajari lebih lanjut tentang penyetelan kinerja dalam [Menyetel AWS SDK untuk Java untuk Meningkatkan Ketahanan posting blog](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency).