{"canonical_url":"https://engineer.company/es/glossary/logging/","content_markdown":"# Registro de eventos\n\n## Qué es\n\nEl registro de eventos, o logging, consiste en que un programa lleve un\nhistorial continuo de su propio comportamiento, con una entrada por evento: una\nsolicitud atendida, una contraseña rechazada, un reintento o un cierre inesperado. Cada\nentrada, llamada línea o registro de log, contiene al menos una marca de tiempo y un\nmensaje, de modo que después pueda reconstruirse qué sucedió y en qué orden. El\nproyecto OpenTelemetry define un log como un registro de texto con marca de\ntiempo, estructurado o no estructurado, con metadatos opcionales; señala que, de\ntodas las señales de telemetría, los logs son los que tienen un mayor legado.\n\nEse legado tiene un estándar. Syslog, el veterano protocolo para enviar mensajes\nde eventos a un recolector, se normalizó en marzo de 2009 mediante RFC 5424, que\ndeja obsoleto el anterior RFC 3164. Asigna a cada mensaje una de ocho\nseveridades, desde 0, Emergency, hasta 7, Debug. La mayoría de las bibliotecas\nde registro usa una escala más corta con la misma idea: debug, info, warning,\nerror. El modelo de datos de logs de OpenTelemetry asigna a cada severidad un\nnúmero del 1 al 24, en seis bandas de TRACE a FATAL.\n\nUna línea no estructurada es texto libre: una persona la lee fácilmente, pero\nuna máquina solo puede descomponerla con una expresión regular escrita para esa\nredacción exacta. Una línea estructurada sigue un esquema fijo: todas las\nentradas tienen los mismos campos con nombre, tipos y significados.\nOpenTelemetry prefiere los logs estructurados en producción y añade una\nadvertencia fácil de pasar por alto: que una línea codificada como JSON pueda\nanalizarse no la convierte en estructurada; lo que la hace estructurada es un\nesquema estable. Aunque aquí se muestra en varias líneas, una entrada\nestructurada ocupa una sola línea en disco:\n\n```json\n{\n    \"time\": \"2026-09-14T03:12:07.412Z\",\n    \"severity\": \"WARN\",\n    \"service\": \"checkout\",\n    \"event\": \"payment.retry\",\n    \"attempt\": 3,\n    \"trace_id\": \"4bf92f3577b34da6a3ce929d0e0e4736\"\n}\n```\n\nLas métricas y las trazas son las señales que suelen recopilarse junto a los\nlogs. Las métricas son números muestreados a lo largo del tiempo, baratos de\nconservar y útiles para indicar con qué frecuencia ocurre algo. Las trazas\nsiguen una solicitud por todos los servicios que atraviesa. Un log conserva el\ndetalle de eventos individuales: por eso se consulta después de una alerta para\naveriguar la causa. OpenTelemetry vincula los logs con las trazas adjuntando los\nidentificadores de la traza y del tramo activos a cada registro.\n\n## Por qué importa\n\nEn la mayoría de los sistemas, el log es el único relato del pasado que queda.\nUna métrica puede indicar que los errores aumentaron a las 03:12; el log indica\nqué solicitud fue, de qué servicio, con qué valor y qué hizo el programa\ndespués. Si algo falla por la noche y se ha recuperado por la mañana, el log es\nel testigo que permanece.\n\nEse relato tiene un precio que se paga de tres maneras. Cada línea consume\ndisco, operaciones de entrada y salida y tiempo de procesador; cuesta más si se\nenvía a un almacén central, donde un servicio alojado suele cobrar por el\nvolumen recibido. Cada línea también contiene datos conservados sobre alguien:\nel registro de acceso de un servidor web guarda las direcciones y los\nnavegadores de quienes lo consultaron. Y cada línea necesita protección. La hoja\nde recomendaciones de registro de OWASP pide que cada evento indique cuándo,\ndónde, quién y qué, y que los propios logs estén protegidos contra\nmanipulaciones y contra el acceso, la modificación y el borrado no autorizados,\nporque pueden contener información personal y otros datos sensibles.\n\nA escala organizativa, la publicación especial NIST 800-92, Guide to Computer\nSecurity Log Management, de Karen Kent y Murugiah Souppaya, publicada en\nseptiembre de 2006, trata la gestión de logs como infraestructura y procesos de\ntoda la empresa, en lugar de un ajuste de un programa.\n\nLos logs también funcionan mejor junto a los números. La guía de instrumentación\nde Prometheus propone un contador por cada línea de código que registra eventos,\npara que, cuando aparezca un mensaje de interés, pueda saberse cuántas veces ha\nocurrido y durante cuánto tiempo. También propone comparar los totales de líneas\ninfo, warning y error entre versiones.\n\n## Cómo se aplica en la práctica\n\nLa [página de privacidad](/es/privacy/) describe línea por línea el registro de\nacceso de este sitio. Cada solicitud registra la página y la hora, el estado de\nla respuesta, la descripción que el navegador da de sí mismo, el nombre del\nsitio de procedencia y una dirección de red parcialmente ocultada: su último\ntramo se sustituye por ceros al escribir la línea, antes de que nada llegue al\ndisco. Una línea se conserva unos treinta días. El servidor cierra cada archivo\nuna vez al día, o antes si alcanza unos 10 MB, y elimina el archivo cerrado\nveintiocho días después; cada noche, una comprobación vuelve a leer todos los\narchivos y falla si encuentra una línea de más de treinta días. El sistema de conservación falló dos\nveces, y la página documenta ambos casos. En septiembre de 2026, las direcciones con\npoco tráfico tardaban tanto en llenar 10 MB que sus archivos nunca se habían\ncerrado y aún contenían todas las líneas desde el inicio del registro; se añadió\nuna tarea diaria para cerrarlos. El 26 de octubre de 2026, siete de las trece\ndirecciones que mantienen un registro seguían escribiendo en archivos que esa\ntarea había marcado como cerrados; una conservaba un archivo cerrado de cuarenta\ny siete días. La tarea se retiró y ahora el propio servidor cierra y elimina los\narchivos.\n\nUna ejecución completa de pruebas de una aplicación macOS registró 610.996\nlí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\nun flujo principal sin límite y se copiaba a flujos de suscriptores cuyos\nconsumidores no los usaban. El\n[registro del incidente](/es/portfolio/an-app-that-ate-41-mb-a-second-stopped/)\ndocumenta por separado informes de diagnóstico con 111 GB de páginas comprimidas\nen una máquina de 36 GB y una muestra del consumo de memoria que mostraba un crecimiento de unos 41\nMB por segundo durante un bucle de reintentos de conexión. Los búferes\nlimitados, las suscripciones filtradas por tipo de evento y un límite de\nfrecuencia de registro abordaron esa ruta de eventos. La comparación documentada\nde ejecuciones completas de pruebas redujo las líneas del log del núcleo de la aplicación a\n1.411. No es una prueba comparativa de producción ni una cifra de memoria medida\ndespués de la corrección. El límite descarta información de forma deliberada:\npueden descartarse eventos de diagnóstico repetitivos y actualizarse el estado\nafectado, en lugar de retener eventos sin límite. Otros tiempos de espera\ndurante el cierre necesitaron su propia corrección.\n\nEn un servidor de producción, una\n[intervención para reforzar la seguridad de trece unidades systemd](/es/portfolio/cut-systemd-sandbox-exposure-on-every-unit/)\nencontró una directiva mal escrita en tres plantillas de unidad desde que\nexistían esos roles. Ante una clave que no reconoce, el gestor de servicios\nregistra el hecho y arranca la unidad de todos modos; la única huella del error\nera una advertencia en un log, y se descubrió al reescribir las unidades. Ahora\ntodas pasan por el verificador del propio gestor de servicios en cada\nconvergencia de la configuración, de modo que esa misma errata hace fallar la\nejecución.\n\n## Dónde surgen los problemas\n\n**El log crece más deprisa cuando el sistema ya está fallando.** Un bucle que\nregistra cada reintento escribe unas pocas líneas un día normal y miles por\nsegundo un mal día, quitando disco, memoria y tiempo de procesador a un sistema\nsin recursos de sobra. OWASP pide comprobar que el registro no pueda usarse para\nagotar los recursos del sistema, por ejemplo llenando el disco. Asigne un límite\na cada ruta de ejecución frecuente, agrupe los mensajes repetidos en una sola\nlínea con un recuento y mantenga un contador junto al mensaje, para conservar la\nfrecuencia aunque se descarten líneas.\n\n**Se escriben secretos y datos personales.** Registrar una solicitud completa\nconserva todo lo que contenga. La lista de OWASP de datos que normalmente deben\neliminarse, ocultarse, transformarse mediante una función hash o cifrarse antes\nde llegar al log incluye identificadores de sesión, tokens de acceso,\ncontraseñas, cadenas de conexión a bases de datos, claves de cifrado y datos de\ntarjetas de pago. Hágalo al escribir la línea, como hace con las direcciones el\nregistro de acceso anterior: cuando alguien vaya a limpiarla, puede estar ya en\nuna copia de seguridad o en un archivo histórico.\n\n**Una entrada externa escribe una línea falsa.** Un valor proporcionado por el\nusuario que contenga un retorno de carro o un salto de línea, escrito sin\nescapar en un log de texto, puede iniciar una línea nueva indistinguible de una\nescrita por la aplicación. OWASP lo llama inyección en logs y pide sanear esos\ncaracteres y codificar los datos para el formato de destino. Un registrador\nestructurado que escribe cada valor como una cadena JSON escapada lo hace por\nconstrucción.\n\n**Se interpreta un log silencioso como un sistema sano.** Un disco lleno, un\narchivo rotado que el programa nunca volvió a abrir o un recolector caído\nparecen lo mismo desde fuera: dejan de llegar líneas. OWASP pide un mecanismo\npara detectar que el registro se ha detenido. Cuente las líneas por minuto de\ncada origen y emita una alerta si el recuento cae a cero, para que un hueco en\nel log genere su propia alerta.\n\n## Lecturas adicionales\n\n- [Logs](https://opentelemetry.io/docs/concepts/signals/logs/) — OpenTelemetry\n  explica qué es un log, por qué se prefieren los logs estructurados y cómo se\n  vinculan con las trazas.\n- [Modelo de datos de logs](https://opentelemetry.io/docs/specs/otel/logs/data-model/)\n  — los campos de un registro, sus dos marcas de tiempo y la escala de severidad\n  del 1 al 24.\n- [RFC 5424: el protocolo Syslog](https://www.rfc-editor.org/rfc/rfc5424) — el\n  formato de los mensajes syslog y sus ocho severidades.\n- [NIST SP 800-92](https://csrc.nist.gov/pubs/sp/800/92/final) — la guía de\n  gestión de registros de seguridad informática.\n- [Hoja de recomendaciones de registro](https://cheatsheetseries.owasp.org/cheatsheets/Logging_Cheat_Sheet.html)\n  — OWASP sobre qué eventos registrar, qué datos excluir y cómo proteger el\n  resultado.\n- [Instrumentación](https://prometheus.io/docs/practices/instrumentation/) — las\n  prácticas de Prometheus para instrumentar código, incluido el registro de\n  eventos.\n\n\u003chttps://engineer.company/es/glossary/logging/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Los registros conservan qué ocurrió y cuándo. Su estructura, coste, protección y límites determinan si permiten investigar un fallo sin agravar sus efectos.","formats":{"gemtext":"https://engineer.company/es/glossary/logging/index.gmi","gopher":"https://engineer.company/es/glossary/logging/gophermap","html":"https://engineer.company/es/glossary/logging/","json":"https://engineer.company/es/glossary/logging/index.json","markdown":"https://engineer.company/es/glossary/logging/index.md","pdf":"https://engineer.company/es/glossary/logging/index.pdf"},"kind":"page","language":"es","title":"¿Qué es el registro de eventos?","url":"https://engineer.company/es/glossary/logging/","version":1}