
Un analyseur multiplateforme pour les journaux unifiés d'Apple !
Une bibliothèque Rust simple et performante qui peut aider à analyser les fichiers Unified Log d'Apple.
Les Unified Logs ont été introduits dans macOS 10.12 (Sierra, 2016) dans le cadre du système de journalisation unifié d'Apple à travers macOS, iOS, watchOS et tvOS. Cette bibliothèque peut analyser les fichiers binaires tracev3 et émettre des entrées de journal structurées.
Chaque entrée expose : le message formaté (ainsi que le message brut et les éléments de journal bruts), l'horodatage (Intel et ARM), le type d'événement et de journal, les chemins de processus et de bibliothèque avec leurs UUID, le sous-système, la catégorie, le PID, l'ID de thread, l'EUID, l'ID d'activité (et son parent), l'UUID de démarrage et le fuseau horaire.
Des binaires d'exemple se trouvent dans examples/ :
unifiedlog_iterator - Analyse une logarchive (ou les journaux d'un système macOS en fonctionnement)
dans un fichier JSONL ou CSV, avec prise en charge des signets/reprise. Le fichier de sortie sera
assez volumineux.cargo run --release --manifest-path examples/Cargo.toml -p unifiedlog_iterator -- --mode log-archive --input system_logs.logarchive
Consultez RUNNING.md pour plus d'informations sur l'utilisation, la création d'un logarchive et les avertissements attendus.
Le type central est LogEntry<'a, 'b> — une entrée de journal sans copie qui emprunte directement
aux tampons du fichier analysé. Les messages sont formatés paresseusement à la demande via
.message(), évitant l'allocation sur le tas jusqu'à ce qu'elle soit explicitement nécessaire. Les fichiers de chaînes UUIDText et de cache partagé (DSC) sont lus paresseusement au fur et à mesure que les entrées de journal y font référence,
maintenant la mémoire proportionnelle à ce que les journaux utilisent réellement ; voir cache::StringStorage::preload
pour le mode anticipé. Pour les processus de longue durée, logarchive::VisitOptions::memory_budget
limite les données de chaînes chargées en les récupérant entre les fichiers tracev3 (désactivé par défaut).
Consultez ARCHITECTURE.md pour le pipeline complet.
[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();
Pour les images montées ou les racines non standard, utilisez filesystem::LiveSystemProvider::with_roots
avec 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();
Implémentez traits::FileProvider pour alimenter l'analyseur depuis n'importe où — une image montée, un conteneur de preuves ou simplement la mémoire. filesystem::InMemoryProvider est une implémentation en mémoire prête à l'emploi :
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();
Les données UUIDText/DSC sont demandées paresseusement par UUID au fur et à mesure que les entrées y font référence. Utilisez plutôt logarchive::visit_provider_preloaded pour tout charger à l'avance (débit maximal au prix d'une mémoire maximale).
Pas de recherche de code d'erreur de style printf (%m). La bibliothèque affiche le numéro d'erreur brut, et non la chaîne lisible par l'humain que fournit la commande macOS log.
Les objets de journal personnalisés non pris en charge sont encodés en base64 plutôt que décodés.