La AWS SDK per Java 1.x è stata raggiunta end-of-support il 31 dicembre 2025. Ti consigliamo di eseguire la migrazione a per continuare [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)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
<a name="generating-sdk-metrics"></a>

 AWS SDK per Java Possono generare metriche per la visualizzazione e il monitoraggio con [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/) che misurano:
+ le prestazioni della tua applicazione durante l'accesso AWS 
+ le prestazioni del tuo JVMs quando viene utilizzato con AWS 
+ dettagli dell'ambiente di runtime come memoria heap, numero di thread e descrittori di file aperti

## Come abilitare Java SDK Metric Generation
<a name="how-to-enable-sdk-java-metric-generation"></a>

È 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>
```

 \$1 [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 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 si AWS SDK per Java trovano nello spazio dei nomi **AWSSDK/Java** e vengono caricate CloudWatch nella regione 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 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](https://console.aws.amazon.com/console/home)e impostare allarmi su potenziali problemi come perdita di memoria, perdita del descrittore di file e così via.

## Tipi di metriche disponibili
<a name="available-metric-types"></a>

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

 AWS Richiedi metriche  
+ Copre aree quali la latenza della richiesta/risposta HTTP, il numero di richieste, le eccezioni e i nuovi tentativi.  
![\[RequestMetric 131111\]](http://docs.aws.amazon.com/it_it/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)

 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\]](http://docs.aws.amazon.com/it_it/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)

Metriche della macchina  
+ Copre l'ambiente di runtime, inclusi la memoria heap, il numero di thread e i descrittori di file aperti.  
![\[MachineMetric 131111\]](http://docs.aws.amazon.com/it_it/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)

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

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

## Ulteriori informazioni
<a name="more-information"></a>
+ Consulta il [riepilogo del pacchetto amazonaws/metrics](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html) per un elenco completo dei tipi di metriche principali predefiniti.
+ [Scopri come utilizzare il file in Esempi utilizzando il CloudWatch . AWS SDK per Java CloudWatch AWS SDK per Java](examples-cloudwatch.md)
+ Scopri di più sull'ottimizzazione delle prestazioni nel post del blog [Tuning the AWS SDK per Java to Improve Resiliency.](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency)