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

Quarkus — це фреймворк з відкритим кодом, розроблений для допомоги розробникам програмного забезпечення у створенні ефективних хмарних застосунків як для JVM, так і для Quarkus native image застосунків.

Quarkus використовує розширення для забезпечення оптимізованої підтримки широкого спектра бібліотек. Розширення Quarkus OpenTelemetry забезпечує:

• Інструментування “з коробки”
• Автоконфігурацію OpenTelemetry SDK, що підтримує майже всі системні властивості, визначені для OpenTelemetry SDK
• Експортер OTLP на основі Vert.x
• Ті самі інструменти можна використовувати з native image застосунками, які не підтримуються агентом OpenTelemetry Java.

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

Початок роботи

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

• Maven (pom.xml)
• Gradle (build.gradle)

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-opentelemetry</artifactId>
</dependency>

implementation("io.quarkus:quarkus-opentelemetry")

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

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

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

Для деталей щодо цих та інших параметрів конфігурації дивіться довідник з конфігурації OpenTelemetry.

Дізнатися більше

• Використання OpenTelemetry, загальний довідник, що охоплює всі параметри конфігурації
• Посібники, специфічні для сигналів:
  • Tracing
  • Metrics
  • Logs