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.

CloudWatch solution : charge de travail JVM sur Amazon EC2

Cette solution vous permet de configurer la collecte de out-of-the-box métriques à l'aide d' CloudWatch agents pour les applications JVM exécutées sur des EC2 instances. En outre, il vous aide à configurer un tableau de CloudWatch bord préconfiguré. Pour des informations générales sur toutes les solutions CloudWatch d'observabilité, consultezCloudWatch solutions d'observabilité.

Prérequis

Cette solution est pertinente pour les conditions suivantes :

Avantages

La solution assure la surveillance de la JVM, fournissant des informations précieuses pour les cas d'utilisation suivants :

Voici les principaux avantages de cette solution :

L'image suivante est un exemple du tableau de bord de cette solution.

Coûts

Cette solution crée et utilise les ressources de votre compte. L'utilisation standard vous est facturée, y compris les frais suivants :

Pour plus d'informations sur CloudWatch les tarifs, consultez Amazon CloudWatch Pricing.

Le calculateur de prix peut vous aider à estimer les coûts mensuels approximatifs liés à l'utilisation de cette solution.

CloudWatch configuration de l'agent pour cette solution

L' CloudWatch agent est un logiciel qui s'exécute de manière continue et autonome sur vos serveurs et dans des environnements conteneurisés. Il collecte les métriques, les journaux et les traces de votre infrastructure et de vos applications et les envoie à CloudWatch X-Ray.

Pour plus d'informations sur l' CloudWatch agent, consultezCollectez des métriques, des journaux et des traces avec l' CloudWatch agent.

La configuration de l'agent dans cette solution collecte les métriques de base de la solution. L' CloudWatch agent peut être configuré pour collecter plus de métriques JVM que ce que le tableau de bord affiche par défaut. Pour obtenir la liste de toutes les métriques JVM que vous pouvez collecter, consultezCollectez les métriques de la JVM. Pour des informations générales sur la configuration de CloudWatch l'agent, consultezMétriques collectées par l' CloudWatch agent.

Exposez les ports JMX pour l'application JVM

L' CloudWatch agent s'appuie sur JMX pour collecter les métriques liées au processus JVM. Pour que cela soit possible, vous devez exposer le port JMX de votre application JVM. Les instructions pour exposer le port JMX dépendent du type de charge de travail que vous utilisez pour votre application JVM. Consultez la documentation de votre application pour trouver ces instructions.

En général, pour activer un port JMX à des fins de surveillance et de gestion, vous devez définir les propriétés système suivantes pour votre application JVM. Assurez-vous de spécifier un numéro de port non utilisé. L'exemple suivant configure un JMX non authentifié. Si vos politiques/exigences de sécurité vous obligent à activer JMX avec authentification par mot de passe ou SSL pour l'accès à distance, reportez-vous à la documentation JMX pour définir la propriété requise.

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=port-number
-Dcom.sun.management.jmxremote.authenticate=false 
-Dcom.sun.management.jmxremote.ssl=false

Passez en revue les scripts de démarrage et les fichiers de configuration de votre application afin de trouver le meilleur endroit pour ajouter ces arguments. Lorsque vous exécutez un .jar fichier depuis la ligne de commande, cette commande peut ressembler à ce qui suit, où se pet-search.jar trouve le nom du fichier jar de l'application.

$ java -jar -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false pet-search.jar

Configuration de l'agent pour cette solution

Les métriques collectées par l'agent sont définies dans la configuration de l'agent. La solution fournit des configurations d'agents permettant de collecter les métriques recommandées avec des dimensions adaptées au tableau de bord de la solution.

Les étapes de déploiement de la solution sont décrites plus loin dansDéployez l'agent correspondant à votre solution. Les informations suivantes ont pour but de vous aider à comprendre comment personnaliser la configuration de l'agent pour votre environnement.

Vous devez personnaliser certaines parties de la configuration d'agent suivante pour votre environnement :

Par exemple, si deux applications Java s'exécutent dans le même compte, l'une pour l'order-processingapplication et l'autre pour l'inventory-managementapplication, vous devez définir les ProcessGroupName dimensions en conséquence dans la configuration de l'agent de chaque instance.

Lorsque vous suivez ces directives, le tableau de bord de la solution regroupe automatiquement les indicateurs en fonction de la ProcessGroupName dimension. Le tableau de bord comprendra des options déroulantes permettant de sélectionner et d'afficher les métriques d'un groupe de processus spécifique, ce qui vous permettra de surveiller les performances de chaque groupe de processus séparément.

Configuration de l'agent pour les hôtes JVM

