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
-
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 AWS
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.
-
- 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.
-
- Metriche della macchina
-
-
Copre l'ambiente di runtime, inclusi la memoria heap, il numero di thread e i descrittori di file aperti.
Se desideri escludere Machine Metrics, aggiungi
excludeMachineMetricsalla proprietà di sistema:-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
Ulteriori informazioni
-
Consulta il riepilogo amazonaws/metrics del pacchetto per un elenco completo dei tipi di metriche principali predefiniti.
-
Scopri come CloudWatch utilizzare il file AWS SDK per Java in CloudWatch Esempi di utilizzo di. AWS SDK per Java
-
Scopri di più sull'ottimizzazione delle prestazioni nel post del blog Tuning the AWS SDK per Java to Improve Resiliency.