La tienda no cobra con tarjeta
Un registro, o log, es un archivo donde un programa apunta lo que va haciendo, con la hora. Cuando algo falla, el registro es el primer sitio donde mirar.
Imagina que en una tienda el datáfono deja de cobrar. Preguntar a todo el mundo no ayuda. Un administrador lee el registro y encuentra la línea que explica el fallo.
Al terminar esta lección
Nota
Puedo encontrar un fallo en un registro y comprobar cuál es la causa.
Palabras clave
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| Registro (log) | un archivo donde un programa apunta lo que hace | /var/log/test.log |
| Nivel | la gravedad de una línea del registro | ERROR |
| Síntoma | lo que se ve cuando algo falla | |
| Causa | la razón por la que algo falla | |
| Código de estado | un número con el que un servidor web responde | 404 |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Un fallo se resuelve en tres pasos
Primero mira el síntoma y apunta qué ves exactamente. Después aísla: busca en el registro la línea que lo explica. Por último comprueba: confirma que esa es la causa antes de cambiar nada.
Cambiar cosas sin comprobar es adivinar. Con los tres pasos, cada cambio tiene una razón.
Ejemplo: de un síntoma a una comprobación
| Síntoma | Idea sobre la causa | Cómo se comprueba |
|---|---|---|
| La web no carga | El servicio web está parado | systemctl is-active del servicio |
| Una página da error | El archivo no existe | El código de estado de esa página |
| Fallan los cobros | El servicio de pagos no contesta | Las líneas ERROR del registro |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Antes de empezar
Nota
Pulsa Iniciar el laboratorio y espera a que diga que está en marcha. En esta máquina un programa escribe una línea nueva en el registro cada dos segundos. Por eso tus números y horas no serán los de nadie más.
Mira las últimas cinco líneas del registro
tail -n 5 /var/log/test.logSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Cuenta cuántas líneas tiene
wc -l /var/log/test.logSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
grep encuentra las líneas que importan
Un registro real tiene miles de líneas. grep deja solo las que contienen una palabra, como ERROR. Con -c cuenta las líneas en lugar de escribirlas, y con -v hace lo contrario: deja las que no la contienen.
Una barra vertical, |, pasa la salida de una orden a la siguiente. head -n 3 se queda con las tres primeras.
Enseña los tres primeros errores
grep ERROR /var/log/test.log | head -n 3Se muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Cuenta todas las líneas de error
grep -c ERROR /var/log/test.logSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Enseña las líneas que no son INFO
grep -v INFO /var/log/test.log | head -n 2Se muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Cómo se lee una línea de este registro
| Parte | Ejemplo | Qué dice |
|---|---|---|
| Fecha | 2026-03-02 | El día |
| Hora | 09:15:01 | El segundo exacto |
| Nivel | ERROR | Qué gravedad tiene |
| Mensaje | payment service did not answer | Qué pasó, en palabras |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Un error frecuente
Advertencia
Mucha gente cree que la última línea ERROR es la causa del fallo. A menudo es solo la consecuencia. La causa suele estar antes. Mira qué pasó justo antes del primer error, no del último.
Comprueba la causa antes de cambiar nada
El registro dice que el servicio de pagos no contestó. Es una pista, no una prueba. Un administrador pregunta al sistema: ¿el servicio funciona? ¿la página responde?
Una página responde con un código de estado. 200 quiere decir que todo va bien y 404 que la página no existe.
Pregunta si el registrador funciona
systemctl is-active lab-loggerSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Pide una página que no existe
curl -s -o /dev/null -w "%{http_code}" --noproxy '*' http://127.0.0.1:8000/falta.txtSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.
Pide una página que sí existe
curl -s -o /dev/null -w "%{http_code}" --noproxy '*' http://127.0.0.1:8000/hello.txtSe muestra aquí y no se ejecuta. Crea una cuenta gratuita para pulsar Ejecutar y escribirlo en el terminal de tu propio laboratorio.