Inspección y Diagnóstico de Timelines con pinfo.py
Auditoria interna de arquivos de base de dados Plaso, análise de metadados do caso e extração de resumo operacional antes do filtrado.
O Painel de Controle do seu Arquivo Plaso
Sección titulada «El Tablero de Control de tu Archivo Plaso»1. O que é pinfo.py?
Sección titulada «1. ¿Qué es pinfo.py?»pinfo.py (Plaso Info) es una herramienta de diagnóstico y revisión estructural. Su única misión es leer un archivo de base de datos .plaso extraído previamente y mostrar en pantalla de forma resumida los metadatos que contiene.
Este es el primer paso absoluto y obligatorio que todo analista forense debe ejecutar inmediatamente después de haber generado un timeline mediante log2timeline.py. Antes de comenzar a aplicar reglas de filtrado complejas o exports masivos que consumen mucha CPU con psort.py, debes verificar rigurosamente el estado y calidad de la captura de datos realizada.
2. Por que é fundamental utilizá-lo?
Sección titulada «2. ¿Por qué es fundamental utilizarlo?»pinfo.py ahorra decenas de horas de procesamientos fallidos o análisis sobre datos ausentes. Te permite auditar de forma instantánea los siguientes parámetros de salud de la investigación:
- ✔ Errores de Procesamiento: Listar de forma explícita si algún parser ha lanzado fallos catastróficos (por ejemplo, por culpa de archivos corruptos o firmas ilegibles).
- ✔ Resumen de Parsers Activos: Confirmar qué analizadores han tenido éxito a la hora de recopilar datos. Si buscas historial de Chrome, pinfo.py te dirá inmediatamente si el parser ha recopilado algún evento o se ha quedado a cero.
- ✔ Metadatos del Entorno de Destino: Validar la versión del sistema operativo interpretado, la zona horaria inyectada y los rangos temporales generales.
- ✔ Verificación de Instantáneas (VSS): Confirmar exactamente cuántas copias ocultas del volumen se han analizado correctamente.
- ✔ Volumen Total de Eventos: Evaluar la cantidad de eventos que forman la base de datos para estimar los tiempos de respuesta de las futuras consultas.
3. Sintaxe de Funcionamento
Sección titulada «3. Sintaxis de Funcionamiento»Su invocación es muy directa, solo requiere indicar el camino del archivo .plaso que se desea examinar:
pinfo.py <archivo.plaso>Exemplo básico de diagnóstico:
Sección titulada «Ejemplo básico de diagnóstico:»pinfo.py /opt/forensics/cases/case-001/my_timeline.plaso4. Casos de Uso e Seções de Diagnóstico
Sección titulada «4. Casos de Uso y Secciones de Diagnóstico»Casuística A: Visão Geral do Estado do Caso (Resumo por Padrão)
Sección titulada «Casuística A: Visión General del Estado del Caso (Resumen por Defecto)»Sem adicionar nenhum parâmetro adicional, a ferramenta fornece um diagnóstico compacto do processamento realizado:
pinfo.py /opt/forensics/cases/case-001/my_timeline.plasoSaída do Relatório de Exemplo no Console:
Sección titulada «Traza del Reporte de Ejemplo en la Consola:»Plaso Storage File Information================================Storage file: my_timeline.plasoFormat version: ...Serialization format: ...
Processing information======================Status: completedProcessing time: 01:32:15Source processed: /opt/forensics/cases/case-001/image.E01Command: log2timeline.py -z "Europe/Madrid" ...
Events======Total number of events: 15234890- Comprobación Clave: Verifica que el campo Status reporte completed. Si refleja el estado aborted o failed, la base de datos está truncada y no es válida para la siguiente fase.
- Validación del Total de Eventos: Si la lista muestra 0 eventos, la ingesta se ha realizado de forma incorrecta (por ejemplo, por problemas de permisos sobre la imagen forense o rutas mal referenciadas).
Casuística B: Auditar Errores Forenses Internos (--sections errors)
Sección titulada «Casuística B: Auditar Errores Forenses Internos (--sections errors)»Este é o passo de auditoria de qualidade mais importante do Blue Team. log2timeline.py não para sua execução se se encontra com arquivos de registro corrompidos ou quebrados; simplesmente registra o erro nos metadados do arquivo para sua posterior inspeção:
pinfo.py --sections errors /opt/forensics/cases/case-001/my_timeline.plasoSaída do Relatório de Erros de Exemplo:
Sección titulada «Traza del Informe de Errores de Ejemplo:»Errors======Parser: winevtPath specification: /Windows/System32/winevt/Logs/Security.evtxError: Unable to parse EVTX file.- Interpretación del Fallo: El parser de logs winevt ha fallado en el procesamiento del archivo de logs de Seguridad principal (Security.evtx). El investigador sabe gracias a esto que le faltan los eventos de inicio de sesión. Se deberá intentar extraer el artefacto de la imagen de forma aislada y emplear recuperadores del archivo Security para repararlo.
Casuística C: Detalle de Carga de los Parsers (--sections parsers)
Sección titulada «Casuística C: Detalle de Carga de los Parsers (--sections parsers)»Permite listar quais módulos analisadores encontraram eventos válidos e em qual quantidade relativa:
pinfo.py --sections parsers /opt/forensics/cases/case-001/my_timeline.plasoTrace de Resumo de Eventos de Exemplo:
Sección titulada «Traza de Resumen de Eventos de Ejemplo:»Parsers=======Parser: Total number of events-------------------------------------------------chrome_cache: 15230chrome_history: 5890...fs: 8901234...prefetch: 450windows_registry: 250120winevt: 120450-------------------------------------------------Total: 15234890- Interpretación: Si tu objetivo de investigación se centraba en averiguar la ejecución de archivos, y el parser prefetch muestra 450 entradas, confirmas que dispondrás de evidencias abundantes en el archivo .plaso.
Casuística D: Identificación del Sistema Operativo y Zona Horaria (--sections info,analysis)
Sección titulada «Casuística D: Identificación del Sistema Operativo y Zona Horaria (--sections info,analysis)»Garante que o Plaso identificou corretamente a assinatura do sistema operacional e o fuso horário utilizado na investigação:
pinfo.py --sections "info,analysis" /opt/forensics/cases/case-001/my_timeline.plasoTrace do Resumo de Análise de Exemplo:
Sección titulada «Traza del Resumen de Análisis de Ejemplo:»Analysis Reports================Report: Operating System---------------------------------------Version: Windows 10 Pro
Report: Timezone--------------------------------System Timezone: Europe/Madrid- Interpretación: Si la zona horaria del sistema analizado no se corresponde con la hora detectada por la base de datos, cualquier correlación temporal posterior lanzada en la línea de tiempo será incorrecta.
Casuística E: Resumen de Copias Ocultas Procesadas (--sections stores)
Sección titulada «Casuística E: Resumen de Copias Ocultas Procesadas (--sections stores)»Verifica que la directiva --vss-stores ha completado el análisis de las instantáneas:
pinfo.py --sections stores /opt/forensics/cases/case-001/my_timeline.plasoTrace do Resumo de Instantâneos de Exemplo:
Sección titulada «Traza del Resumen de Instantáneas de Ejemplo:»Storage Files=============Index Path specification----------------------------0 /opt/forensics/cases/case-001/image.E01 (Partition 2)1 VSS Store 1 (Created: 2026-03-10 ...)2 VSS Store 2 (Created: 2026-03-15 ...)- Interpretación: Confirma que Plaso ha procesado con éxito la partición activa principal (índice 0) y dos instantáneas pasadas.
Casuística F: Despejo Completo de Auditoria (Modo Verbose)
Sección titulada «Casuística F: Volcado Completo de Auditoría (Modo Verbose)»A abordagem mais utilizada pelos investigadores. Despeja de uma só vez todas as seções analíticas de metadados estruturados em um arquivo de texto de relatório do caso:
pinfo.py -v /opt/forensics/cases/case-001/my_timeline.plaso > /opt/forensics/cases/case-001/analysis_report.txt5. Resumo do Fluxo Metodológico Forense
Sección titulada «5. Resumen del Flujo Metodológico Forense»- Fase de Criação: Executa log2timeline.py
para construir a base de dados my_timeline.plaso(tarefa de longa duração). - Fase de Diagnóstico Imediato: Gera o relatório global verboso:
Ventana de terminal pinfo.py -v /opt/forensics/cases/case-001/my_timeline.plaso > /opt/forensics/cases/case-001/analysis_report.txt - Fase de Auditoria: Abre o arquivo
analysis_report.txte confirma:- ✔ O estado Status
deve ser completed. - ✔ A seção errors
não deve listar perdas de arquivos de registro vitais. - ✔ A zona horária coincide plenamente com a do sistema investigado.
- ✔ O estado Status
- Fase de Processamento: Se a auditoria for satisfatória, prossiga imediatamente para processar os dados com psort.py
. Em caso contrário, se corrigam os parâmetros na ingestão e se repita o passo 1.

