macos-UnifiedLogs
Open sourceActive
macos-UnifiedLogs is a Rust library from Mandiant that parses Apple Unified Log files (tracev3), which exist on macOS, iOS, watchOS and tvOS. Its example binary unifiedlog_iterator converts a logarchive, or the logs of a live system, to JSONL or CSV. The sysdiagnose framework and iLEAPP both use it on non-Apple platforms.
Facts
| Website | github.com |
|---|---|
| Vendor | Mandiant |
| Licence | Open source (Apache-2.0) |
| Category | Artefact parsers |
| Functions | Parsing, Timeline |
| Targets | macOS, iOS |
| Runs on | Windows, macOS, Linux |
| Pricing | Free |
| Users | Research, Open-source DFIR community, Law enforcement |
| Last activity | 2026-10-10 · Latest push; latest release v0.7.0 published 2026-09-14 [github.com] |
| GitHub activity | mandiant/macos-UnifiedLogs · 392 stars · last push 2026-11-08 · latest release v0.7.0 (2026-09-14) · checked 2026-11-10 |
Capabilities
- Parses Unified Log files, extracting fields such as process, thread and activity IDs, message text, timestamp (Intel and ARM supported), subsystem, category, boot UUID and timezone. [github.com]
- The unifiedlog_iterator example binary parses a logarchive into JSONL or CSV and can also read logs from a live system. [github.com]
- Used as the Linux unified-log parser by the sysdiagnose framework. [github.com]
- Packed inside iLEAPP's pre-built executables as unifiedlog_iterator. [github.com]
Limitations
- No printf-style %m error-code lookup: the native macOS log command resolves such codes, whereas this library prints the numeric value. [github.com]
- Unsupported log-message objects are base64 encoded, and the README warns the output file from the example binary will be quite large. [github.com]
Related tools
- Sysdiagnose Analysis Framework · Analysis
- iLEAPP · Artefact parsers
- UFADE · Acquisition
- APOLLO · Artefact parsers
Sources
- macos-UnifiedLogs repository and README (github.com)
- sysdiagnose README (use of unifiedlog_iterator) (github.com)
- iLEAPP README (bundles the Unified Log parser) (github.com)
- GitHub: mandiant/macos-UnifiedLogs releases (github.com)
Reviewed . Spotted an error? See the corrections policy.