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á.
Publicar métricas do SDK pelo AWS SDK for Java 2.x
Com o AWS SDK for Java 2.x, é possível coletar métricas sobre os clientes de serviço e solicitações em sua aplicação, analisar a saída no Amazon CloudWatch Logs, então, agir de acordo com elas.
Por padrão, a coleta de métricas está desativada no SDK. Este tópico ajuda a habilitar e configurá-lo.
Conceitos básicos das métricas de SDK
Para habilitar a coleta de métricas na aplicação, escolha a implementação apropriada da interface MetricPublisher com base no seu caso de uso e siga as instruções detalhadas de configuração:
Para aplicações de longa execução:
-
Consulte instruções completas de configuração, exemplos de código e opções de configuração em Publicar métricas do SDK de aplicações de longa execução.
Para funções do AWS Lambda:
-
Consulte instruções completas de configuração, dependências e configurações específicas do Lambda em Publicar métricas do SDK para funções do AWS Lambda.
Para solução de problemas e saída do console:
-
Consulte instruções de configuração, opções de formatação e exemplos de desenvolvimento e solução de problemas locais em Exibir métricas do SDK no console para desenvolvimento e depuração.
Pré-visualização da implementação rápida
Veja como é a ativação de métricas para cada caso de uso:
Aplicações de longa execução:
MetricPublisher metricsPub = CloudWatchMetricPublisher.create(); DynamoDbClient ddb = DynamoDbClient.builder() .overrideConfiguration(c -> c.addMetricPublisher(metricsPub)) .build();
Funções do Lambda:
EmfMetricLoggingPublisher emfPublisher = EmfMetricLoggingPublisher.builder() .namespace("MyApp") .build(); DynamoDbClient dynamoDb = DynamoDbClient.builder() .overrideConfiguration(c -> c.addMetricPublisher(emfPublisher)) .build();
Desenvolvimento e depuração:
MetricPublisher loggingPublisher = LoggingMetricPublisher.create(); S3Client s3 = S3Client.builder() .overrideConfiguration(c -> c.addMetricPublisher(loggingPublisher)) .build();
Limitação de métricas do cliente do S3 baseado no AWS CRT
Atualmente, o Cliente do S3 baseado no AWS CRT não permite a coleta de métricas do SDK. O compilador de uma instância de cliente do S3 baseada no AWS CRT, S3CrtAsyncClientBuilder
Quando as métricas estão disponíveis?
As métricas geralmente ficam disponíveis em 5 a 10 minutos após a emissão das métricas pelo SDK para Java. Para ter métricas precisas e atualizadas, confira o Cloudwatch pelo menos 10 minutos depois de emitir as métricas das aplicações Java.
Quais informações são coletadas?
A coleção de métricas inclui o seguinte:
-
Número de solicitações de API, incluindo se foram bem-sucedidas ou se falharam
-
Informações sobre os Serviços da AWS que você chama em suas solicitações de API, incluindo exceções retornadas
-
A duração de várias operações, como marshalling, assinatura e solicitações HTTP
-
Métricas do cliente HTTP, como o número de conexões abertas, o número de solicitações pendentes e o nome do cliente HTTP usado
nota
As métricas disponíveis variam de acordo com o cliente HTTP.
Para obter uma lista completa, consulte Métricas de serviço do cliente.
Como posso usar essas informações?
Use as métricas que o SDK coleta para monitorar os clientes de serviço em sua aplicação. Você pode analisar as tendências gerais de uso, identificar anomalias, analisar as exceções retornadas pelos clientes de serviço ou obter mais informações para entender um problema específico. Com o Amazon CloudWatch Logs, também é possível criar alarmes para notificar você assim que a aplicação atingir uma condição definida.
Consulte mais informações em Usar métricas do Amazon CloudWatch Logs e Usar alarmes do Amazon CloudWatch Logs no Guia do usuário do Amazon CloudWatch Logs.
