Installation de l'agent hôte sur Elastic Beanstalk d' AWS

Modifier en ligne

Installez l'agent hôte Instana sur votre environnement Elastic Beanstalk d' AWS afin de surveiller et de tracer les applications JVM qui s'exécutent dans cet environnement.

Consultez les sections suivantes pour savoir comment installer et configurer l'agent sur AWS Elastic Beanstalk :

Avant de procéder à l'installation

Modifier en ligne

Avant d'installer l'agent Instana sur AWS Elastic Beanstalk, assurez-vous de vérifier les directives suivantes :

  • Utilisez les types m5.large d'instance larger ou pour les environnements de production. Les t3.micro instances par défaut peuvent entraîner des problèmes de pénurie de ressources.

  • Configurez une connectivité réseau appropriée (communication sortante) pour l'agent d' Instana. Pour plus d'informations, consultez la section Exigences relatives à l'accès au réseau sortant.

Préparation de l'environnement

Modifier en ligne

Pour préparer l'environnement, procédez comme suit :

  1. Ouvrez AWS Cloud Shell et installez l'interface CLI Elastic Beanstalk (EBCLI) en exécutant les commandes suivantes :

    git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git

pip install virtualenv

python ./aws-elastic-beanstalk-cli-setup/scripts/ebcli_installer.py

  2. Ajoutez le chemin d'accès aux fichiers exécutables EBCLI au ~/.bashrc fichier en exécutant la commande suivante :

    echo 'export PATH="/home/cloudshell-user/.ebcli-virtual-env/executables:$PATH"' >> ~/.bashrc

  3. Actualisez la session Bash actuelle en exécutant la commande suivante :

    source ~/.bashrc

  4. Vérifiez l'installation d'EBCLI en exécutant la commande suivante :

    eb --version

Préparation d'un exemple d'application

Modifier en ligne

Pour préparer un exemple d'application Tomcat, commencez par télécharger l'exemple d'application. Ensuite, ajoutez la configuration de l'agent d' Instana à l'application.

Téléchargement de l'application exemple

Modifier en ligne

  1. Créez un répertoire de travail en exécutant les commandes suivantes :

    mkdir -p eb-tomcat1
cd eb-tomcat1

  2. Téléchargez l'application exemple Tomcat en exécutant les commandes suivantes :

    wget https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/tomcat.zip
unzip tomcat.zip

Ajout d'une configuration d'agent d' Instana

Modifier en ligne

  1. Créez un .ebextensions répertoire en exécutant la commande suivante :

    mkdir -p .ebextensions

  2. Créez le fichier de configuration de l'agent et configurez-le pour installer l'agent Instana à l'aide du script en une ligne. Voir l'exemple suivant :

    cat > .ebextensions/instana-agent.config << 'EOF'
commands:
  01_install_instana:
    command: |
      curl -o setup.sh https://setup.instana.io/agent && chmod +x setup.sh && ./setup.sh -a <INSTANA_AGENT_KEY> -t dynamic
EOF

    Remplacez <INSTANA_AGENT_KEY> par votre clé d'agent Instana.

Le script en une ligne installe et configure l'agent d' Instana.

Vous pouvez ensuite créer et initialiser votre environnement Elastic Beanstalk à l'aide de la eb init commande ou de la console AWS.

Remarque : Remarques : Si vous utilisez Amazon Linux 2023, vous devez également fournir la configuration du disque GP3. Voir l'exemple suivant : cat >. ebextensions/storage.config << 'EOF' option_settings: aws:autoscaling:launchconfiguration: RootVolumeType: gp3 EOF Si vous souhaitez configurer des variables d'environnement, utilisez la commande suivante : cat >. ebextensions/environment.config << 'EOF' option_settings: aws:elasticbeanstalk:application:environment: SERVICE_NAME: "beanstalk-tomcat" EOF

Vérification de l'installation de l'agent

Modifier en ligne

Après avoir installé l'agent, vérifiez l'installation de l'agent et consultez les journaux.

  1. Pour vérifier l'installation de l'agent, connectez-vous d'abord à l'instance EC2 en exécutant la commande suivante :

    eb ssh

  2. Vérifiez le statut de l'agent en exécutant la commande suivante :

    sudo systemctl status instana-agent

Voir l'exemple de réponse suivant :

```bash {: codeblock}
● instana-agent.service - "Instana(tm) agent."
    Loaded: loaded (/usr/lib/systemd/system/instana-agent.service; enabled; preset: disabled)
    Drop-In: /etc/systemd/system/instana-agent.service.d
            └─agent-custom-start.conf, custom-environment.conf
    Active: active (running) since Thu 2025-03-06 16:06:29 UTC; 7s ago
  Main PID: 3675 (java)
      Tasks: 28 (limit: 9245)
    Memory: 170.3M
```

Vous pouvez également vérifier l'agent dans l'interface utilisateur d' Instana en ouvrant la carte Infrastructure et en recherchant les traces.

Vérification des journaux

Modifier en ligne

Pour vérifier les fichiers journaux de l'agent, exécutez les commandes suivantes :

```bash {: codeblock}
cd /opt/instana/agent/data/log/

cat agent.log
```

Pour effacer les journaux et ne voir que les dernières entrées, exécutez les commandes suivantes :

```bash {: codeblock}
sudo systemctl stop instana-agent

sudo rm agent.log

sudo systemctl start instana-agent
```

Modification de la configuration de l'agent d' Instana

Modifier en ligne

Une fois l'environnement configuré et l'agent Instana installé, vous pouvez modifier davantage les configurations de l'agent en suivant les étapes suivantes :

  1. Sur l' AWSCloud Shell, ouvrez le répertoire de configuration Instana. Voir l'exemple suivant :

    cd /opt/instana/agent/etc/instana/

  2. Vérifiez la configuration en exécutant la commande suivante :

    ls -la

  3. Modifiez le fichier de configuration en exécutant la commande suivante :

    sudo vi configuration.yaml

  4. Pour appliquer les modifications, redémarrez l'agent en exécutant la commande suivante :

    sudo systemctl restart instana-agent

Dépannage de l'installation de l'agent

Modifier en ligne

Si l'installation de l'agent échoue, vous pouvez consulter les messages du journal et les conseils de dépannage. Pour plus d'informations sur le dépannage des agents hôtes, consultez la section Dépannage.

Consultez les problèmes couramment observés lors de l'installation de l'agent Instana sur AWS Elastic Beanstalk et leurs solutions dans les rubriques suivantes :

Connexion agent

Modifier en ligne

Si vous constatez des problèmes de connexion avec l'agent, essayez les méthodes suivantes :

  • Vérifiez si la clé de l'agent d' Instana est correcte.

  • Vérifiez la connectivité entre l'instance EC2 et le backend Instana.

  • Vérifiez les paramètres de votre groupe de sécurité.

Java suivi des applications

Modifier en ligne

Si vous constatez des problèmes avec le traçage des applications dans l' Java, essayez les méthodes suivantes :

  • Vérifiez que le capteur « Java » est activé.

  • Vérifiez la compatibilité des versions d' Java.