National Cyber Warfare Foundation (NCWF)

Digital Forensics: Making Log Analysis Interesting with Zircolite


0 user ratings
2026-05-09 16:41:42
milo
Red Team (CNA)
From automated rule matching and MITRE ATT&CK mapping to timeline reconstruction and HTML reporting, Zircolite makes DFIR more approachable for blue teams.

Welcome back, aspiring investigators!





Windows Event Logs can be painfully boring to look at. They are dense, repetitive, and often feel like endless walls of text. Then we add Sysmon logs, which are definitely cleaner and useful, but they also create even more work during analysis because of the sheer volume of telemetry they produce. The irony is that these logs contain an incredible amount of valuable forensic evidence. Hidden inside them are process launches, authentication attempts, file access, persistence mechanisms, suspicious command lines, and all the tiny breadcrumbs that reveal how a workstation or server was compromised.





The challenge is that, on the defensive side, our tools often do not feel as attractive as the ones red teamers use. Offensive tooling tends to be more exciting. For beginners, log analysis often feels like searching for a needle in a haystack.





That is exactly why today we want to look at a tool that makes this process far more approachable. It’s called Zircolite.





What is Zircolite





Zircolite is a standalone SIGMA-based detection tool designed for EVTX, Auditd, Sysmon for Linux, XML, CSV, JSONL, and NDJSON logs. It acts as a smart detection engine that takes raw log files and runs high-quality Sigma detections against them, transforming boring log data into meaningful security findings. One of the most convenient capabilities is automatic log type detection. Instead of forcing the analyst to always specify flags for each file type, Zircolite can identify formats automatically using magic bytes, content inspection, and regex-based fallback logic. This makes large-scale triage much smoother. It also supports multiple input formats, including archived and compressed files such as ZIP, gzip, bzip2, and even password-protected archives.





You can split fields, decode Base64 blobs, convert hexadecimal data to readable ASCII, and normalize strange log values during the analysis process itself. This can be helpful when hackers hide payloads inside encoded command lines.





The export flexibility is excellent as well. Results can be exported into JSON, CSV, JSONL, Splunk-friendly formats, Elastic, Zinc, Timesketch, and many other layouts using Jinja templates.





zircolite export formats








Setting Up





There are two practical ways to work with Zircolite on Windows. You can either use a compiled binary or run the Python script directly. Both methods are valid.





It is worth noting that compiled binaries are no longer shipped in the latest official releases. The last release that included the executable was 2.40.0, which is still useful. The release assets can still be found in the GitHub releases section.





To compile the latest version, download the release and run these commands on a Windows host with Python 3 installed.





PS > pip install PyInstaller
PS > pip install -r requirements.txt
PS > python3 -m PyInstaller .\Zircolite.spec




compiling zircolite








Analyzing Logs on Windows





Now, let’s begin with a System.evtx analysis to understand what is happening on the host. One thing you might like here is that Zircolite is not limited to single-file analysis. It can process entire directories of logs, which makes it ideal for workstation triage or large IR evidence bundles.





.\zircolite_win_x64_2.40.0.exe -U
.\zircolite_win_x64_2.40.0.exe --evtx .\logs\System.evtx --ruleset .ulesules_windows_generic_pysigma.json




working with a compiled version








The first command updates the rules. Shortly after running the second one, we begin receiving detections. In this example, the tool identifies Hermetic Wiper process patterns. Hermetic Wiper was a destructive malware family used in major attacks against Ukrainian organizations, designed to corrupt systems and make recovery extremely difficult by damaging storage structures and wiping machines.





We also see Pass-the-Hash activity together with CrackMapExec, which strongly suggests the attacker was probing the host using an NTLM hash stolen from a compromised user account.





Another suspicious detection involves Shadow Copy abuse. This is important on domain controllers, where attackers often abuse Volume Shadow Copies to access the ntds.dit database containing password hashes for all domain users.





Log clearing is another red flag. In normal environments, event logs are rarely cleared intentionally.





The workflow with the Python version is almost identical.





PS > pip install -r requirements.txt
PS > python3 .\zircolite.py -U
PS > python3 .\zircolite.py --evtx .\logs\System.evtx --ruleset .ulesules_windows_generic_pysigma.json




working with a python script








Analyzing Logs on Linux





There are many situations where attackers compromise Linux systems, and these systems are often highly desirable targets. Internet-facing Linux servers frequently become low-hanging fruit, especially when they are exposed without endpoint protection or are neglected by administrators. Hackers may obtain valid credentials or exploit public vulnerabilities on unpatched services.





If your systems use auditd or Sysmon for Linux, Zircolite can analyze those logs.





bash$ > python3 zircolite.py --auditd -e /var/log/auditd/auditd.log -r rules/rules_linux.json




working with linux logs








This is valuable for investigating suspicious shell activity, privilege escalation attempts, service tampering, cron persistence, or web shell execution on Linux infrastructure.





Mini-GUI





Zircolite can also generate HTML reports that act like a lightweight visual investigation interface.





Let’s use it against a large stack of Windows Event Logs.





bash$ > python3 zircolite.py --evtx ~/logs/EVTX-ATTACK-SAMPLES --ruleset rules/rules_windows_merged.json --package --package-dir /tmp/output




exporting results in html format








This command generates a ZIP archive inside the chosen temporary output directory. While the analysis runs, the detections are still printed live in the terminal.





viewing the console output results








To access the report, simply unzip the generated archive and open index.html in your browser. You will immediately be greeted with a clean visual representation of alerts, which already feels far more approachable than digging manually through raw XML logs.





viewing the html report results








As you scroll further, the timeline view becomes one of the most useful sections. It lays out detections chronologically.





viewing the timeline of the attacks








Each alert entry can be expanded to inspect the underlying evidence in more detail.





viewing attacks in details








Another standout feature is the MITRE ATT&CK Matrix view, which gives a strategic overview of what happened on the host. You now see how the attack evolved from initial access and execution into persistence, credential access, lateral movement, and beyond.





viewing the mitre attack framework








For incident responders, this makes storytelling and reporting significantly easier.





Summary





Zircolite solves one of the most frustrating problems in DFIR. It shows valuable evidence hidden inside boring, overwhelming logs. For blue teams, DFIR analysts, SOC engineers, and anyone who spends long hours in Windows or Linux logs, Zircolite makes things much more manageable. And perhaps most importantly, it makes defensive work feel just a little more exciting.





If you’re just getting started in forensics, we recommend our Digital Forensics training where Master OTW walks you through the techniques to find evidence of criminal activity on a computer or network. The training will take place May 19-21 at 3 PM UTC and will be available for Subscriber and Subscriber Pro students. Alternatively, you can purchase the training separately for $99.



Source: HackersArise
Source Link: https://hackers-arise.com/digital-forensics-making-log-analysis-interesting-with-zircolite/


Comments
new comment
Nobody has commented yet. Will you be the first?
 
Forum
Red Team (CNA)



Copyright 2012 through 2026 - National Cyber Warfare Foundation - All rights reserved worldwide.