View a markdown version of this page

Abilitazione delle metriche per AWS SDK per Java - AWS SDK per Java 1.x

La versione AWS SDK per Java 1.x ha raggiunto la fine del supporto il 31 dicembre 2025. Ti consigliamo di eseguire la migrazione alla versione per continuare AWS SDK for Java 2.x a ricevere nuove funzionalità, miglioramenti della disponibilità e aggiornamenti di sicurezza.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Abilitazione delle metriche per AWS SDK per Java

AWS SDK per Java Possono generare metriche per la visualizzazione e il monitoraggio con Amazon CloudWatch che misurano:

  • le prestazioni della tua applicazione durante l'accesso AWS

  • le prestazioni delle tue JVM se utilizzate con AWS

  • dettagli dell'ambiente di runtime come memoria heap, numero di thread e descrittori di file aperti

Come abilitare la generazione di metriche Java SDK

È necessario aggiungere la seguente dipendenza da Maven per consentire all'SDK di inviare le metriche a. 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>

* Sostituisci il numero di versione con l'ultima versione dell'SDK disponibile su Maven Central. https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom

AWS SDK per Java le metriche sono disabilitate per impostazione predefinita. Per abilitarlo per il tuo ambiente di sviluppo locale, includi una proprietà di sistema che punti al tuo file AWS delle credenziali di sicurezza all'avvio della JVM. Ad esempio:

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

È necessario specificare il percorso del file delle credenziali in modo che l'SDK possa caricare i punti dati raccolti per un'analisi successiva. CloudWatch

Nota

Se accedi AWS da un' Amazon EC2 istanza utilizzando il servizio di metadati delle Amazon EC2 istanze, non devi specificare un file di credenziali. In questo caso, devi solo specificare:

-Dcom.amazonaws.sdk.enableDefaultMetrics

Tutte le metriche acquisite da AWS SDK per Java si trovano nel namespace AWSSDK/Java e vengono caricate nella regione CloudWatch predefinita (us-east-1). Per modificare la regione, specificala utilizzando l'attributo nella proprietà di sistema. cloudwatchRegion Ad esempio, per impostare la CloudWatch regione su us-east-1, usa:

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

Una volta abilitata la funzione, ogni volta che c'è una richiesta di servizio AWS da, i punti di dati metrici verranno generati AWS SDK per Java, messi in coda per il riepilogo statistico e caricati in modo asincrono circa una volta al minuto. CloudWatch Una volta caricate le metriche, puoi visualizzarle utilizzando Console di gestione AWS e impostare allarmi in caso di potenziali problemi come perdite di memoria, perdite di descrittori di file e così via.

Tipi di metriche disponibili

Il set predefinito di metriche è suddiviso in tre categorie principali:

AWS Metriche delle richieste
  • Copre aree come la latenza dell'HTTP request/response, il numero di richieste, le eccezioni e i nuovi tentativi.

    RequestMetric 131111
Servizio AWS Metriche
  • Includi dati Servizio AWS specifici, come la velocità effettiva e il numero di byte per gli upload e i download di S3.

    ServiceMetric 131111
Metriche della macchina
  • Copre l'ambiente di runtime, inclusa la memoria heap, il numero di thread e i descrittori di file aperti.

    MachineMetric 131111

    Se desideri escludere Machine Metrics, aggiungi excludeMachineMetrics alla proprietà di sistema:

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

Ulteriori informazioni