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á.
Publique métricas do SDK a partir do AWS SDK for Java 2.x
Com isso, AWS SDK for Java 2.x você pode coletar métricas sobre os clientes de serviços e solicitações em seu aplicativo, analisar a saída no Amazon CloudWatch Logs e, em seguida, agir de acordo com ela.
Por padrão, a coleta de métricas está desativada no SDK. Este tópico ajuda a habilitar e configurá-lo.
Introdução às métricas do SDK
Para habilitar a coleta de métricas em seu aplicativo, escolha a implementação apropriada da MetricPublisher interface com base no seu caso de uso e siga as instruções detalhadas de configuração:
Para aplicativos de longa duração:
-
Usar o
CloudWatchMetricPublisher -
Consulte Publicar métricas do SDK de aplicativos de longa execução para obter instruções completas de configuração, exemplos de código e opções de configuração.
Para AWS Lambda funções:
-
Usar o
EmfMetricLoggingPublisher -
Consulte Publicar métricas do SDK para AWS Lambda funções para obter instruções completas de configuração, dependências e configurações específicas do Lambda.
Para solução de problemas e saída do console:
-
Usar o
LoggingMetricPublisher -
Consulte Métricas do SDK de saída para o console para desenvolvimento e depuração para obter instruções de configuração, opções de formatação e exemplos de desenvolvimento e solução de problemas locais.
Pré-visualização rápida da implementação
Veja como é a ativação de métricas para cada caso de uso:
Aplicativos de longa duração:
MetricPublisher metricsPub = CloudWatchMetricPublisher.create(); DynamoDbClient ddb = DynamoDbClient.builder() .overrideConfiguration(c -> c.addMetricPublisher(metricsPub)) .build();
Funções 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();
Para obter detalhes completos da implementação, dependências e opções de configuração, consulte os guias de configuração acima.
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 obter up-to-date métricas precisas, verifique o Cloudwatch pelo menos 10 minutos depois de emitir as métricas de seus aplicativos 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 o 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. Usando o Amazon CloudWatch Logs, você também pode criar alarmes para notificá-lo assim que seu aplicativo atingir uma condição definida por você.
Para obter mais informações, consulte Como usar métricas do Amazon CloudWatch Logs e Usar alarmes do Amazon CloudWatch Logs no Guia do usuário do Amazon CloudWatch Logs.
Tópicos
