
Um parser multiplataforma para Apple UnifiedLogs!
Uma biblioteca Rust simples e de alto desempenho que pode ajudar a analisar os arquivos Unified Log da Apple.
Os Unified Logs foram introduzidos no macOS 10.12 (Sierra, 2016) como parte do sistema de logging unificado da Apple em macOS, iOS, watchOS e tvOS. Esta biblioteca pode analisar os arquivos binários tracev3 e emitir entradas de log estruturadas.
Cada entrada expõe: a mensagem formatada (além da mensagem bruta e dos itens de log brutos), timestamp (Intel e ARM), tipo de evento e de log, caminhos de processo e de biblioteca com seus UUIDs, subsistema, categoria, PID, ID de thread, EUID, ID de atividade (e pai), UUID de boot e fuso horário.
Binários de exemplo ficam em examples/:
unifiedlog_iterator - Analisa um logarchive (ou os logs em um sistema macOS em execução)
em um arquivo JSONL ou CSV, com suporte a bookmark/retomada. O arquivo de saída será
bastante grande.cargo run --release --manifest-path examples/Cargo.toml -p unifiedlog_iterator -- --mode log-archive --input system_logs.logarchive
Consulte RUNNING.md para mais informações de uso, como criar um logarchive e avisos esperados.
O tipo central é LogEntry<'a, 'b> — uma entrada de log de cópia zero que toma emprestado diretamente dos buffers do arquivo analisado. As mensagens são formatadas de forma preguiçosa sob demanda via .message(), evitando alocação no heap até que seja explicitamente necessário. Os arquivos de string UUIDText e de cache compartilhado (DSC) são lidos de forma preguiçosa à medida que as entradas de log fazem referência a eles, mantendo a memória proporcional ao que os logs realmente utilizam; consulte cache::StringStorage::preload para o modo antecipado. Para processos de longa duração, logarchive::VisitOptions::memory_budget limita os dados de string carregados, recuperando-os entre arquivos tracev3 (desativado por padrão). Consulte ARCHITECTURE.md para o pipeline completo.
[dependencies]
macos-unifiedlogs = "0.8"
use macos_unifiedlogs::logarchive::visit_logarchive;
use std::path::Path;
visit_logarchive(Path::new("system_logs.logarchive"), |entry| {
let timestamp = entry.timestamp().to_rfc3339();
let process = entry.process.unwrap_or("");
let message = entry.message();
println!("{timestamp} [{process}] {message}");
}).unwrap();
use macos_unifiedlogs::logarchive::visit_live_system;
visit_live_system(|entry| {
let timestamp = entry.timestamp().to_rfc3339();
let process = entry.process.unwrap_or("");
let message = entry.message();
println!("{timestamp} [{process}] {message}");
}).unwrap();
Para imagens montadas ou raízes não padrão, use filesystem::LiveSystemProvider::with_roots
com logarchive::visit_provider.
use macos_unifiedlogs::logarchive::visit_logarchive_tracev3_file;
use std::path::Path;
visit_logarchive_tracev3_file(
Path::new("system_logs.logarchive"),
"Persist/0000000000000004.tracev3",
|entry| {
let message = entry.message();
println!("{:?} {:?} {message}", entry.event_type, entry.log_type);
},
)
.unwrap();
Implemente traits::FileProvider para alimentar o analisador a partir de qualquer lugar — uma imagem
montada, um contêiner de evidências ou memória simples. filesystem::InMemoryProvider
é uma implementação em memória pronta para uso:
use macos_unifiedlogs::filesystem::InMemoryProvider;
use macos_unifiedlogs::logarchive::visit_provider;
let mut provider = InMemoryProvider::default();
provider.tracev3.push(("mem://persist-1.tracev3".into(), tracev3_bytes));
provider.timesync.push(("mem://boot.timesync".into(), timesync_bytes));
provider.uuidtext.insert(some_uuid, uuidtext_bytes);
provider.dsc.insert(dsc_uuid, dsc_bytes);
visit_provider(&provider, |entry| {
println!("{}", entry.message());
})
.unwrap();
Os dados UUIDText/DSC são solicitados de forma lazy por UUID à medida que as entradas fazem referência a eles. Use
logarchive::visit_provider_preloaded para carregar tudo antecipadamente
(throughput máximo com memória máxima).
Não há consulta de código de erro no estilo printf (%m). A biblioteca exibe o número bruto do erro, não a string legível por humanos que o comando log do macOS fornece.
Objetos de log personalizados não suportados são codificados em base64 em vez de decodificados.