
Un analizador multiplataforma para Apple UnifiedLogs.
Una biblioteca Rust simple y de alto rendimiento que puede ayudar a analizar los archivos Unified Log de Apple.
Los Unified Logs se introdujeron en macOS 10.12 (Sierra, 2016) como parte del sistema de registro unificado de Apple en macOS, iOS, watchOS y tvOS. Esta biblioteca puede analizar los archivos binarios tracev3 y emitir entradas de registro estructuradas.
Cada entrada expone: el mensaje formateado (además del mensaje sin procesar y los elementos de registro sin procesar), la marca de tiempo (Intel y ARM), el tipo de evento y de registro, las rutas de proceso y de biblioteca con sus UUID, el subsistema, la categoría, el PID, el ID de hilo, el EUID, el ID de actividad (y su padre), el UUID de arranque y la zona horaria.
Los binarios de ejemplo se encuentran en examples/:
unifiedlog_iterator - Analiza un logarchive (o los registros de un sistema macOS en vivo)
en un archivo JSONL o CSV, con soporte de marcador/reanudación. El archivo de salida será
bastante grande.cargo run --release --manifest-path examples/Cargo.toml -p unifiedlog_iterator -- --mode log-archive --input system_logs.logarchive
Consulta RUNNING.md para más información sobre el uso, cómo crear un logarchive y las advertencias esperadas.
El tipo central es LogEntry<'a, 'b> — una entrada de log de copia cero que toma prestado directamente de los búferes del archivo analizado. Los mensajes se formatean de forma perezosa bajo demanda mediante .message(), evitando la asignación en el heap hasta que sea explícitamente necesario. Los archivos de cadenas UUIDText y de caché compartida (DSC) se leen de forma perezosa a medida que las entradas de log hacen referencia a ellos, manteniendo la memoria proporcional a lo que los logs realmente utilizan; consulta cache::StringStorage::preload para el modo anticipado. Para procesos de larga duración, logarchive::VisitOptions::memory_budget limita los datos de cadenas cargados reclamándolos entre archivos tracev3 (desactivado por defecto). Consulta ARCHITECTURE.md para el 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 imágenes montadas o raíces no estándar, use filesystem::LiveSystemProvider::with_roots
con 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 al analizador desde cualquier lugar — una imagen
montada, un contenedor de evidencia o memoria simple. filesystem::InMemoryProvider
es una implementación en memoria ya preparada:
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();
Los datos de UUIDText/DSC se solicitan de forma diferida por UUID a medida que las entradas hacen referencia a ellos. Utilice
logarchive::visit_provider_preloaded para cargar todo de antemano en su lugar
(máximo rendimiento con máximo consumo de memoria).
No hay búsqueda de códigos de error al estilo printf (%m). La biblioteca genera el número de error sin procesar, no la cadena legible por humanos que proporciona el comando log de macOS.
Los objetos de registro personalizados no compatibles se codifican en base64 en lugar de decodificarse.