Procesar registros (logs) con PowerShell

Un registro de servidor tiene las respuestas a preguntas importantes: cuántos errores hubo, quién hace más peticiones, a qué hora falló todo. Con PowerShell, una expresión regular convierte cada línea en un objeto, y desde ahí Group-Object y Measure-Object responden en una línea cada una.

Partimos de un registro de accesos de un servidor web, acceso.log, con 400 líneas en el formato habitual de Apache y Nginx:

consolaPS> Get-Content acceso.log -TotalCount 3
192.0.2.10 - - [18/Nov/2026:08:00:00 -0600] "GET /api/productos HTTP/1.1" 200 3543
198.51.100.99 - - [18/Nov/2026:08:01:07 -0600] "GET /tienda/carrito HTTP/1.1" 200 5141
192.0.2.25 - - [18/Nov/2026:08:02:14 -0600] "GET / HTTP/1.1" 200 2233

De texto a objetos con una expresión regular

$patron = '^(?<ip>\S+) \S+ \S+ \[(?<fecha>[^\]]+)\] "(?<metodo>\S+) (?<ruta>\S+) [^"]*" (?<codigo>\d{3}) (?<bytes>\d+)'
$accesos = switch -Regex -File acceso.log {
    $patron {
        [pscustomobject]@{
            IP     = $Matches.ip
            Hora   = [datetime]::ParseExact($Matches.fecha, "dd/MMM/yyyy:HH:mm:ss zzz", [cultureinfo]::InvariantCulture)
            Ruta   = $Matches.ruta
            Codigo = [int]$Matches.codigo
            Bytes  = [int]$Matches.bytes
        }
    }
}
"Líneas leídas: $($accesos.Count)"
$accesos[0] | Format-List IP, Ruta, Codigo, Bytes
salidaLíneas leídas: 400

IP     : 192.0.2.10
Ruta   : /api/productos
Codigo : 200
Bytes  : 3543

Los grupos con nombre, (?<ip>…), dejan cada parte en $Matches.ip, $Matches.ruta… y con eso se arma un objeto por línea. A partir de aquí ya no hay que pensar en texto: todo es filtrar y agrupar objetos. La fecha se lee con la cultura invariable porque el mes viene en inglés (Nov). En los siguientes pasos, $accesos es esta lista de objetos.

Las preguntas de siempre

"== Respuestas por código"
$accesos | Group-Object Codigo | Sort-Object Name | ForEach-Object { "{0}  {1,4}" -f $_.Name, $_.Count }

"== Las 3 IP con más peticiones"
$accesos | Group-Object IP | Sort-Object Count -Descending | Select-Object -First 3 |
    ForEach-Object { "{0,-15} {1,4}" -f $_.Name, $_.Count }

"== Errores 500 por hora"
$accesos | Where-Object Codigo -eq 500 | Group-Object { $_.Hora.Hour } |
    ForEach-Object { "{0:D2}:00  {1}" -f [int]$_.Name, $_.Count }

"== Tráfico total"
"{0:N1} KB" -f (($accesos | Measure-Object Bytes -Sum).Sum / 1KB)
salida== Respuestas por código
200   323
304    40
404    30
500     7
== Las 3 IP con más peticiones
192.0.2.10       116
198.51.100.7     103
192.0.2.25        92
== Errores 500 por hora
08:00  2
09:00  1
12:00  1
13:00  1
14:00  2
== Tráfico total
1,507.2 KB

Group-Object con un bloque ({ $_.Hora.Hour }) agrupa por un valor calculado, aquí la hora. 1KB es un atajo de PowerShell que vale 1024; también existen MB, GB y TB.

Buscar algo sospechoso

$accesos | Where-Object { $_.Ruta -like "*wp-login*" -or $_.Ruta -like "*.env" } |
    Group-Object IP |
    Select-Object @{ Name = "IP"; Expression = { $_.Name } }, Count,
        @{ Name = "Primera"; Expression = { ($_.Group.Hora | Measure-Object -Minimum).Minimum.ToString("HH:mm") } }
salidaIP           Count Primera
--           ----- -------
203.0.113.42    16 08:17

En un sitio que no es WordPress, alguien que pide /wp-login.php está probando suerte con robots. Saber qué IP lo hace y desde cuándo es el primer paso para bloquearla en el firewall o en el servidor web.

Para registros grandes, de cientos de megas, switch -Regex -File es la forma rápida: lee línea a línea sin cargar el archivo entero. Y si quieres vigilar el registro en vivo, Get-Content acceso.log -Tail 0 -Wait | Select-String ' 500 ' escribe cada error 500 en cuanto aparece.

Todos los scripts de esta página se ejecutaron con PowerShell 7.6.10 (LTS) en un contenedor Linux limpio sin acceso a la red, con la configuración regional de México, y pasaron PSScriptAnalyzer 1.25 sin avisos antes de publicarla; las salidas están copiadas de esa ejecución. Por eso las rutas salen como /home/ana/proyecto; en Windows verás algo como C:\Users\ana.