View a markdown version of this page

Mengaktifkan Metrik untuk AWS SDK untuk Java - AWS SDK untuk Java 1.x

AWS SDK untuk Java 1.x mencapai akhir dukungan pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke AWS SDK for Java 2.x 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

AWS SDK untuk Java Dapat menghasilkan metrik untuk visualisasi dan pemantauan dengan Amazon CloudWatch yang mengukur:

  • kinerja aplikasi Anda saat mengakses AWS

  • kinerja JVM Anda saat digunakan dengan AWS

  • detail lingkungan runtime seperti memori heap, jumlah utas, dan deskriptor file yang dibuka

Cara Mengaktifkan Java SDK Metric Generation

Anda perlu menambahkan dependensi Maven berikut untuk mengaktifkan SDK mengirim metrik ke 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>

* Ganti nomor versi dengan versi terbaru SDK yang tersedia di Maven Central.

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

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

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

catatan

Jika Anda mengakses AWS dari Amazon EC2 instance menggunakan layanan metadata Amazon EC2 instans, Anda tidak perlu menentukan file kredensi. 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 wilayah CloudWatch default (us-east -1). Untuk mengubah wilayah, tentukan dengan menggunakan cloudwatchRegion atribut di properti sistem. Misalnya, untuk mengatur 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 dihasilkan AWS SDK untuk Java, diantri untuk ringkasan statistik, dan diunggah secara asinkron CloudWatch sekitar sekali setiap menit. Setelah metrik diunggah, Anda dapat memvisualisasikannya menggunakan Konsol Manajemen AWS dan mengatur alarm pada masalah potensial seperti kebocoran memori, kebocoran deskriptor file, dan sebagainya.

Jenis Metrik yang Tersedia

Kumpulan metrik default dibagi menjadi tiga kategori utama:

AWS Meminta Metrik
  • Meliputi area seperti latensi HTTP request/response, jumlah permintaan, pengecualian, dan percobaan ulang.

    RequestMetric 131111
Layanan AWS Metrik
  • Ser Layanan AWS takan data spesifik, seperti throughput dan jumlah byte untuk unggahan dan unduhan S3.

    ServiceMetric 131111
Metrik Mesin
  • Tutupi lingkungan runtime, termasuk memori heap, jumlah utas, dan deskriptor file terbuka.

    MachineMetric 131111

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

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

Informasi Selengkapnya