# Інструментування Quarkus

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

---

[Quarkus](https://quarkus.io/) — це фреймворк з відкритим кодом, розроблений для допомоги розробникам програмного забезпечення у створенні ефективних хмарних застосунків як для JVM, так і для Quarkus native image застосунків.

Quarkus використовує розширення для забезпечення оптимізованої підтримки широкого спектра бібліотек. [Розширення Quarkus OpenTelemetry](https://quarkus.io/guides/opentelemetry) забезпечує:

- Інструментування "з коробки"
- Автоконфігурацію OpenTelemetry SDK, що підтримує майже всі системні властивості, визначені для [OpenTelemetry SDK](/docs/languages/java/configuration/)
- Експортер OTLP на основі [Vert.x](https://vertx.io/)
- Ті самі інструменти можна використовувати з native image застосунками, які не підтримуються агентом OpenTelemetry Java.

> [!NOTE]
>
> Інструментування Quarkus OpenTelemetry підтримується спільнотою Quarkus. Для деталей дивіться [підтримку спільноти Quarkus](https://quarkus.io/support/).

Quarkus також можна інструментувати за допомогою [агента OpenTelemetry Java](../agent/), якщо ви не використовуєте застосунок з native image.

## Початок роботи {#getting-started}

Щоб увімкнути OpenTelemetry у вашому застосунку Quarkus, додайте залежність розширення `quarkus-opentelemetry` до вашого проєкту.

   <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="maven (`pom.xml`)" aria-controls="tabs-00-00" aria-selected="true">
        Maven (<code>pom.xml</code>)
      </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="gradle (`build.gradle`)" aria-controls="tabs-00-01" aria-selected="false">
        Gradle (<code>build.gradle</code>)
      </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-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-00-01" role="tabpanel" aria-labelled-by="tabs-00-01-tab" tabindex="0">
        <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>


Стандартно увімкнено лише сигнал **tracing**. Щоб увімкнути **metrics** та **logs**, додайте наступну конфігурацію до вашого файлу `application.properties`:

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

Логування OpenTelemetry підтримується Quarkus 3.16.0+.

Для деталей щодо цих та інших параметрів конфігурації дивіться [довідник з конфігурації OpenTelemetry](https://quarkus.io/guides/opentelemetry#configuration-reference).

## Дізнатися більше {#learn-more}

- [Використання OpenTelemetry](https://quarkus.io/guides/opentelemetry), загальний довідник, що охоплює всі [параметри конфігурації](https://quarkus.io/guides/opentelemetry#configuration-reference)
- Посібники, специфічні для сигналів:
  - [Tracing](https://quarkus.io/guides/opentelemetry-tracing)
  - [Metrics](https://quarkus.io/guides/opentelemetry-metrics)
  - [Logs](https://quarkus.io/guides/opentelemetry-logging)
