Plaso (log2timeline.py) Concepts and Deployment
Introduction to Plaso, design and construction of forensic super timelines from digitized disk images.
The Brain of the 'Super Timeline'
Sección titulada «El Cerebro de la “Súper Línea de Tiempo”»1. What is Plaso (log2timeline.py)?
Sección titulada «1. ¿Qué es Plaso (log2timeline.py)?»Plaso (formerly known as Log2Timeline) is an event extraction engine and a set of tools designed for digital forensic analysis. Its main tool, log2timeline.py, is the industry standard for creating what is known as a “super timeline”.
Its mission is to traverse a data source (such as a disk image, a directory, or specific files), identify dozens of different artifact types (Windows logs, browser history, LNK files, system logs, etc.), and extract all events with timestamps.
The result is not a human-readable text file, but a compressed database file (with the extension .plaso) that acts as a centralized repository of all found events.
2. The Key Concept: The 'Super Timeline'
Sección titulada «2. El Concepto Clave: La “Súper Línea de Tiempo”»A 'super timeline' is a single chronological list of all events that have occurred on a system. Instead of analyzing Chrome history separately, then Windows event logs, and then file system MAC(B) times, Plaso takes everything and puts it into a unified chronological order.
This allows the analyst to see the exact sequence of actions by an intruder or user in a unified timeline:
10:30:01- (File System) The filemalware.exeis created.10:30:05- (Prefetch) Execution ofmalware.exeis recorded.10:30:15- (Windows Registry) A registry key is created for threat persistence.10:30:20- (Chrome History) The user visitshttp://malicious-c2-server.com.
This correlated view is fundamental to understanding the complete timeline of a security incident.
3. Plaso Installation
Sección titulada «3. Instalación de Plaso»Plaso is included by default in most digital forensics distributions (such as SIFT or Tsurugi). For a manual installation in a debugging or analysis environment in your Linux workspace:
# Instalación básica de las herramientas de plasopip install plaso-tools
# O instalación completa con todas las dependencias opcionales integradaspip install plaso-tools[all]4. Basic Usage and Syntax
Sección titulada «4. Uso Básico y Sintaxis»The fundamental syntax of log2timeline.py is:
log2timeline.py [OPCIONES] <archivo_salida.plaso> <fuente_de_datos>[OPCIONES]: Parameters used to refine and optimize data extraction.<archivo_salida.plaso>: The name of the compressed database file you want to generate. It is mandatory to contain the extension.plaso.<fuente_de_datos>: The source of digital evidence. It supports both forensic image files (E01, DD, RAW) and local system directories mounted.
Example processing a mounted working directory:
Sección titulada «Ejemplo procesando un directorio de trabajo montado:»log2timeline.py /opt/forensics/cases/case-001/my_timeline.plaso /mnt/evidence_drive/Example processing a structured disk image (E01):
Sección titulada «Ejemplo procesando una imagen de disco estructurada (E01):»log2timeline.py /opt/forensics/cases/case-001/my_timeline.plaso /opt/forensics/cases/case-001/image.E015. Critical Options and Use Cases
Sección titulada «5. Opciones Críticas y Casos de Uso»A. Selectively Specifying Parsers (--parsers)
Sección titulada «A. Especificar Parsers de Forma Selectiva (--parsers)»By default, Plaso attempts to automatically run all available analyzers against the disk data. This can drastically slow down the operation on large disks. If you are looking for a specific vector, filter during ingestion:
# Listar todos los parsers registrados en el sistemalog2timeline.py --list-parsers
# Caso de uso: Extraer exclusivamente artefactos del Registro de Windows, Prefetch y LNKlog2timeline.py --parsers "windows_registry,prefetch,lnk" /opt/forensics/cases/case-001/my_win_timeline.plaso /opt/forensics/cases/case-001/image.E01
# Caso de uso: Procesar todo excepto el historial del navegador web (reducción de ruido)log2timeline.py --parsers "all,!chrome_history,!firefox_history" /opt/forensics/cases/case-001/my_timeline.plaso /opt/forensics/cases/case-001/image.E01B. Time Zone Synchronization (-z or --zone)
Sección titulada «B. Sincronización de la Zona Horaria (-z o --zone)»File system timestamps are usually stored internally in UTC, but many corporate logs use the local time of the target system. You must instruct Plaso about the original time zone of the computer under analysis:
# Ejemplo de sistema local de Madrid (España)log2timeline.py -z "Europe/Madrid" /opt/forensics/cases/case-001/my_timeline.plaso /opt/forensics/cases/case-001/image.E01- To list all time zones supported by the platform:
log2timeline.py --list-timezones
C. Processing Volume Shadow Copies (--vss-stores)
Sección titulada «C. Procesamiento de Copias Ocultas de Volumen (--vss-stores)»Windows snapshots or Volume Shadow Copies (VSS) are vital for recovering files modified or deleted by the attacker at past dates:
# Caso de uso: Procesar la evidencia principal y TODAS las copias ocultas detectadas en el discolog2timeline.py --vss-stores all /opt/forensics/cases/case-001/my_timeline_with_vss.plaso /opt/forensics/cases/case-001/image.E01
# Caso de uso: Analizar solo instantáneas seleccionadas (VSS 1, 3 y 5)log2timeline.py --vss-stores 1,3,5 /opt/forensics/cases/case-001/my_timeline.plaso /opt/forensics/cases/case-001/image.E01D. Triage Monitoring Mode (--status_view)
Sección titulada «D. Modo de Monitorización de Triage (--status_view)»Extracting large volumes of data can take hours. Change the status display to linear mode if you are collecting logs in an automated environment:
log2timeline.py --status_view linear /opt/forensics/cases/case-001/my_timeline.plaso /opt/forensics/cases/case-001/image.E016. Artifacts and Recoverable Data
Sección titulada «6. Artefactos y Datos Recuperables»Plaso features hundreds of built-in analyzers to collect and structure high-value forensic evidence:
- ✔ File System: MACB timestamps for all physical files, MFT (Master File Table) information, USN Journal, and
$LogFiletransactions of NTFS partitions. - ✔ Windows Registry: Initialization and persistence keys (Run/RunOnce), list of installed programs, USB device connection metadata (
USBSTOR), historical WiFi keys, and RDP connection activity. - ✔ Application Execution Artifacts: Prefetch history, LNK link files, desktop Jumplist access records, and Amcache and Shimcache application compatibility databases.
- ✔ Web Browsing History: Downloads made, visited URL history, active cookies, and form data.
- ✔ System Logs: Windows EVTX event logs, Ubuntu syslog and
auth.logfiles, and macOS ASL logs.
7. Next Steps with the File .plaso
Sección titulada «7. Siguientes Pasos con el Archivo .plaso»Once the execution of log2timeline.py is completed, you will obtain the structured compressed database (for example: my_timeline.plaso). This file is not directly human-readable nor can it be opened in conventional text editors.
This file is an indexed SQLite database specifically designed to be queried, structured, and exported. To make the most of it, we will use:
pinfo.py: To inspect the status of the.plasofile (view executed parsers, total alerts, and confirm errors).psort.py: To filter, sort and export data into readable formats (CSV, JSON) or integrate it into visual platforms like Timesketch.

