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 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 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 latência da HTTP solicitação/resposta, número de solicitações, exceções e novas tentativas.

    RequestMetric 13111
AWS service Métricas
  • Inclua dados AWS service 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