Tu clúster de Kubernetes funciona con Istio: cada petición atraviesa un proxy Envoy que conoce su latencia, su código de respuesta y su destino. Sin embargo, durante un incidente el equipo abre Dynatrace y solo ve una parte del camino. La pareja Istio Dynatrace merece algo mejor: esos datos ya existen en el mesh, solo hay que hacerlos llegar.
El mesh suele ser el primer lugar donde se hace visible una degradación: reintentos en cascada, mTLS rechazado, timeout de un sidecar. Sin sus trazas ni sus métricas, el diagnóstico se basa en suposiciones y el MTTR se alarga.
Objetivo de este tutorial: enviar los spans de los proxies Envoy en OTLP a Dynatrace mediante un OpenTelemetry Collector, recopilar las métricas estándar de Istio y comprobarlo todo con DQL. El contenido vale para Dynatrace SaaS y Dynatrace Managed (ingesta OTLP en Managed según tu versión; las consultas DQL suponen Grail, es decir, SaaS).
Istio Dynatrace: qué puede aportar el mesh
| Señal | Origen en Istio | Camino hacia Dynatrace |
|---|---|---|
| Trazas (spans de proxy) | Envoy, mediante un proveedor OpenTelemetry declarado en la configuración del mesh | OTLP hacia el Collector y después hacia la API OTLP de Dynatrace |
| Métricas | Endpoint de Prometheus de los sidecars (istio_requests_total, istio_request_duration_milliseconds…) |
Scraping por el Collector o por el Operator de Dynatrace (anotaciones) |
| Logs de acceso | Logs de acceso de Envoy | Recopilación de logs habitual (OneAgent o Fluent Bit) |
Recordatorio importante: los spans de los proxies no bastan para reconstruir una traza completa. Cada aplicación debe propagar las cabeceras de contexto (traceparent) de la petición entrante a sus llamadas salientes; si no, cada salto se convierte en una traza aislada.
Requisitos previos
- Istio instalado con
istioctl(la APItelemetry.istio.io/v1está disponible en las versiones recientes). - Un OpenTelemetry Collector en el namespace
observability, que exponga OTLP gRPC en el 4317, como en el despliegue del Collector en Kubernetes. - Un token de API de Dynatrace con los scopes
openTelemetryTrace.ingestymetrics.ingest, guardado en un secreto. - Aplicaciones que propaguen el contexto W3C (instrumentación de OpenTelemetry o OneAgent).
Paso 1: declarar el Collector como proveedor de trazas
Añade un proveedor de extensión OpenTelemetry en la configuración del mesh:
cat <<EOF | istioctl install -y -f -
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
meshConfig:
enableTracing: true
extensionProviders:
- name: otel-tracing
opentelemetry:
port: 4317
service: otel-collector.observability.svc.cluster.local
EOF
El nombre otel-tracing es libre; se referenciará en el paso siguiente. El campo service debe coincidir exactamente con el nombre DNS del servicio del Collector.
Paso 2: activar el trazado con la API Telemetry
Un recurso Telemetry en el namespace raíz de Istio activa el proveedor para todo el mesh:
apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
name: mesh-tracing
namespace: istio-system
spec:
tracing:
- providers:
- name: otel-tracing
randomSamplingPercentage: 10
randomSamplingPercentage fija la proporción de peticiones que traza el proxy. Empieza con un valor bajo en producción (1 a 10 %) y ajústalo según el volumen. Si las aplicaciones ya deciden el muestreo, el proxy respeta la decisión que lleva la cabecera entrante. Para un muestreo más fino, deja la decisión en el Collector (consulta el muestreo por cola (tail sampling)).
Paso 3: exportar a Dynatrace desde el Collector
En la configuración del Collector, añade el exportador OTLP HTTP de Dynatrace y un receptor Prometheus que haga scraping de los sidecars:
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
prometheus:
config:
scrape_configs:
- job_name: istio-sidecars
scrape_interval: 30s
metrics_path: /stats/prometheus
kubernetes_sd_configs:
- role: pod
relabel_configs:
- source_labels: [__meta_kubernetes_pod_container_name]
regex: istio-proxy
action: keep
- source_labels: [__address__]
regex: ([^:]+)(?::\d+)?
replacement: $$1:15090
target_label: __address__
processors:
batch: {}
cumulativetodelta: {}
exporters:
otlphttp/dynatrace:
endpoint: https://${env:DT_ENV_ID}.live.dynatrace.com/api/v2/otlp
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
service:
pipelines:
traces:
receivers: [otlp]
processors: [batch]
exporters: [otlphttp/dynatrace]
metrics:
receivers: [prometheus]
processors: [cumulativetodelta, batch]
exporters: [otlphttp/dynatrace]
Líneas críticas: el puerto 15090 expone las estadísticas de Envoy en formato Prometheus; el $$ escapa el $ en la configuración del Collector; cumulativetodelta es necesario porque Dynatrace espera contadores en delta mediante OTLP. En Managed, el endpoint pasa a ser https://<dominio>/e/<env-id>/api/v2/otlp. La cuenta de servicio del Collector debe tener permiso para listar los pods.
Si prefieres que el Operator de Dynatrace haga el scraping, usa mejor las anotaciones metrics.dynatrace.com/* descritas en la recopilación de métricas de Prometheus en Kubernetes. No combines los dos métodos sobre los mismos pods: las métricas se contarían dos veces.
Cómo comprobar que funciona
- Genera tráfico y revisa los logs del Collector:
kubectl -n observability logs deploy/otel-collector | grep -iE "error|refused"no debe devolver nada. - Comprueba que están los spans de proxy:
fetch spans, from: -15m | filter isNotNull(istio.canonical_service) | summarize spans = count(), by: { istio.canonical_service } | sort spans descSi el atributo tiene otro nombre en tu versión, inspecciona un span sin procesar con
fetch spans | limit 5. - Controla las métricas del mesh, desglosadas por servicio y por código de respuesta:
timeseries requêtes = sum(istio_requests_total), by: { destination_service, response_code }, from: -1hLa proporción de series con
5xxrespecto al total da el SLI de tasa de errores por servicio. Adapta la clave de la métrica al nombre observado en el navegador de métricas: según el camino de ingesta, puede añadirse un sufijo.
Buenas prácticas
- Basa tus SLO en las métricas del mesh del lado del servidor (
reporter="destination") para evitar contar dos veces cada petición. - Limita la cardinalidad: descarta las etiquetas inútiles antes de exportar en lugar de almacenar millones de series.
- Mantén una tasa de muestreo conocida y documentada; un cambio sin avisar falsea las comparaciones de una semana a otra.
- Monitoriza el propio Collector: si cae, el mesh se queda mudo.
Preguntas frecuentes
¿No basta con OneAgent sin configurar Istio?
OneAgent instrumenta los procesos de las aplicaciones en los pods y propaga su propio contexto; por tanto, ve las llamadas de servicio a servicio. Los spans y las métricas de Envoy añaden la vista del proxy (reintentos, mTLS, timeouts del sidecar). El nivel de soporte nativo de Envoy depende de la versión: consulta la documentación antes de duplicar señales.
¿Por qué mis trazas se cortan en cada salto?
Casi siempre porque una aplicación no propaga traceparent de la llamada entrante a la saliente. El proxy sí crea sus spans, pero no puede enlazar dos peticiones que la aplicación no ha enlazado.
¿Funcionan estos pasos en modo ambient?
El modo ambient sustituye los sidecars por ztunnel y proxies waypoint; los puertos y los orígenes de métricas son distintos. El principio (proveedor OpenTelemetry, Collector, exportación OTLP) sigue siendo válido, pero adapta el scraping a esa arquitectura.
Conclusión
Un proveedor OpenTelemetry en la configuración del mesh, un recurso Telemetry y un Collector que hace scraping de los sidecars y exporta en OTLP: el mesh de Istio se hace visible en Dynatrace, con SLI basados en cada petición. La próxima cascada de reintentos se leerá en una traza, no en una suposición.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Las opciones y los atributos evolucionan: compruébalos en la documentación de Istio y en la de Dynatrace. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.