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