View a markdown version of this page

Activation des mesures pour le AWS SDK pour Java - AWS SDK pour Java 1.x
Comment activer la génération de métriques du SDK JavaTypes de métrique disponiblesEn savoir plus

La version AWS SDK pour Java 1.x a atteint la fin du support le 31 décembre 2025. Nous vous recommandons de migrer vers le pour continuer AWS SDK for Java 2.x à bénéficier des nouvelles fonctionnalités, des améliorations de disponibilité et des mises à jour de sécurité.

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.

Activation des mesures pour le AWS SDK pour Java

AWS SDK pour Java Vous pouvez générer des métriques à des fins de visualisation et de surveillance avec Amazon CloudWatch qui mesurent :

  • les performances de votre application lors de l'accès AWS

  • les performances de vos machines virtuelles virtuelles lorsqu'elles sont utilisées avec AWS

  • des détails sur l'environnement d'exécution comme la mémoire de segment, le nombre de threads et les descripteurs de fichier ouverts

Comment activer la génération de métriques du SDK Java

Vous devez ajouter la dépendance Maven suivante pour permettre au SDK d'envoyer des métriques à. 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>

* Remplacez le numéro de version par la dernière version du SDK disponible sur Maven Central.

AWS SDK pour Java les métriques sont désactivées par défaut. Pour l'activer pour votre environnement de développement local, incluez une propriété système qui pointe vers votre fichier d'informations AWS de sécurité lors du démarrage de la machine virtuelle Java. Par exemple :

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties

Vous devez spécifier le chemin d'accès à votre fichier d'informations d'identification afin que le SDK puisse télécharger les points de données collectés pour CloudWatch une analyse ultérieure.

Note

Si vous accédez à AWS partir d'une Amazon EC2 instance à l'aide du service de métadonnées de l' Amazon EC2 instance, vous n'avez pas besoin de spécifier de fichier d'informations d'identification. Dans ce cas, vous devez seulement spécifier :

-Dcom.amazonaws.sdk.enableDefaultMetrics

Toutes les métriques capturées par le AWS SDK pour Java se trouvent dans l'espace de noms AWSSDK/Java et sont téléchargées dans la région CloudWatch par défaut (us-east-1). Pour changer de région, spécifiez votre région en utilisant l'attribut cloudwatchRegion dans la propriété système. Par exemple, pour définir la CloudWatch région sur us-east-1, utilisez :

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}

Une fois la fonctionnalité activée, chaque fois qu'une demande de service est envoyée à AWS partir de AWS SDK pour Java, des points de données métriques sont générés, mis en file d'attente pour un résumé statistique et téléchargés de manière asynchrone CloudWatch environ une fois par minute. Une fois les métriques téléchargées, vous pouvez les visualiser à l'aide du Console de gestion AWS et définir des alarmes en cas de problèmes potentiels tels que des fuites de mémoire, des fuites de descripteurs de fichiers, etc.

Types de métrique disponibles

L'ensemble de métriques par défaut est divisé en trois catégories principales :

AWS Métriques des demandes

  • Couvre des domaines tels que la latence du protocole HTTP request/response, le nombre de requêtes, les exceptions et les nouvelles tentatives.

    RequestMetric 131111
Service AWS Métriques

  • Incluez Service AWS des données spécifiques, telles que le débit et le nombre d'octets pour les chargements et les téléchargements S3.

    ServiceMetric 131111
Métriques machine

  • Couvrent l'environnement d'exécution, y compris la mémoire de segment, le nombre de threads et les descripteurs de fichier ouverts.

    MachineMetric 131111

    Si vous souhaitez exclure les métriques machine, ajoutez excludeMachineMetrics à la propriété système :

    -Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics

En savoir plus