O AWS SDK for Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e chegará end-of-support
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 for Java
Eles AWS SDK for Java podem gerar métricas para visualização e monitoramento com a Amazon CloudWatch
-
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
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>
*Substitua o número da versão pela versão mais recente do SDK disponível na central do Maven
AWS SDK for 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 for 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 for 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 AWS Management Console
Tipos de métrica disponíveis
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.
-
- 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.
-
- 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.
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
-
Consulte amazonaws/metrics package summary 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 for Java em CloudWatch Exemplos usando AWS SDK for Java o.
-
Saiba mais sobre o ajuste de desempenho na postagem do blog Tuning AWS SDK for Java to Improve Resiliency
.