macos-UnifiedLogs

Mandiant · also known as unifiedlog_iterator

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

Websitegithub.com
VendorMandiant
LicenceOpen source (Apache-2.0)
CategoryArtefact parsers
FunctionsParsing, Timeline
TargetsmacOS, iOS
Runs onWindows, macOS, Linux
PricingFree
UsersResearch, Open-source DFIR community, Law enforcement
Last activity2026-10-10 · Latest push; latest release v0.7.0 published 2026-09-14 [github.com]
GitHub activitymandiant/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

Sources

  1. macos-UnifiedLogs repository and README (github.com)
  2. sysdiagnose README (use of unifiedlog_iterator) (github.com)
  3. iLEAPP README (bundles the Unified Log parser) (github.com)
  4. GitHub: mandiant/macos-UnifiedLogs releases (github.com)

Reviewed . Spotted an error? See the corrections policy.