Habilitando métricas para o AWS SDK for Java - AWS SDK for Java 1.x

O AWS SDK for Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e chegará end-of-supportem 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.xpara 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 for Java

Eles AWS SDK for Java podem gerar métricas para visualização e monitoramento com a Amazon 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

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 e definir alarmes para problemas em potencial, como vazamento de memória, vazamento do descritor de arquivo etc.

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.

    RequestMetric 13111
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
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

    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