# Configuration du serveur d'application

> Apprenez à définir les chemins d'agent pour les serveurs d'applications Java

---

LLMS index: [llms.txt](/llms.txt)

---

Lors de l'instrumentation d'une application qui s'exécute sur un serveur
d'applications Java avec un agent Java, vous devez ajouter le chemin `javaagent`
aux arguments de la JVM. La manière de le faire diffère d'un serveur à l'autre.

## JBoss EAP / WildFly {#jboss-eap--wildfly}

Vous pouvez ajouter l'argument `javaagent` à la fin du fichier de configuration
:



  <ul class="nav nav-tabs" id="tabs-0" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-00-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-00" role="tab"
          data-td-tp-persist="linux" aria-controls="tabs-00-00" aria-selected="true">
        Linux
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-00-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-00-01" role="tab"
          data-td-tp-persist="windows" aria-controls="tabs-00-01" aria-selected="false">
        Windows
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-0-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-00-00" role="tabpanel" aria-labelled-by="tabs-00-00-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="c1"># Ajouter à standalone.conf {#add-to-standaloneconf}</span>
</span></span><span class="line"><span class="cl"><span class="nv">JAVA_OPTS</span><span class="o">=</span><span class="s2">&#34;</span><span class="nv">$JAVA_OPTS</span><span class="s2"> -javaagent:/path/to/opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-00-01" role="tabpanel" aria-labelled-by="tabs-00-01-tab" tabindex="0">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bat" data-lang="bat"><span class="line"><span class="cl"><span class="c1">rem Ajouter à standalone.conf.bat</span>
</span></span><span class="line"><span class="cl"><span class="k">set</span> <span class="s2">&#34;JAVA_OPTS=</span><span class="nv">%JAVA_OPTS%</span><span class="s2"> -javaagent:&lt;Drive&gt;:\path\to\opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
</div>


## Jetty {#jetty}

Pour définir le chemin vers l'agent Java, utilisez l'argument `-javaagent` :

```shell
java -javaagent:/path/to/opentelemetry-javaagent.jar -jar start.jar
```

Si vous utilisez le fichier `jetty.sh` pour démarrer Jetty, ajoutez la ligne
suivante au fichier `\<jetty_home\>/bin/jetty.sh` :

```shell
JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/opentelemetry-javaagent.jar"
```

Si vous utilisez le fichier start.ini pour définir les arguments de la JVM,
ajoutez l'argument `javaagent` après l'option `--exec` :

```ini
#===========================================================
# Exemple de fichier start.ini pour Jetty {#sample-jetty-startini-file}
#-----------------------------------------------------------
--exec
-javaagent:/path/to/opentelemetry-javaagent.jar
```

## Glassfish / Payara {#glassfish--payara}

Ajoutez le chemin vers l'agent Java en utilisant l'outil `asadmin` :

   <ul class="nav nav-tabs" id="tabs-1" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-01-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-00" role="tab"
          data-td-tp-persist="linux" aria-controls="tabs-01-00" aria-selected="true">
        Linux
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-01-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-01-01" role="tab"
          data-td-tp-persist="windows" aria-controls="tabs-01-01" aria-selected="false">
        Windows
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-1-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-01-00" role="tabpanel" aria-labelled-by="tabs-01-00-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">&lt;server_install_dir&gt;/bin/asadmin create-jvm-options <span class="s2">&#34;-javaagent\:/path/to/opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-01-01" role="tabpanel" aria-labelled-by="tabs-01-01-tab" tabindex="1">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="p">&lt;</span><span class="n">server_install_dir</span><span class="p">&gt;\</span><span class="n">bin</span><span class="p">\</span><span class="n">asadmin</span><span class="p">.</span><span class="py">bat</span> <span class="nb">create-jvm</span><span class="n">-options</span> <span class="s1">&#39;-javaagent\:&lt;Drive&gt;\:\\path\\to\\opentelemetry-javaagent.jar&#39;</span>
</span></span></code></pre></div>
    </div>
</div>


Vous pouvez également ajouter l'argument `-javaagent` depuis la console
d'administration. Par exemple :

1.  Ouvrez la console d'administration de GlassFish sur <http://localhost:4848>.
2.  Allez à **Configurations > server-config > JVM Settings**.
3.  Sélectionnez **JVM Options > Add JVM Option**.
4.  Entrez le chemin vers l'agent :
    `-javaagent:/path/to/opentelemetry-javaagent.jar`
5.  **Enregistrez** et redémarrez le serveur.

Assurez-vous que le fichier domain.xml dans votre répertoire de domaine contient
une entrée `<jmv-options>` pour l'agent.

## Tomcat / TomEE {#tomcat--tomee}

