# Instrumentation Quarkus

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

---

[Quarkus](https://quarkus.io/) est un framework open source conçu pour aider les
développeurs à construire des applications cloud natives efficaces à la fois
avec la JVM et avec les images natives Quarkus.

Quarkus utilise des extensions pour fournir un support optimisé pour une large
gamme de bibliothèques. L'
[extension Quarkus OpenTelemetry](https://quarkus.io/guides/opentelemetry)
fournit :

- Instrumentation prête à l'emploi
- Autoconfiguration du SDK OpenTelemetry, supportant presque toutes les
  propriétés système définies pour le
  [SDK OpenTelemetry](/docs/languages/java/configuration/)
- Exportateur OTLP basé sur [Vert.x](https://vertx.io/)
- Les mêmes instrumentations peuvent être utilisées avec les images natives
  Quarkus, qui ne sont pas supportées par l'agent Java OpenTelemetry.

<div class="alert alert-secondary" role="alert"><div class="h4 alert-heading" role="heading">Note</div>



L'instrumentation Quarkus OpenTelemetry est maintenue et supportée par Quarkus.
Pour plus de détails, consultez
[Support communautaire Quarkus](https://quarkus.io/support/).

</div>


Quarkus peut également être instrumenté avec
l'[agent Java OpenTelemetry](../agent/) si vous n'exécutez pas une application
native.

## Démarrage rapide {#getting-started}

Pour activer OpenTelemetry dans votre application Quarkus, ajoutez l'extension
`quarkus-opentelemetry` comme dépendance à votre projet.

   <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="maven (`pom.xml`)" aria-controls="tabs-01-00" aria-selected="true">
        Maven (<code>pom.xml</code>)
      </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="gradle (`build.gradle`)" aria-controls="tabs-01-01" aria-selected="false">
        Gradle (<code>build.gradle</code>)
      </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-xml" data-lang="xml"><span class="line"><span class="cl"><span class="nt">&lt;dependency&gt;</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&lt;groupId&gt;</span>io.quarkus<span class="nt">&lt;/groupId&gt;</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&lt;artifactId&gt;</span>quarkus-opentelemetry<span class="nt">&lt;/artifactId&gt;</span>
</span></span><span class="line"><span class="cl"><span class="nt">&lt;/dependency&gt;</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-kotlin" data-lang="kotlin"><span class="line"><span class="cl"><span class="n">implementation</span><span class="p">(</span><span class="s2">&#34;io.quarkus:quarkus-opentelemetry&#34;</span><span class="p">)</span>
</span></span></code></pre></div>
    </div>
</div>


Seul les **traces** sont activées par défaut. Pour activer les **métriques** et
les **logs**, ajoutez la configuration suivante à votre fichier
`application.properties` :

```properties
quarkus.otel.metrics.enabled=true
quarkus.otel.logs.enabled=true
```

La journalisation OpenTelemetry est supportée par Quarkus 3.16.0+.

Pour plus de détails concernant ces options de configuration et d'autres,
consultez
[Référence de configuration OpenTelemetry](https://quarkus.io/guides/opentelemetry#configuration-reference).

## En savoir plus {#learn-more}

- [Utilisation d'OpenTelemetry](https://quarkus.io/guides/opentelemetry), une
  référence générale couvrant toutes les
  [options de configuration](https://quarkus.io/guides/opentelemetry#configuration-reference)
- Guides spécifiques aux signaux pour
  - [Traces](https://quarkus.io/guides/opentelemetry-tracing)
  - [Métriques](https://quarkus.io/guides/opentelemetry-metrics)
  - [Logs](https://quarkus.io/guides/opentelemetry-logging)