Utilisez la configuration d' CloudWatch agent suivante sur EC2 les instances où vos applications Java sont déployées. La configuration sera stockée en tant que paramètre dans le magasin de paramètres de SSM, comme détaillé plus loin dansÉtape 2 : enregistrer le fichier de configuration d' CloudWatch agent recommandé dans le magasin de paramètres de Systems Manager.

Remplacez ProcessGroupName par le nom de votre groupe de processus. port-numberRemplacez-le par le port JMX de votre application Java. Si JMX a été activé avec l'authentification par mot de passe ou le protocole SSL pour l'accès à distance, reportez-vous à la section Collectez les métriques des extensions de gestion Java (JMX) pour obtenir des informations sur la configuration du protocole TLS ou de l'autorisation dans la configuration de l'agent, selon les besoins.

Les EC2 métriques affichées dans cette configuration (configuration affichée en dehors du bloc JMX) ne fonctionnent que pour les instances Linux et macOS. Si vous utilisez des instances Windows, vous pouvez choisir d'omettre ces mesures dans la configuration. Pour plus d'informations sur les métriques collectées sur les instances Windows, consultezMesures collectées par l' CloudWatch agent sur les instances Windows Server.

{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "ProcessGroupName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}

Déployez l'agent correspondant à votre solution

Il existe plusieurs approches pour installer l' CloudWatch agent, selon le cas d'utilisation. Nous vous recommandons d'utiliser Systems Manager pour cette solution. Il fournit une expérience de console et simplifie la gestion d'un parc de serveurs gérés au sein d'un seul AWS compte. Les instructions de cette section utilisent Systems Manager et sont destinées aux situations où l' CloudWatch agent n'est pas exécuté avec des configurations existantes. Vous pouvez vérifier si l' CloudWatch agent est en cours d'exécution en suivant les étapes décrites dansVérifiez que l' CloudWatch agent est en cours d'exécution.

Si vous exécutez déjà l' CloudWatch agent sur les EC2 hôtes sur lesquels la charge de travail est déployée et que vous gérez les configurations de l'agent, vous pouvez ignorer les instructions de cette section et suivre votre mécanisme de déploiement existant pour mettre à jour la configuration. Assurez-vous de fusionner la configuration d'agent de JVM avec votre configuration d'agent existante, puis de déployer la configuration fusionnée. Si vous utilisez Systems Manager pour stocker et gérer la configuration de l' CloudWatch agent, vous pouvez fusionner la configuration avec la valeur de paramètre existante. Pour plus d'informations, consultez la section Gestion des fichiers de configuration des CloudWatch agents.

Le processus de déploiement comprend les étapes suivantes :

Étape 1 : Assurez-vous que les EC2 instances cibles disposent des autorisations IAM requises

Vous devez autoriser Systems Manager à installer et configurer l' CloudWatch agent. Vous devez également autoriser l' CloudWatch agent à publier des données télémétriques depuis votre EC2 instance vers. CloudWatch Assurez-vous que le rôle IAM attaché à l'instance est associé aux politiques Amazon SSMManaged InstanceCore IAM CloudWatchAgentServerPolicyet Amazon.

Étape 2 : enregistrer le fichier de configuration d' CloudWatch agent recommandé dans le magasin de paramètres de Systems Manager

Parameter Store simplifie l'installation de l' CloudWatch agent sur une EC2 instance en stockant et en gérant de manière sécurisée les paramètres de configuration, éliminant ainsi le besoin de valeurs codées en dur. Cela garantit un processus de déploiement plus sûr et plus flexible, permettant une gestion centralisée et des mises à jour simplifiées des configurations sur plusieurs instances.

Procédez comme suit pour enregistrer le fichier de configuration d' CloudWatch agent recommandé en tant que paramètre dans Parameter Store.

Étape 3 : Installation de l' CloudWatch agent et application de la configuration à l'aide d'un AWS CloudFormation modèle

Vous pouvez l'utiliser AWS CloudFormation pour installer l'agent et le configurer de manière à utiliser la configuration d' CloudWatch agent que vous avez créée lors des étapes précédentes.

Si vous souhaitez d'abord modifier le fichier modèle pour le personnaliser, choisissez l'option Télécharger un fichier modèle sous Create Stack Wizard pour télécharger le modèle modifié. Pour plus d'informations, consultez la section Création d'une pile sur AWS CloudFormation console. Vous pouvez utiliser le lien suivant pour télécharger le modèle : https://aws-observability-solutions.s3.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw- agent-installation-template -1.0.0.json.

Étape 4 : vérifier que la configuration de l'agent est correctement configurée

Vous pouvez vérifier si l' CloudWatch agent est installé en suivant les étapes décrites dansVérifiez que l' CloudWatch agent est en cours d'exécution. Si l' CloudWatch agent n'est pas installé et n'est pas en cours d'exécution, assurez-vous que tout est correctement configuré.

Si tout est correctement configuré, vous devriez voir les métriques JVM publiées sur CloudWatch. Vous pouvez consulter la CloudWatch console pour vérifier qu'ils sont publiés.

Création du tableau de bord de la solution JVM

Le tableau de bord fourni par cette solution présente les métriques de la machine virtuelle Java (JVM) sous-jacente pour le serveur. Il offre une vue d'ensemble de la JVM en agrégeant et en présentant des métriques sur toutes les instances, fournissant ainsi un résumé de haut niveau de l'état général et de l'état opérationnel. En outre, le tableau de bord affiche une répartition des principaux contributeurs (les 10 meilleurs widgets par métrique) pour chaque métrique. Cela vous permet d'identifier rapidement les valeurs aberrantes ou les instances qui contribuent de manière significative aux indicateurs observés.

Le tableau de bord de la solution n'affiche pas de EC2 statistiques. Pour consulter EC2 les métriques, vous devez utiliser le tableau de bord EC2 automatique pour voir les EC2 métriques vendues et utiliser le tableau de bord de la EC2 console pour voir les EC2 métriques collectées par l' CloudWatch agent. Pour plus d'informations sur les tableaux de bord automatiques pour les AWS services, consultezAfficher un CloudWatch tableau de bord pour un seul AWS service.

Pour créer le tableau de bord, vous pouvez utiliser les options suivantes :

En utilisant la CloudWatch console pour créer un tableau de bord, vous pouvez prévisualiser le tableau de bord avant de le créer et de le débiter.

Si vous souhaitez modifier le fichier modèle pour le personnaliser à quelque fin que ce soit, vous pouvez utiliser l'option Télécharger un fichier modèle sous Create Stack Wizard pour télécharger le modèle modifié. Pour plus d'informations, consultez la section Création d'une pile sur AWS CloudFormation console. Vous pouvez utiliser ce lien pour télécharger le modèle : https://aws-observability-solutions.s3.amazonaws.com/JVM_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json.

Commencez avec le tableau de bord de la JVM

Voici quelques tâches que vous pouvez essayer avec le nouveau tableau de bord JVM. Ces tâches vous permettent de vérifier que le tableau de bord fonctionne correctement et de vous fournir une expérience pratique de son utilisation pour surveiller un groupe de processus JVM. En les essayant, vous vous familiariserez avec la navigation dans le tableau de bord et l'interprétation des indicateurs visualisés.

Sélectionnez un groupe de processus

Utilisez la liste déroulante Nom du groupe de processus JVM pour sélectionner le groupe de processus que vous souhaitez surveiller. Le tableau de bord est automatiquement mis à jour pour afficher les métriques du groupe de processus sélectionné. Si vous disposez de plusieurs applications ou environnements Java, chacun peut être représenté sous la forme d'un groupe de processus distinct. La sélection du groupe de processus approprié garantit que vous visualisez les métriques spécifiques à l'application ou à l'environnement que vous souhaitez analyser.

Vérifiez l'utilisation de la mémoire

Dans la section de présentation du tableau de bord, trouvez les widgets Pourcentage d'utilisation de la mémoire en tas et Pourcentage d'utilisation de la mémoire hors mémoire. Ils indiquent le pourcentage de mémoire en tas et hors segment utilisé JVMs dans l'ensemble du groupe de processus sélectionné. Un pourcentage élevé indique une pression de mémoire potentielle susceptible d'entraîner des problèmes de performances ou OutOfMemoryError des exceptions. Vous pouvez également effectuer une analyse détaillée de l'utilisation du tas par hôte sous Utilisation de la mémoire par hôte afin de vérifier les hôtes les plus utilisés.

Analyser les fils et les classes chargés

Dans la section Threads and classes Loaded by host, trouvez les widgets « Nombre de fils et 10 classes chargées le plus ». Recherchez ceux qui ont JVMs un nombre anormalement élevé de fils ou de classes par rapport aux autres. Un trop grand nombre de threads peut indiquer des fuites de threads ou une simultanéité excessive, tandis qu'un grand nombre de classes chargées peut indiquer des fuites potentielles dans le chargeur de classes ou une génération de classes dynamiques inefficace.

Identifier les problèmes liés à la collecte des déchets

Dans la section Collecte des déchets, trouvez les 10 meilleures invocations de collecte de déchets par minute et les 10 meilleurs widgets de durée de collecte des déchets pour les différents types de ramasseurs : jeune, simultané et mixte. Recherchez ceux JVMs qui ont un nombre anormalement élevé de collections ou dont la durée de collecte est longue par rapport aux autres. Cela peut indiquer des problèmes de configuration ou des fuites de mémoire.