O AWS SDK para Java 1.x chegou end-of-support em 31 de dezembro de 2025. Recomendamos que você migre para o [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Habilitando métricas para o AWS SDK para Java
<a name="generating-sdk-metrics"></a>

Eles AWS SDK para Java podem gerar métricas para visualização e monitoramento com a [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/) que medem:
+ o desempenho do seu aplicativo ao acessar AWS 
+ o desempenho do seu JVMs quando usado com AWS 
+ detalhes do ambiente do tempo de execução, como a memória do heap, o número de threads e os descritores de arquivo aberto

## Como habilitar a geração de métricas do SDK do Java
<a name="how-to-enable-sdk-java-metric-generation"></a>

Você precisa adicionar a seguinte dependência do Maven para permitir que o SDK envie métricas para. 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>
```

 \$1Substitua o número da versão pela versão mais recente do SDK disponível na [central do Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom).

AWS SDK para Java as métricas são *desativadas por padrão*. Para habilitá-la para o ambiente de desenvolvimento local, inclua uma propriedade de sistema que aponte para o arquivo de credencial de segurança da AWS durante a inicialização da JVM. Por exemplo:

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

Você precisa especificar o caminho para seu arquivo de credencial para que o SDK possa carregar os pontos de dados coletados para CloudWatch análise posterior.

**nota**  
Se você estiver acessando AWS de uma Amazon EC2 instância usando o serviço de metadados da Amazon EC2 instância, não precisará especificar um arquivo de credencial. Neste caso, você precisa especificar somente:  

```
-Dcom.amazonaws.sdk.enableDefaultMetrics
```

*Todas as métricas capturadas pelo AWS SDK para Java estão no namespace **AWSSDK/Java** e são enviadas para a região CloudWatch padrão (us-east-1).* Para alterar a região, especifique-a usando o atributo `cloudwatchRegion` na propriedade do sistema. Por exemplo, para definir a CloudWatch região como *us-east-1*, use:

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

Depois de ativar o recurso, toda vez que houver uma solicitação de serviço para o AWS SDK para Java, pontos AWS de dados métricos serão gerados, colocados em fila para um resumo estatístico e enviados de forma assíncrona para aproximadamente uma vez a CloudWatch cada minuto. Assim que o upload das métricas for feito, você poderá visualizá-las usando o [Console de gerenciamento da AWS](https://console.aws.amazon.com/console/home) e definir alarmes para problemas em potencial, como vazamento de memória, vazamento do descritor de arquivo etc.

## Tipos de métrica disponíveis
<a name="available-metric-types"></a>

O conjunto padrão de métricas é dividido em três categorias principais:

 AWS Métricas de solicitação  
+ Abrange áreas como a latência da requisição/resposta HTTP, o número de requisições, exceções e novas tentativas.  
![\[RequestMetric 13111\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)

 AWS service (Serviço da AWS) Métricas  
+ Inclua dados AWS service (Serviço da AWS) específicos, como a taxa de transferência e a contagem de bytes para uploads e downloads do S3.  
![\[ServiceMetric 13111\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)

Métricas de máquina  
+ Abrangem o ambiente do tempo de execução, inclusive a memória do heap, o número de threads e os descritores de arquivo aberto.  
![\[MachineMetric 13111\]](http://docs.aws.amazon.com/pt_br/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)

  Se você quiser excluir métricas de máquina, adicione `excludeMachineMetrics` à propriedade do sistema:

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

## Mais informações
<a name="more-information"></a>
+ Consulte [amazonaws/metrics package summary](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html) para obter uma lista completa dos tipos de métrica de núcleo predefinidos.
+ Saiba mais sobre como trabalhar com o CloudWatch uso do AWS SDK para Java em [CloudWatch Exemplos usando AWS SDK para Java](examples-cloudwatch.md) o.
+ Saiba mais sobre o ajuste de desempenho na postagem [do blog Tuning AWS SDK para Java to Improve Resiliency](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency).