Volver a guíasGuía

Usar extensiones del agente Java de OpenTelemetry sin ocultar trazas de incidente

Filtra ruido, normaliza rutas y ajusta sampling en el agente Java sin tocar la aplicación ni romper la investigación de incidentes.

Una guía práctica para probar extensiones del agente Java de OpenTelemetry con guardrails: baseline, extensión mínima, canary, métricas del Collector y pruebas de que los errores siguen visibles.

Creada: 22 de agosto de 2026

Publicada: 22 de agosto de 2026

Tiempo estimado45 min
NivelAvanzado
Antes de empezarUna aplicación Java ya instrumentada con OpenTelemetry Java agent
PlataformasLinux / Docker
WhatsAppXLinkedIn

Linux

Compila una extensión mínima del agente Java, arráncala en un canary y valida volumen, errores, colas y búsqueda de trazas antes de promocionar.

JDK 17+Maven o Gradlecurlpromtool opcionalkubectl si el servicio vive en Kubernetes
Compilar la extensión
mvn -q -DskipTests=false package
Arrancar el canary con la extensión
java -javaagent:/otel/opentelemetry-javaagent.jar -Dotel.javaagent.extensions=/otel/extensions/incident-trace-guardrails.jar -Dotel.service.name=checkout-api -jar app.jar
Comprobar métricas del Collector
curl -s localhost:8888/metrics | egrep "otelcol_receiver_accepted_spans|otelcol_exporter_sent_spans|otelcol_exporter_send_failed|otelcol_exporter_queue"

Contenido bloqueado

Esta guía requiere completar ambos pasos para leer el contenido completo.

  • Dale a “Me gusta” en la guía.
  • Comparte en WhatsApp, X, LinkedIn o copia el enlace.

Cuando se cumplan ambos pasos, el acceso se desbloquea automáticamente.