Saltar al contenido
Engineer
Menú
Diseño
Español

Engineer / Glosario

Registro de eventos

Registro de lo que ocurre a medida que sucede

Qué es

El registro de eventos, o logging, consiste en que un programa lleve un historial continuo de su propio comportamiento, con una entrada por evento: una solicitud atendida, una contraseña rechazada, un reintento o un cierre inesperado. Cada entrada, llamada línea o registro de log, contiene al menos una marca de tiempo y un mensaje, de modo que después pueda reconstruirse qué sucedió y en qué orden. El proyecto OpenTelemetry define un log como un registro de texto con marca de tiempo, estructurado o no estructurado, con metadatos opcionales; señala que, de todas las señales de telemetría, los logs son los que tienen un mayor legado.

Ese legado tiene un estándar. Syslog, el veterano protocolo para enviar mensajes de eventos a un recolector, se normalizó en marzo de 2009 mediante RFC 5424, que deja obsoleto el anterior RFC 3164. Asigna a cada mensaje una de ocho severidades, desde 0, Emergency, hasta 7, Debug. La mayoría de las bibliotecas de registro usa una escala más corta con la misma idea: debug, info, warning, error. El modelo de datos de logs de OpenTelemetry asigna a cada severidad un número del 1 al 24, en seis bandas de TRACE a FATAL.

Una línea no estructurada es texto libre: una persona la lee fácilmente, pero una máquina solo puede descomponerla con una expresión regular escrita para esa redacción exacta. Una línea estructurada sigue un esquema fijo: todas las entradas tienen los mismos campos con nombre, tipos y significados. OpenTelemetry prefiere los logs estructurados en producción y añade una advertencia fácil de pasar por alto: que una línea codificada como JSON pueda analizarse no la convierte en estructurada; lo que la hace estructurada es un esquema estable. Aunque aquí se muestra en varias líneas, una entrada estructurada ocupa una sola línea en disco:

