Logging estructurado y trazabilidad distribuida
Haga observables sus despliegues con logs estructurados, identificadores de correlación y trazabilidad distribuida para depurar fallos entre servicios en su pipeline de CI/CD.
Logging estructurado y trazabilidad distribuida es una lección gratuita de DevOps Bootcamp en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de DevOps Bootcamp, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de DevOps Bootcamp incluye 4 lecciones en total.
Los tres pilares de la observabilidad
La observabilidad se basa en tres pilares: métricas, registros y trazas.
- Las métricas indican que algo va mal
- Los registros indican qué ocurrió
- Las trazas indican dónde ocurrió dentro del flujo de una solicitud
La supervisión de canalizaciones suele comenzar con las métricas; esta lección profundiza en los registros y las trazas.
Por qué usar registros estructurados
Una línea de registro de texto sin formato es difícil de consultar. Un registro estructurado es un registro legible por máquinas, normalmente en formato JSON, con campos identificados.
Las herramientas como Loki, Elasticsearch o Datadog pueden filtrar, agregar y generar alertas a partir de los registros estructurados.
Sin estructura frente a estructurado
Compare una línea sin estructura con una estructurada. La versión estructurada le permite consultar directamente status=500.
// Unstructured
Deploy failed for service api at 12:01
// Structured (JSON)
{"level":"error","event":"deploy_failed","service":"api","status":500}Emitir registros JSON
La mayoría de los lenguajes disponen de un registrador estructurado. La idea clave es registrar un objeto, no una cadena concatenada.
const log = (level, event, fields) =>
console.log(JSON.stringify({ level, event, ...fields }));
log('info', 'deploy_started', { service: 'api', version: '1.4.2' });Identificadores de correlación
Un único despliegue afecta a muchos pasos y servicios. Un identificador de correlación (o identificador de traza) es un valor único asociado a cada línea de registro de una operación lógica.
Buscar por ese ID permite reconstruir toda la historia entre los componentes.
- name: Set correlation id
run: echo "TRACE_ID=$(uuidgen)" >> $GITHUB_ENVNiveles de registro
Utilice niveles de registro coherentes para poder ajustar el nivel de detalle y las alertas:
debug— diagnósticos detalladosinfo— eventos normaleswarn— problemas recuperableserror— fallos que requieren atención
Genere alertas para error, muestree info y mantenga debug desactivado en producción.
¿Qué es el rastreo distribuido?
El rastreo distribuido sigue una solicitud a medida que pasa por varios servicios. Cada paso es un span; los spans se enlazan para formar una traza.
Una traza muestra la cronología y qué span fue lento o produjo un error, algo muy valioso en los despliegues de microservicios.
OpenTelemetry
OpenTelemetry (OTel) es el estándar independiente del proveedor para generar trazas, métricas y registros.
Instrumente su aplicación con el SDK de OTel y exporte los datos a un backend como Jaeger, Tempo o un APM en la nube.
import { trace } from '@opentelemetry/api';
const tracer = trace.getTracer('deploy-service');
const span = tracer.startSpan('deploy');
// ... do work
span.end();Rastrear la propia canalización
Puede rastrear no solo su aplicación, sino también la canalización. Las herramientas emiten un span por trabajo y paso, de modo que puede ver qué etapa de CI/CD es el cuello de botella.
Esto convierte un flujo de trabajo largo en una cascada visual que muestra dónde se emplea el tiempo.
Agregación centralizada
Envíe los registros y las trazas de cada trabajo y servicio a una plataforma central. Los ejecutores de CI son efímeros, por lo que los registros que queden en el ejecutor desaparecen después de la ejecución.
Reenvíelos a un sumidero de registros durante la ejecución para poder realizar análisis posteriores incluso cuando el ejecutor ya no exista.
De la señal a la acción
La observabilidad solo resulta útil si impulsa la acción. Cree paneles que muestren las tasas de error y las trazas lentas, y conecte los patrones críticos con las alertas que ya ha configurado.
El objetivo es pasar de una sola alerta directamente a la traza y a la línea de registro estructurado que la explica.
Comprobación rápida
Compruebe su comprensión de los registros y las trazas.
Resumen
Ha profundizado en la observabilidad mediante registros y trazas.
- Emita registros estructurados (JSON) con niveles coherentes
- Asocie identificadores de correlación para seguir una operación
- Utilice el rastreo distribuido y OpenTelemetry para encontrar spans lentos o fallidos
- Agregue todo de forma centralizada antes de que desaparezcan los ejecutores efímeros
Esto complementa las métricas y las alertas para proporcionar una observabilidad completa de la canalización.
Preguntas frecuentes
¿La lección «Logging estructurado y trazabilidad distribuida» es gratis?
Sí — el texto completo de «Logging estructurado y trazabilidad distribuida» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de DevOps Bootcamp, actualiza a CoddyKit PRO. El curso de DevOps Bootcamp incluye 4 lecciones en total.
¿Qué aprenderé en «Logging estructurado y trazabilidad distribuida»?
Haga observables sus despliegues con logs estructurados, identificadores de correlación y trazabilidad distribuida para depurar fallos entre servicios en su pipeline de CI/CD. Practicas DevOps Bootcamp con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar DevOps Bootcamp?
No se requiere experiencia previa. DevOps Bootcamp en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Logging estructurado y trazabilidad distribuida»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de DevOps Bootcamp?
Sí. Cada lección de DevOps Bootcamp incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Estrategias de monitorización de canalizaciones
- Integración con servicios externos
- Configuración de notificaciones y alertas
- Logging estructurado y trazabilidad distribuida