Ajoutez le chemin vers l'agent Java à votre script de démarrage :



  <ul class="nav nav-tabs" id="tabs-2" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-02-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-00" role="tab"
          data-td-tp-persist="linux" aria-controls="tabs-02-00" aria-selected="true">
        Linux
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-02-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-02-01" role="tab"
          data-td-tp-persist="windows" aria-controls="tabs-02-01" aria-selected="false">
        Windows
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-2-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-02-00" role="tabpanel" aria-labelled-by="tabs-02-00-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="c1"># Ajouter à &lt;tomcat_home&gt;/bin/setenv.sh {#add-to-tomcat_homebinsetenvsh}</span>
</span></span><span class="line"><span class="cl"><span class="nv">CATALINA_OPTS</span><span class="o">=</span><span class="s2">&#34;</span><span class="nv">$CATALINA_OPTS</span><span class="s2"> -javaagent:/path/to/opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-02-01" role="tabpanel" aria-labelled-by="tabs-02-01-tab" tabindex="2">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bat" data-lang="bat"><span class="line"><span class="cl"><span class="c1">rem Ajouter à &lt;tomcat_home&gt;\bin\setenv.bat</span>
</span></span><span class="line"><span class="cl"><span class="k">set</span> <span class="nv">CATALINA_OPTS</span><span class="p">=</span><span class="nv">%CATALINA_OPTS%</span> -javaagent:<span class="s2">&#34;&lt;Drive&gt;:\path\to\opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
</div>


## WebLogic {#weblogic}

Ajoutez le chemin vers l'agent Java à votre script de démarrage de domaine :



  <ul class="nav nav-tabs" id="tabs-3" role="tablist">
  <li class="nav-item">
      <button class="nav-link active"
          id="tabs-03-00-tab" data-bs-toggle="tab" data-bs-target="#tabs-03-00" role="tab"
          data-td-tp-persist="linux" aria-controls="tabs-03-00" aria-selected="true">
        Linux
      </button>
    </li><li class="nav-item">
      <button class="nav-link"
          id="tabs-03-01-tab" data-bs-toggle="tab" data-bs-target="#tabs-03-01" role="tab"
          data-td-tp-persist="windows" aria-controls="tabs-03-01" aria-selected="false">
        Windows
      </button>
    </li>
</ul>

<div class="tab-content" id="tabs-3-content">
    <div class="tab-body tab-pane fade show active"
        id="tabs-03-00" role="tabpanel" aria-labelled-by="tabs-03-00-tab" tabindex="3">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="c1"># Ajouter à &lt;domain_home&gt;/bin/startWebLogic.sh {#add-to-domain_homebinstartweblogicsh}</span>
</span></span><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">JAVA_OPTIONS</span><span class="o">=</span><span class="s2">&#34;</span><span class="nv">$JAVA_OPTIONS</span><span class="s2"> -javaagent:/path/to/opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
    <div class="tab-body tab-pane fade"
        id="tabs-03-01" role="tabpanel" aria-labelled-by="tabs-03-01-tab" tabindex="3">
        <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bat" data-lang="bat"><span class="line"><span class="cl"><span class="c1">rem Ajouter à &lt;domain_home&gt;\bin\startWebLogic.cmd</span>
</span></span><span class="line"><span class="cl"><span class="k">set</span> <span class="nv">JAVA_OPTIONS</span><span class="p">=</span><span class="nv">%JAVA_OPTIONS%</span> -javaagent:<span class="s2">&#34;&lt;Drive&gt;:\path\to\opentelemetry-javaagent.jar&#34;</span>
</span></span></code></pre></div>
    </div>
</div>


Pour les instances de serveur géré, ajoutez l'argument `-javaagent` en utilisant
la console d'administration.

## WebSphere Liberty Profile {#websphere-liberty-profile}

Ajoutez le chemin vers l'agent Java au fichier `jvm.options`. Pour un seul
serveur, éditez `${server.config.dir}/jvm.options`, et pour tous les serveurs,
éditez `${wlp.install.dir}/etc/jvm.options` :

```ini
-javaagent:/path/to/opentelemetry-javaagent.jar
```

Redémarrez le serveur après avoir enregistré le fichier.

## WebSphere Traditional {#websphere-traditional}

Ouvrez la console d'administration de WebSphere et suivez ces étapes :

<!-- markdownlint-disable blanks-around-fences -->

1.  Naviguez vers **Servers > Server type > WebSphere application servers**.
2.  Sélectionnez le serveur.
3.  Allez à **Java and Process Management > Process Definition**.
4.  Sélectionnez **Java Virtual Machine**.
5.  Dans **Generic JVM arguments**, entrez le chemin vers l'agent :
    `-javaagent:/path/to/opentelemetry-javaagent.jar`.
6.  Enregistrez la configuration et redémarrez le serveur.
