# Démarrage rapide

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

---

## Configuration {#setup}

1.  Téléchargez [opentelemetry-javaagent.jar][] depuis les [Releases][] du dépôt
    `opentelemetry-java-instrumentation` et placez le JAR dans le répertoire de
    votre choix. Le fichier JAR contient l'agent et les bibliothèques
    d'instrumentation.
2.  Ajoutez `-javaagent:path/to/opentelemetry-javaagent.jar` et d'autres
    configurations à vos arguments de démarrage de la JVM et lancez votre
    application :
    - Directement sur la commande de démarrage :

      ```shell
      java -javaagent:path/to/opentelemetry-javaagent.jar -Dotel.service.name=your-service-name -jar myapp.jar
      ```

    - Via les variables d'environnement `JAVA_TOOL_OPTIONS` et autres :

      ```shell
      export JAVA_TOOL_OPTIONS="-javaagent:path/to/opentelemetry-javaagent.jar"
      export OTEL_SERVICE_NAME="your-service-name"
      java -jar myapp.jar
      ```

## Configuration de l'agent {#configuring-the-agent}

L'agent est hautement configurable.

Une option consiste à passer les propriétés de configuration via le drapeau
`-D`. Dans cet exemple, un nom de service et un exportateur Zipkin pour les
traces sont configurés :

```sh
java -javaagent:path/to/opentelemetry-javaagent.jar \
     -Dotel.service.name=your-service-name \
     -Dotel.traces.exporter=zipkin \
     -jar myapp.jar
```

Vous pouvez également utiliser des variables d'environnement pour configurer
l'agent :

```sh
OTEL_SERVICE_NAME=your-service-name \
OTEL_TRACES_EXPORTER=zipkin \
java -javaagent:path/to/opentelemetry-javaagent.jar \
     -jar myapp.jar
```

Vous pouvez également fournir un fichier de propriétés Java et charger les
valeurs de configuration à partir de là :

```sh
java -javaagent:path/to/opentelemetry-javaagent.jar \
     -Dotel.javaagent.configuration-file=path/to/properties/file.properties \
     -jar myapp.jar
```

ou

```sh
OTEL_JAVAAGENT_CONFIGURATION_FILE=path/to/properties/file.properties \
java -javaagent:path/to/opentelemetry-javaagent.jar \
     -jar myapp.jar
```

Pour voir toutes les options de configuration, consultez
[Configuration de l'agent](../configuration).

## Bibliothèques, frameworks, services d'application et JVM supportés {#supported-libraries-frameworks-application-services-and-jvms}

L'agent Java est livré avec des bibliothèques d'instrumentation pour de nombreux
composants populaires. Pour la liste complète, consultez [Bibliothèques,
frameworks, services d'application et JVM supportés][support].

## Dépannage {#troubleshooting}

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.javaagent.debug</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_JAVAAGENT_DEBUG</code>
</details>

<span class="label">Description</span>:
Définissez à `true` pour voir les journaux de débogage. Notez qu&#39;ils sont assez
verbeux.
</div>


## Prochaines étapes {#next-steps}

Après avoir configuré l'instrumentation automatique pour votre application ou
service, vous pourriez [annoter](../annotations) des méthodes sélectionnées ou
ajouter une [instrumentation manuelle](/docs/languages/java/instrumentation/)
pour collecter des données de télémétrie personnalisées.

[opentelemetry-javaagent.jar]:
  https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar
[releases]:
  https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases
[support]:
  https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md