Publiez les métriques du SDK à partir du AWS SDK for Java 2.x - AWS SDK for Java 2.x
Commencer à utiliser les métriques du SDKAperçu rapide de la mise en œuvreQuand les statistiques sont-elles disponibles ?Quelles informations sont collectées ?Comment puis-je utiliser ces informations ?

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Publiez les métriques du SDK à partir du AWS SDK for Java 2.x

AWS SDK for Java 2.x Vous pouvez ainsi collecter des statistiques sur les clients et les demandes de service dans votre application, analyser les résultats dans Amazon CloudWatch Logs, puis agir en conséquence.

Par défaut, la collecte de métriques est désactivée dans le SDK. Cette rubrique vous aide à l'activer et à le configurer.

Commencer à utiliser les métriques du SDK

Pour activer la collecte de métriques dans votre application, choisissez l'implémentation appropriée de l'MetricPublisherinterface en fonction de votre cas d'utilisation et suivez les instructions de configuration détaillées :

Pour les applications de longue durée :

Pour les AWS Lambda fonctions :

Pour le dépannage et les sorties de console :

Aperçu rapide de la mise en œuvre

Voici à quoi ressemble l'activation des métriques pour chaque cas d'utilisation :

Applications de longue durée :

MetricPublisher metricsPub = CloudWatchMetricPublisher.create();
DynamoDbClient ddb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
    .build();

Fonctions Lambda :

EmfMetricLoggingPublisher emfPublisher = EmfMetricLoggingPublisher.builder()
    .namespace("MyApp")
    .build();
DynamoDbClient dynamoDb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(emfPublisher))
    .build();

Développement et débogage :

MetricPublisher loggingPublisher = LoggingMetricPublisher.create();
S3Client s3 = S3Client.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(loggingPublisher))
    .build();

Pour obtenir des informations complètes sur l'implémentation, les dépendances et les options de configuration, consultez les guides de configuration ci-dessus.

Quand les statistiques sont-elles disponibles ?

Les métriques sont généralement disponibles dans les 5 à 10 minutes suivant leur émission par le SDK for Java. Pour des up-to-date statistiques précises, vérifiez Cloudwatch au moins 10 minutes après avoir émis les métriques depuis vos applications Java.

Quelles informations sont collectées ?

La collecte de métriques inclut les éléments suivants :

  • Nombre de demandes d'API, y compris si elles aboutissent ou échouent

  • Informations sur les requêtes Services AWS que vous appelez dans vos demandes d'API, y compris les exceptions renvoyées

  • Durée des différentes opérations telles que le marshalling, la signature et les requêtes HTTP

  • Mesures du client HTTP, telles que le nombre de connexions ouvertes, le nombre de demandes en attente et le nom du client HTTP utilisé

Note

Les métriques disponibles varient selon le client HTTP.

Pour une liste complète, consultez la section Mesures relatives aux clients du service.

Comment puis-je utiliser ces informations ?

Vous pouvez utiliser les métriques collectées par le SDK pour surveiller les clients de service de votre application. Vous pouvez examiner les tendances générales d'utilisation, identifier les anomalies, examiner les exceptions renvoyées par les clients du service ou approfondir la compréhension d'un problème particulier. À l'aide d'Amazon CloudWatch Logs, vous pouvez également créer des alarmes pour vous avertir dès que votre application atteint une condition que vous définissez.

Pour plus d'informations, consultez les sections Utilisation CloudWatch des métriques Amazon Logs et Utilisation CloudWatch des alarmes Amazon Logs dans le guide de l'utilisateur Amazon CloudWatch Logs.

Rubriques