CyberKit

Tool catalog

UnifiedLogReader

Parse macOS unified logs

Open source. Platform: macOS & Linux.

What it is

A tool to parse Apple's binary Unified Logging (.tracev3) into readable records.

Why it matters

macOS unified logs hold rich activity but are opaque; this tool makes them analyzable.

In practice

Parsing the logs reveals process launches around the time of a suspected compromise.

Install

Archived and unmaintained. Clone the GitHub repo and pip install -r requirements.txt (the maintainer now recommends mandiant/macos-UnifiedLogs)

Commands

Parse macOS unified logs into readable records (uuidtext, timesync, then tracev3 path, in that order)
python3 UnifiedLogReader.py uuidtext_path timesync_path tracev3_path output_path
Parse unified logs and write the results to a SQLite database instead of the default log-style output
python3 UnifiedLogReader.py -f SQLITE uuidtext_path timesync_path tracev3_path output_path
Parse a .logarchive bundle (e.g. from macOS's log collect or a sysdiagnose) by pointing uuidtext_path/tracev3_path at the .logarchive folder itself and timesync_path at its embedded timesync subfolder
python3 UnifiedLogReader.py logarchive_path logarchive_path/timesync logarchive_path output_path

Similar tools

  • Hayabusa: Sigma-based Windows event log threat hunting
  • Chainsaw: Fast EVTX & MFT hunting with Sigma rules
  • Sysmon: Detailed system-activity logging for detection

Sources