Lección 27 de 31 · Proyecto final: el informe del log✦ WebMCP implementado
Fase 1 · Parsear cada línea con funciones
10 min de lectura3 retos
Empieza el proyecto final: un informe de tu web hecho con awk, que resume un día de access.log en una pantalla. Lo construyes en cinco fases, y cada una parte del programa de la anterior. En esta primera fase no cuentas nada todavía: enseñas a tu informe a leer bien una línea, con una función por cada dato.
¿De dónde vienen los nombres?
parsear = inglés to parse, del latín pars (parte)
Analizar un texto separándolo en sus partes y dándole nombre a cada una. Es lo que haces en PHP cuando conviertes una línea de texto en un objeto con propiedades.
informe.awk = informe + la extensión .awk
El nombre que le damos al programa del proyecto. En esta página las cajas lo llaman programa.awk (no se puede cambiar): cuando leas «tu informe», es ese fichero.
user agent = inglés user agent (agente del usuario)
El programa que hace la petición en nombre de la persona: su navegador. En el log es el último texto entre comillas, y en PHP lo lees en $_SERVER["HTTP_USER_AGENT"].
En 4 ideas
1/4
En PHP convertirías cada línea en un objeto LineaLog con sus métodos. En awk no hay objetos: escribes una función por dato (ip(), url(), estado()…) que lee los campos de la línea actual.
Los números de campo ($7, $9) viven en un solo sitio: dentro de esas funciones. El resto del informe pregunta por url() y no sabe en qué columna está. Es el private de tu clase de PHP.
Cada función devuelve el dato ya limpio: metodo() sin la comilla, hora() solo con la hora, url() sin lo que va tras el ?. Es el trim() y el parse_url() que harías en el constructor.
awk no avisa de una línea rota: un campo que falta vale vacío. linea_valida() es el control de la puerta, como validar un formulario antes de usar $_POST.
1 · El plan: qué vas a construir
Llevas siete módulos sacando cosas sueltas del log: las 404, las IP, los bytes. Ahora lo juntas todo en un solo programa. Cuando acabes la fase 5, tu informe imprimirá esto con el access.log del curso:
Es mucho para escribirlo de golpe. Por eso va por fases, como se monta un mueble: primero las patas, luego el tablero. Cada lección parte del programa de la anterior, añade una pieza y al final te lo enseña entero.
Fase
Qué añade
Qué usas de lo que ya sabes
1 · Parsear
Una función por dato y el control de líneas rotas
Campos, substr, split, funciones propias
2 · Filtrar y contar
Quitar bots y ficheros estáticos; el resumen y los estados
Regex, next, arrays, printf
3 · Top y horas
Las páginas y las IP con más visitas; un gráfico de barras
Ordenar arrays, bucles for
4 · Ataques
Escaneos y fuerza bruta; cruce con las IP bloqueadas
-v, varios ficheros, in
5 · Informe final
Títulos, porcentajes, tamaños y cómo usarlo en tu servidor
sprintf, gsub, la terminal
2 · Una función por dato
Hasta ahora escribías $7 para la página y $9 para el estado. En un programa de dos líneas va bien. En uno de doscientas, dentro de un mes no te acordarás de qué era $9. Y si un día nginx añade una columna al log, tendrás que buscar y cambiar cada número.
En PHP lo resolverías con una clase: la línea entra por el constructor y tú preguntas $linea->url(). En awk no hay clases, pero sí funciones. Escribes una por dato, y que cada una sepa en qué campo está lo suyo:
# En PHP: public function ip(): string { return $this->campos[0]; }functionip() {
return$1
}
# En PHP: public function url(): string { return $this->campos[6]; }functionurl() {
return$7
}
# En PHP: public function estado(): int { return (int) $this->campos[8]; }functionestado() {
return$9
}
# En PHP: if ($linea->estado() === 404) { echo $linea->ip(), " ", $linea->url(), PHP_EOL; }estado() == 404 {
printip(), url()
}
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
⏱ Medido en el servidor del curso con access.log multiplicado hasta 1.000.000 líneas: PHP 8.5: 1,63 s · gawk: 620 ms · mawk: 570 ms. awk tarda 2,9 veces menos que PHP.
Mira la última regla: estado() == 404 { print ip(), url() }. Se lee casi como una frase. Los números de campo han desaparecido del programa: solo los conocen las tres funciones de arriba.
¿Por qué? · En PHP no existe
¿Por qué url() no recibe la línea como parámetro?
En PHP una función no ve las variables de fuera: si quieres que trabaje con la línea, se la pasas (url($linea)) o la guardas en $this. Es una pared que te protege.
En awk esa pared no existe. Lo viste en la lección de funciones propias: todo es global salvo los parámetros. Y los campos ($0, $1, $7, NF) son lo más global que hay: son la línea que awk está leyendo ahora mismo. Cualquier función puede mirarlos.
Así que url() no necesita que le pases nada. Piensa en la línea actual como en el plato que hay ahora en la mesa: cualquiera que se siente puede servirse. La contrapartida es que estas funciones solo tienen sentido mientras se lee una línea. En el bloque END ya no hay plato: se usan los contadores que hayas guardado.
3 · Devolver el dato ya limpio
Algunos campos vienen con «cáscara». El método trae una comilla pegada ("GET), la fecha trae un corchete y la hora metida dentro ([19/Nov/2026:10:15:32). Si cada parte del informe tuviera que pelarlos, repetirías el mismo substr diez veces. Se pela una vez, dentro de la función:
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
hora() usa lo que viste en el módulo 06: la hora empieza en el carácter 14 de $4 y ocupa 2. Recuerda que substr de awk cuenta desde 1 y el de PHP desde 0.
metodo() se salta el primer carácter, que es la comilla.
bytes() suma cero. Así devuelve siempre un número: si algún día el servidor escribe un guion en vez del tamaño (Apache lo hace), "-" + 0 vale 0 y tus sumas no se estropean.
La página también tiene cáscara, aunque en el log del curso no se vea. Una visita real suele llegar así: /blog/tutorial-logs?utm_source=boletin. Lo que va tras el ? es la query string, tu $_GET de PHP. Para el informe, esa visita es de /blog/tutorial-logs y punto. Si no lo quitas, la misma página saldrá cien veces con cien colas distintas.
En PHP, preg_replace() te devuelve el texto nuevo y deja el original como estaba. En awk, sub() hace lo contrario: cambia la variable que le das. Si escribieras sub(/\?.*/, "", $7) estarías modificando el campo 7 de la línea.
Y cambiar un campo tiene premio: awk reconstruye $0 entero (lo viste en nr-nf-y-ofs) y los espacios y las comillas de la línea dejan de estar donde estaban. Una función que solo debía mirar la línea la habría roto para todas las que vienen detrás.
Por eso se trabaja sobre una copia. Y esa copia, ruta, va en los paréntesis tras cuatro espacios: es el truco del módulo 06 para tener una variable local. Sin él, ruta sería global y cualquier otra parte del informe que usara ese nombre se la encontraría cambiada.
4 · El navegador: el orden importa
El user agent es el dato más pesado de la línea: tiene espacios, así que con el separador normal queda repartido en un montón de campos. En el módulo 02 lo sacabas ejecutando awk con -F '"'. Aquí no puedes: el resto del informe cuenta con los campos partidos por espacios.
La solución es partir la línea por las comillas solo dentro de una función, con split. El user agent es el sexto trozo:
awkprograma.awk
# En PHP: return explode('"', $texto)[5];functionagente( trozos) {
split($0, trozos, "\"")
return trozos[6]
}
functionnavegador( texto) {
texto = agente()
# En PHP: if (str_contains($texto, "Firefox/")) { return "Firefox"; }if (texto ~ /Firefox\//) {
return"Firefox"
}
if (texto ~ /Chrome\//) {
return"Chrome"
}
if (texto ~ /Safari\//) {
return"Safari"
}
return"otro"
}
NR == 1 || NR == 3 || NR == 4 || NR == 16 {
printnavegador() " <- "agente()
}
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
Fíjate en la tercera línea de la salida, la de Chrome. Su user agent termina en Chrome/130.0.0.0 Safari/537.36: lleva escritas las dos palabras. Chrome se presenta así desde que nació, para que las webs que solo aceptaban Safari le dejaran pasar.
Lo que no reconoce (curl, Googlebot…) se queda en otro. No pasa nada: en la fase 2 esas visitas se apartan por ser de robots.
5 · Líneas rotas: el control de la puerta
Un log de verdad no es tan limpio como el del curso. A tu servidor llegan programas que ni siquiera hablan HTTP y mandan basura. nginx la apunta tal cual, y sale una línea con la petición rota y menos campos de la cuenta. Una línea normal tiene 12 o más (el user agent añade los suyos).
Tu informe necesita un portero que mire cada línea antes de dejarla pasar. Dos comprobaciones bastan: que haya al menos 12 campos y que el estado sean tres cifras.
El log del curso no trae ninguna línea rota, así que para probar al portero hay que fabricarlas. En un bloque BEGIN puedes asignar un texto a $0: awk lo trocea igual que si lo hubiera leído del fichero, y tus funciones no notan la diferencia. Esta caja no lee ningún fichero:
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
Sin fichero de datos: este programa solo tiene BEGIN, así que no lee nada.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
1 es verdadero y 0 es falso: awk no tiene true ni false. Mira la tercera prueba: tiene 13 campos, así que pasaría el primer control. Pero como la petición es un guion en vez de tres palabras, todo se ha corrido dos sitios a la izquierda y en el campo del estado hay un "-". La segunda comprobación la caza.
¿Por qué? · En PHP no existe
¿Por qué hay que validar a mano? En PHP me habría avisado
En PHP, pedir $campos[8] en una línea con 5 trozos lanza un aviso de Undefined array key. Molesta, pero te enteras de que algo va mal.
En awk, un campo que no existe vale texto vacío y nadie dice nada. Viene muy bien para programas de una línea. Para un informe es un peligro: la línea rota se contaría como una visita a la página «» con el estado «», y tus totales estarían mal sin que lo supieras.
awk te da silencio a cambio de comodidad. El precio es que el control lo pones tú. La buena noticia es que se pone una sola vez, arriba del todo, y lo que pasa de ahí ya es de fiar.
6 · Tu informe al acabar la fase 1
Juntas las funciones y debajo pones el programa, que por ahora son tres reglas y un END:
Cuenta la línea como leída.
Si no es válida, la cuenta como rota y pasa a la siguiente con next.
Si ha llegado hasta aquí, imprime sus datos ya limpios. Es una salida de control: sirve para comprobar a ojo que las funciones aciertan, y en la fase 2 la cambiarás por contadores.
awkprograma.awk
# informe.awk · fase 1 (necesita gawk a partir de la fase 2)# ---------- Fase 1: sacar los datos de la linea ----------# En PHP: public function ip(): string { return $this->campos[0]; }functionip() {
return$1
}
functionhora() {
returnsubstr($4, 14, 2)
}
functionmetodo() {
returnsubstr($6, 2)
}
functionurl( ruta) {
ruta = $7sub(/\?.*/, "", ruta)
return ruta
}
functionestado() {
return$9
}
functionbytes() {
return$10 + 0
}
functionagente( trozos) {
split($0, trozos, "\"")
return trozos[6]
}
functionnavegador( texto) {
texto = agente()
if (texto ~ /Firefox\//) {
return"Firefox"
}
if (texto ~ /Chrome\//) {
return"Chrome"
}
if (texto ~ /Safari\//) {
return"Safari"
}
return"otro"
}
functionlinea_valida() {
returnNF >= 12 && estado() ~ /^[0-9][0-9][0-9]$/
}
# ---------- El programa ----------
{
leidas++
}
!linea_valida() {
rotas++
next
}
{
printhora() "h", ip(), metodo(), estado(), bytes(), navegador(), url()
}
END {
printf"Lineas leidas: %d\n", leidas
printf"Lineas rotas: %d\n", rotas
}
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
En el END se usa printf con %d y no print. Tiene truco: como no hay líneas rotas, la variable rotas no se ha tocado nunca y vale vacío. print imprimiría un hueco; %d la convierte en 0, igual que un (int) de PHP.
La pregunta que te vas a hacer
¿Y si el log de mi servidor tiene otro formato?
El formato de este curso es el combined, el que traen nginx y Apache si no tocas nada. Si tu nginx usa un log_format propio (por ejemplo con el tiempo de respuesta al final), los datos estarán en otros campos.
Ahí se nota la ventaja de esta fase: abres informe.awk, cambias el número dentro de estado() o de bytes() y todo lo demás sigue funcionando. Para ver qué formato tienes, busca log_format y access_log en la configuración de tu nginx.
Módulo de logs de nginx: log_format, el formato combined y las variables que puedes añadir (en inglés).
User-Agent en MDN: por qué todos los navegadores dicen ser Mozilla y qué pone cada uno.
Hora de practicar
Retos · 0/3 resueltos
Reto 1 de 3 · ✓ Resuelto
metodo() y hora(), sin cáscara
Tu informe imprime por cada línea la hora, el método, el estado y la página. Pero hora() devuelve el campo entero ([19/Nov/2026:10:15:32) y metodo() trae la comilla ("GET). Arregla las dos funciones para que la primera línea del log salga así: 10h GET 200 /. Al comprobar se añade un BEGIN que fabrica una línea de prueba y las llama; debe imprimir prueba: 07h DELETE. En PHP serían substr($campos[3], 13, 2) y substr($campos[5], 1).
Al pulsar Comprobar, tu programa se ejecuta en tu navegador con el fichero que ves y con otro distinto que no ves: tiene que acertar con los dos.
awkprograma.awk · editable
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
Pista. Las dos se arreglan con substr(texto, desde, cuantos), que en awk cuenta desde 1. En [19/Nov/2026:10:15:32 la hora empieza en el carácter 14. Para saltarte la comilla del método basta con empezar en el 2 y no decir cuántos.
Reto 2 de 3 · ✓ Resuelto
url() sin la cola
Haz que url() devuelva la página sin la query string: de /blog/tutorial-logs?utm_source=boletin&pagina=2 debe quedar /blog/tutorial-logs. Una página sin ? se devuelve tal cual. Condición: el campo $7 de la línea no puede cambiar (la prueba lo imprime después de llamar a tu función). Tu informe imprime el método y la página de cada línea, como GET /. En PHP sería explode("?", $campos[6])[0].
Al pulsar Comprobar, tu programa se ejecuta en tu navegador con el fichero que ves y con otro distinto que no ves: tiene que acertar con los dos.
awkprograma.awk · editable
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
Pista.sub(/\?.*/, "", variable) borra desde el ? hasta el final. Pero sub cambia la variable que le das: copia antes $7 a una variable local (declárala en los paréntesis, tras cuatro espacios) y limpia la copia.
Reto 3 de 3 · ✓ Resuelto
El portero: linea_valida()
linea_valida() deja pasar todo: devuelve siempre 1. Hazla devolver verdadero solo si la línea tiene 12 campos o más y el estado (lo que devuelve estado()) son exactamente tres cifras. Al comprobar se prueban cuatro líneas fabricadas (una buena y tres rotas) y después tu informe cuenta las del log con el formato Leidas: 20, rotas: 0, buenas: 20. En PHP: count($campos) >= 12 && preg_match('/^[0-9]{3}$/', $campos[8]) === 1.
Al pulsar Comprobar, tu programa se ejecuta en tu navegador con el fichero que ves y con otro distinto que no ves: tiene que acertar con los dos.
awkprograma.awk · editable
$ awk -f programa.awk access.log
¿Qué significa esta línea?
awk: el programa que lee el fichero. En tu servidor puede ser gawk (el de este curso) o mawk (el de Debian y Ubuntu).
-f programa.awk: f de file (fichero). El programa no va escrito en la línea, está guardado en el fichero programa.awk: es lo que ves en la pestaña del mismo nombre. Sin -f, el programa se escribe entre comillas simples: awk '{ print $1 }' access.log.
access.log: los datos, el fichero que awk lee línea a línea. Va siempre al final y puede haber varios: los lee uno detrás de otro.
Las variantes (una línea, varios ficheros, tuberías con |) y qué formatos puede leer awk: lección Una línea o un fichero.
Pista. Son dos condiciones unidas con &&. La primera mira NF. La segunda compara estado() con una regex anclada por los dos lados: ^ al principio, tres veces [0-9] y $ al final.
Resumen
Lo que te llevas de esta lección
Una función por dato: ip(), hora(), metodo(), url(), estado(), bytes(), navegador(). Son los métodos de tu clase LineaLog de PHP, sin clase.
Los $número viven solo dentro de esas funciones. Si cambia el formato del log, tocas un sitio. En PHP es tener las propiedades en private.
La función devuelve el dato limpio: sin comilla, sin corchete, sin query string y, si es un número, con + 0. Es el trim() y el (int) del constructor.
sub() cambia la variable que le das (al revés que preg_replace): se limpia una copia local, nunca el campo.
En navegador() el orden de los if importa: Chrome antes que Safari, porque Chrome lleva las dos palabras.
awk no avisa de un campo que falta: linea_valida() (NF >= 12 y estado de tres cifras) es el portero. Se prueba fabricando líneas con $0 = "…" en un BEGIN.
Para recordarlo: «El número de campo, en un solo sitio»
SSaca $7, $9…
LLimpia substr, sub, + 0
DDevuelve return
Si en tu informe ves un $7 fuera de una función, algo sobra. Y para acordarte de qué hace cada función con su dato: lo Saca, lo Limpia y lo Devuelve.