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 effettuare la migrazione a per continuare AWS SDK for Java 2.xa 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 Java SDK Metric Generation

È necessario aggiungere la seguente dipendenza Maven per abilitare l'SDK a cui inviare le metriche. 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.

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 file delle credenziali AWS di sicurezza all'avvio della JVM. Esempio:

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

È necessario specificare il percorso del file di 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 dell' Amazon EC2 istanza, non è necessario 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 nello spazio dei nomi AWSSDK/Javae vengono caricate nella regione CloudWatch predefinita (us-east-1). Per modificare la regione, specificala utilizzando l'cloudwatchRegionattributo nella proprietà di sistema. 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 funzionalità, ogni volta che viene inviata una richiesta di servizio, i 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. AWS CloudWatch Una volta caricate le metriche, puoi visualizzarle utilizzando Console di gestione AWSe impostare allarmi su potenziali problemi come perdita di memoria, perdita del descrittore di file e così via.

Tipi di metriche disponibili

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

AWS Richiedi metriche
  • 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 i caricamenti e i download di S3.

    ServiceMetric 131111
Metriche della macchina
  • Copre l'ambiente di runtime, inclusi 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