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

La AWS SDK for Java version 1.x est entrée en mode maintenance le 31 juillet 2024 et atteindra end-of-supportle 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 métriques pour AWS SDK for Java

Ils AWS SDK for Java peuvent 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 votre appareil JVMs lorsqu'il est utilisé 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 SDK métriques Java

Vous devez ajouter la dépendance Maven suivante pour permettre l'envoi SDK de 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 SDK disponible sur Maven Central.

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

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

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

Note

Si vous accédez AWS depuis une Amazon EC2 instance à l'aide du service de métadonnées d' 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 for Java se trouvent sous 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, des points AWS de données métriques sont générés AWS SDK for Java, 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 de AWS Management Consoleet définir des alarmes en cas de problèmes potentiels tels que les fuites de mémoire, les 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 de la HTTP demande/réponse, le nombre de demandes, 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 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