{
    "time": "2026-09-14T03:12:07.412Z",
    "severity": "WARN",
    "service": "checkout",
    "event": "payment.retry",
    "attempt": 3,
    "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}

Las métricas y las trazas son las señales que suelen recopilarse junto a los logs. Las métricas son números muestreados a lo largo del tiempo, baratos de conservar y útiles para indicar con qué frecuencia ocurre algo. Las trazas siguen una solicitud por todos los servicios que atraviesa. Un log conserva el detalle de eventos individuales: por eso se consulta después de una alerta para averiguar la causa. OpenTelemetry vincula los logs con las trazas adjuntando los identificadores de la traza y del tramo activos a cada registro.

Por qué importa

En la mayoría de los sistemas, el log es el único relato del pasado que queda. Una métrica puede indicar que los errores aumentaron a las 03:12; el log indica qué solicitud fue, de qué servicio, con qué valor y qué hizo el programa después. Si algo falla por la noche y se ha recuperado por la mañana, el log es el testigo que permanece.

Ese relato tiene un precio que se paga de tres maneras. Cada línea consume disco, operaciones de entrada y salida y tiempo de procesador; cuesta más si se envía a un almacén central, donde un servicio alojado suele cobrar por el volumen recibido. Cada línea también contiene datos conservados sobre alguien: el registro de acceso de un servidor web guarda las direcciones y los navegadores de quienes lo consultaron. Y cada línea necesita protección. La hoja de recomendaciones de registro de OWASP pide que cada evento indique cuándo, dónde, quién y qué, y que los propios logs estén protegidos contra manipulaciones y contra el acceso, la modificación y el borrado no autorizados, porque pueden contener información personal y otros datos sensibles.

A escala organizativa, la publicación especial NIST 800-92, Guide to Computer Security Log Management, de Karen Kent y Murugiah Souppaya, publicada en septiembre de 2006, trata la gestión de logs como infraestructura y procesos de toda la empresa, en lugar de un ajuste de un programa.

Los logs también funcionan mejor junto a los números. La guía de instrumentación de Prometheus propone un contador por cada línea de código que registra eventos, para que, cuando aparezca un mensaje de interés, pueda saberse cuántas veces ha ocurrido y durante cuánto tiempo. También propone comparar los totales de líneas info, warning y error entre versiones.

Cómo se aplica en la práctica

La página de privacidad describe línea por línea el registro de acceso de este sitio. Cada solicitud registra la página y la hora, el estado de la respuesta, la descripción que el navegador da de sí mismo, el nombre del sitio de procedencia y una dirección de red parcialmente ocultada: su último tramo se sustituye por ceros al escribir la línea, antes de que nada llegue al disco. Una línea se conserva unos treinta días. El servidor cierra cada archivo una vez al día, o antes si alcanza unos 10 MB, y elimina el archivo cerrado veintiocho días después; cada noche, una comprobación vuelve a leer todos los archivos y falla si encuentra una línea de más de treinta días. El sistema de conservación falló dos veces, y la página documenta ambos casos. En septiembre de 2026, las direcciones con poco tráfico tardaban tanto en llenar 10 MB que sus archivos nunca se habían cerrado y aún contenían todas las líneas desde el inicio del registro; se añadió una tarea diaria para cerrarlos. El 26 de octubre de 2026, siete de las trece direcciones que mantienen un registro seguían escribiendo en archivos que esa tarea había marcado como cerrados; una conservaba un archivo cerrado de cuarenta y siete días. La tarea se retiró y ahora el propio servidor cierra y elimina los archivos.

Una ejecución completa de pruebas de una aplicación macOS registró 610.996 líneas de log del núcleo de la aplicación. Una ráfaga de eventos del log del núcleo de la aplicación se retenía en un flujo principal sin límite y se copiaba a flujos de suscriptores cuyos consumidores no los usaban. El registro del incidente documenta por separado informes de diagnóstico con 111 GB de páginas comprimidas en una máquina de 36 GB y una muestra del consumo de memoria que mostraba un crecimiento de unos 41 MB por segundo durante un bucle de reintentos de conexión. Los búferes limitados, las suscripciones filtradas por tipo de evento y un límite de frecuencia de registro abordaron esa ruta de eventos. La comparación documentada de ejecuciones completas de pruebas redujo las líneas del log del núcleo de la aplicación a 1.411. No es una prueba comparativa de producción ni una cifra de memoria medida después de la corrección. El límite descarta información de forma deliberada: pueden descartarse eventos de diagnóstico repetitivos y actualizarse el estado afectado, en lugar de retener eventos sin límite. Otros tiempos de espera durante el cierre necesitaron su propia corrección.

En un servidor de producción, una intervención para reforzar la seguridad de trece unidades systemd encontró una directiva mal escrita en tres plantillas de unidad desde que existían esos roles. Ante una clave que no reconoce, el gestor de servicios registra el hecho y arranca la unidad de todos modos; la única huella del error era una advertencia en un log, y se descubrió al reescribir las unidades. Ahora todas pasan por el verificador del propio gestor de servicios en cada convergencia de la configuración, de modo que esa misma errata hace fallar la ejecución.

Dónde surgen los problemas

El log crece más deprisa cuando el sistema ya está fallando. Un bucle que registra cada reintento escribe unas pocas líneas un día normal y miles por segundo un mal día, quitando disco, memoria y tiempo de procesador a un sistema sin recursos de sobra. OWASP pide comprobar que el registro no pueda usarse para agotar los recursos del sistema, por ejemplo llenando el disco. Asigne un límite a cada ruta de ejecución frecuente, agrupe los mensajes repetidos en una sola línea con un recuento y mantenga un contador junto al mensaje, para conservar la frecuencia aunque se descarten líneas.

Se escriben secretos y datos personales. Registrar una solicitud completa conserva todo lo que contenga. La lista de OWASP de datos que normalmente deben eliminarse, ocultarse, transformarse mediante una función hash o cifrarse antes de llegar al log incluye identificadores de sesión, tokens de acceso, contraseñas, cadenas de conexión a bases de datos, claves de cifrado y datos de tarjetas de pago. Hágalo al escribir la línea, como hace con las direcciones el registro de acceso anterior: cuando alguien vaya a limpiarla, puede estar ya en una copia de seguridad o en un archivo histórico.

Una entrada externa escribe una línea falsa. Un valor proporcionado por el usuario que contenga un retorno de carro o un salto de línea, escrito sin escapar en un log de texto, puede iniciar una línea nueva indistinguible de una escrita por la aplicación. OWASP lo llama inyección en logs y pide sanear esos caracteres y codificar los datos para el formato de destino. Un registrador estructurado que escribe cada valor como una cadena JSON escapada lo hace por construcción.

Se interpreta un log silencioso como un sistema sano. Un disco lleno, un archivo rotado que el programa nunca volvió a abrir o un recolector caído parecen lo mismo desde fuera: dejan de llegar líneas. OWASP pide un mecanismo para detectar que el registro se ha detenido. Cuente las líneas por minuto de cada origen y emita una alerta si el recuento cae a cero, para que un hueco en el log genere su propia alerta.

Lecturas adicionales

Contacto

¿Aún está definiendo lo que necesita?

Cuéntenos qué está fallando o qué intenta construir. Le diremos qué haría falta, cuánto costaría aproximadamente y si somos las personas adecuadas.

Desde 1.400 DKK por hora, sin IVA; y un precio por hora menor en una contratación más larga.

welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca