# Quarkus計装

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

---

[Quarkus](https://quarkus.io/)は、ソフトウェア開発者がJVMとQuarkusネイティブイメージアプリケーションの両方で効率的なクラウドネイティブアプリケーションを構築するのを支援するために設計されたオープンソースフレームワークです。

Quarkusは、幅広いライブラリに最適化されたサポートを提供するためにエクステンションを使用します。
[Quarkus OpenTelemetryエクステンション](https://quarkus.io/guides/opentelemetry)は以下を提供します。

- すぐに使える計装
- OpenTelemetry SDKの自動設定、[OpenTelemetry SDK](/docs/languages/java/configuration/)で定義されたほぼすべてのシステムプロパティをサポート
- [Vert.x](https://vertx.io/)ベースのOTLPエクスポーター
- OpenTelemetry Javaエージェントでサポートされていないネイティブイメージアプリケーションでも同じ計装を使用可能

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



Quarkus OpenTelemetry計装は、Quarkusによって保守およびサポートされています。
詳細については、[Quarkusコミュニティサポート](https://quarkus.io/support/)をご覧ください。

</div>


ネイティブイメージアプリケーションを実行していない場合、Quarkusは[OpenTelemetry Javaエージェント](../agent/)でも計装可能です。

## はじめに {#getting-started}

QuarkusアプリケーションでOpenTelemetryを有効にするには、プロジェクトに`quarkus-opentelemetry`エクステンションの依存関係を追加します。

   <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>


デフォルトでは**トレーシング**シグナルのみが有効になっています。
**メトリクス**と**ログ**を有効にするには、`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)オプションをカバーする一般的なリファレンス
- シグナル固有のガイド
  - [トレーシング](https://quarkus.io/guides/opentelemetry-tracing)
  - [メトリクス](https://quarkus.io/guides/opentelemetry-metrics)
  - [ログ](https://quarkus.io/guides/opentelemetry-logging)
