Aller au contenu principal

Spring

Les applications Spring Boot exportent OpenTelemetry en OTLP vers le gateway avuru. Le sensor eBPF cartographie déjà le service ; ceci ajoute des spans riches en cours de processus (routes HTTP, requêtes JDBC, spans métier).

Démarrage rapide​

# Flagship install — the chart is published to GHCR as an OCI artifact,
# eBPF auto-discovers your services. No repo to add.
helm install avuruobs oci://ghcr.io/avuruvision/charts/avuruobs \
  --version <X.Y.Z> -n avuruobs --create-namespace

# Point apps at the gateway (OTLP):
#   http://avuruobs-gateway:4318   (HTTP)
#   http://avuruobs-gateway:4317   (gRPC)

# Open the UI:
kubectl -n avuruobs port-forward svc/avuruobs-ui 8080:80

Ajoutez l'agent Java OpenTelemetry (sans code) et pointez-le vers le gateway :

java -javaagent:opentelemetry-javaagent.jar \
  -Dotel.exporter.otlp.endpoint=http://avuruobs-gateway:4318 \
  -Dotel.service.name=checkout \
  -jar checkout.jar

Signaux collectés​

SignalStatusNotes
Traces✅ SupportedHTTP, JDBC, spans personnalisés
Métriques✅ SupportedJVM + métriques serveur HTTP
Logs⚠️ PartialVia l'appender de logs OTLP
Profilage❌ NoUtilisez plutôt le profileur eBPF

Configuration​

⚙️ Générateur de configuration

Le générateur interactif pour le schéma integrations/spring arrive bientôt. En attendant, copiez le YAML de l'exemple ci-dessous et modifiez-le à la main.

otel.exporter.otlp.endpoint=http://avuruobs-gateway:4318
otel.exporter.otlp.protocol=http/protobuf
otel.service.name=checkout
otel.resource.attributes=deployment.environment=prod

Vérification​

# Lancez une requête, puis cherchez le service dans l'UI avuru → Service Map.
curl -s http://localhost:8080/api/checkout >/dev/null

Le service checkout devrait apparaître avec des spans en cours de processus imbriqués sous la trace découverte par eBPF.

Dépannage​

  • Pas de spans ? Vérifiez l'endpoint de l'agent et que le gateway est joignable depuis le pod (:4318).
  • Nom de service unknown_service:java ? Définissez otel.service.name.
  • Logs manquants ? L'appender de logs OTLP est optionnel ; activez-le dans logback.xml.

Références​