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 SDK métricas Java
Você precisa adicionar a seguinte dependência do Maven para permitir o envio de métricas SDK 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 da SDK disponível no Maven Central
AWS SDK for Java as métricas são desativadas por padrão. Para habilitá-lo em seu ambiente de desenvolvimento local, inclua uma propriedade do sistema que aponte para seu arquivo de credencial de AWS segurança ao iniciar o. JVM Por exemplo:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
Você precisa especificar o caminho para seu arquivo de credencial para que ele SDK possa carregar os pontos de dados coletados CloudWatch para 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 latência da HTTP solicitação/resposta, número de solicitaçõ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
.