Instrumentation Quarkus

Quarkus 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 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
• Exportateur OTLP basé sur Vert.x
• Les mêmes instrumentations peuvent être utilisées avec les images natives Quarkus, qui ne sont pas supportées par l’agent Java OpenTelemetry.

Quarkus peut également être instrumenté avec l’agent Java OpenTelemetry si vous n’exécutez pas une application native.

Démarrage rapide

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

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

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

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

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 :

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.

En savoir plus

• Utilisation d’OpenTelemetry, une référence générale couvrant toutes les options de configuration
• Guides spécifiques aux signaux pour
  • Traces
  • Métriques
  • Logs