Démarrage (supplément)
Dans les sections suivantes, découvrez comment obtenir l’autoinstrumentation Java pour des environnements techniques spécifiques.
Azure App Service
Pour plus d’informations, consultez Supervision des applications pour Azure App Service et Java.
Azure Functions
Pour plus d’informations, consultez Surveillance d’Azure Functions avec Application Insights d’Azure Monitor.
Azure Spring Apps
Pour plus d’informations, consultez Utiliser l’agent in-process Java d’Application Insights dans Azure Spring Apps.
conteneurs
Remarque
Avec les applications Spring Boot Native Image, utilisez le projet Distribution OpenTelemetry Azure Monitor / Application Insights dans l’application Java d’image native Spring Boot au lieu de l’agent Java Application Insights.
Point d’entrée Docker
Si vous utilisez le formulaire exec, ajoutez le paramètre -javaagent:"path/to/applicationinsights-agent-3.6.0.jar"
à la liste de paramètres quelque part avant le paramètre "-jar"
, par exemple :
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.6.0.jar", "-jar", "<myapp.jar>"]
Si vous utilisez le formulaire shell, ajoutez l’argument JVM (Java Virtual Machine) -javaagent:"path/to/applicationinsights-agent-3.6.0.jar"
quelque part avant -jar
, par exemple :
ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.6.0.jar" -jar <myapp.jar>
Fichier Docker
Exemple Dockerfile :
FROM ...
COPY target/*.jar app.jar
COPY agent/applicationinsights-agent-3.6.0.jar applicationinsights-agent-3.6.0.jar
COPY agent/applicationinsights.json applicationinsights.json
ENV APPLICATIONINSIGHTS_CONNECTION_STRING="CONNECTION-STRING"
ENTRYPOINT["java", "-javaagent:applicationinsights-agent-3.6.0.jar", "-jar", "app.jar"]
Dans cet exemple, vous copiez les fichiers applicationinsights-agent-3.6.0.jar
et applicationinsights.json
à partir d’un dossier agent
(vous pouvez choisir n’importe quel dossier de votre ordinateur). Ces deux fichiers doivent se trouver dans le même dossier du conteneur Docker.
Images conteneur de partenaires
Si vous utilisez une image conteneur partenaire que vous ne pouvez pas modifier, montez le fichier jar de l’agent Java Application Insights dans le conteneur de l’extérieur. Définissez la variable d’environnement du conteneur JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar
.
Spring Boot
Pour plus d’informations, consultez Utilisation d’Azure Monitor Application Insights avec Spring Boot.
Serveurs d’application Java
Pour plus d’informations sur la configuration de l’agent Java Application Insights, consultez Activation d’Azure Monitor OpenTelemetry pour Java. Les sections suivantes fournissent des détails qui peuvent être utiles lors de la configuration de l’argument JVM -javaagent:...
sur différents serveurs d’applications.
Tomcat 8 (Linux)
Tomcat installé via apt-get ou yum
Si vous avez installé Tomcat via apt-get
ou yum
, vous devez disposer d’un fichier /etc/tomcat8/tomcat8.conf
. Ajoutez cette ligne à la fin de ce fichier :
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.6.0.jar"
Tomcat installé via le téléchargement et la décompression
Si vous avez installé Tomcat via le téléchargement et la décompression depuis https://tomcat.apache.org, vous devez disposer d’un fichier <tomcat>/bin/catalina.sh
. Créez un fichier dans le même répertoire nommé <tomcat>/bin/setenv.sh
avec le contenu suivant :
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.6.0.jar"
Si le fichier <tomcat>/bin/setenv.sh
existe déjà, modifiez-le et ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à CATALINA_OPTS
.
Tomcat 8 (Windows)
Exécuter Tomcat à partir de la ligne de commande
Localisez le fichier <tomcat>/bin/catalina.bat
. Créez un fichier dans le même répertoire nommé <tomcat>/bin/setenv.bat
avec le contenu suivant :
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.6.0.jar
Les guillemets ne sont pas nécessaires, mais si vous souhaitez les inclure, le positionnement qui convient est le suivant :
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.6.0.jar"
Si le fichier <tomcat>/bin/setenv.bat
existe déjà, modifiez-le et ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à CATALINA_OPTS
.
Exécuter Tomcat en tant que service Windows
Localisez le fichier <tomcat>/bin/tomcat8w.exe
. Exécutez ce fichier exécutable et ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à Java Options
sous l’onglet Java
.
JBoss Enterprise Application Platform 7
Dans Red Hat JBoss Enterprise Application Platform (EAP) 7, vous pouvez configurer un serveur autonome ou un serveur de domaine.
Serveur autonome
Ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à la variable d’environnement JAVA_OPTS
existante dans le fichier JBOSS_HOME/bin/standalone.conf
(Linux) ou JBOSS_HOME/bin/standalone.conf.bat
(Windows) :
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.6.0.jar -Xms1303m -Xmx1303m ..."
...
Serveur de domaine
Ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à jvm-options
dans JBOSS_HOME/domain/configuration/host.xml
:
...
<jvms>
<jvm name="default">
<heap size="64m" max-size="256m"/>
<jvm-options>
<option value="-server"/>
<!--Add Java agent jar file here-->
<option value="-javaagent:path/to/applicationinsights-agent-3.6.0.jar"/>
<option value="-XX:MetaspaceSize=96m"/>
<option value="-XX:MaxMetaspaceSize=256m"/>
</jvm-options>
</jvm>
</jvms>
...
Si vous exécutez plusieurs serveurs managés sur un seul hôte, vous devez ajouter applicationinsights.agent.id
au system-properties
pour chaque server
:
...
<servers>
<server name="server-one" group="main-server-group">
<!--Edit system properties for server-one-->
<system-properties>
<property name="applicationinsights.agent.id" value="..."/>
</system-properties>
</server>
<server name="server-two" group="main-server-group">
<socket-bindings port-offset="150"/>
<!--Edit system properties for server-two-->
<system-properties>
<property name="applicationinsights.agent.id" value="..."/>
</system-properties>
</server>
</servers>
...
La valeur applicationinsights.agent.id
spécifiée doit être unique. Vous utilisez la valeur pour créer un sous-répertoire sous le répertoire Application Insights. Chaque processus JVM a besoin de sa propre configuration Application Insights locale et de son propre fichier journal Application Insights local. En outre, si vous signalez au collecteur central, plusieurs serveurs managés partagent le fichier applicationinsights.properties
, de sorte que le applicationinsights.agent.id
spécifié est nécessaire pour remplacer le paramètre de agent.id
dans ce fichier partagé. applicationinsights.agent.rollup.id
peut être spécifié de manière similaire dans l’élément system-properties
du serveur si vous devez écraser le paramètre agent.rollup.id
par serveur géré.
Jetty 9
Ajoutez ces lignes à start.ini
:
--exec
-javaagent:path/to/applicationinsights-agent-3.6.0.jar
Payara 5
Ajoutez -javaagent:path/to/applicationinsights-agent-3.6.0.jar
à jvm-options
dans glassfish/domains/domain1/config/domain.xml
:
...
<java-config ...>
<!--Edit the JVM options here-->
<jvm-options>
-javaagent:path/to/applicationinsights-agent-3.6.0.jar>
</jvm-options>
...
</java-config>
...
WebSphere 8
Ouvrez la console de gestion.
Accédez à Serveurs>Serveurs d’applications WebSphere>Serveurs d’applications. Choisissez les serveurs d’applications appropriés, puis sélectionnez définition de processus>de gestion des processus>machine virtuelle Java.
Dans
Generic JVM arguments
, ajoutez l’argument JVM suivant.-javaagent:path/to/applicationinsights-agent-3.6.0.jar
Enregistrez et redémarrez le serveur d’applications.
OpenLiberty 18
Créez un fichier jvm.options
dans le répertoire du serveur (par exemple <openliberty>/usr/servers/defaultServer
), puis ajoutez cette ligne :
-javaagent:path/to/applicationinsights-agent-3.6.0.jar
Autres
Pour plus d’informations sur l’ajout d’arguments JVM, consultez la documentation de votre serveur d’applications.