
एप्पल यूनिफाइडलॉग्स के लिए एक क्रॉस-प्लेटफ़ॉर्म पार्सर!
एक सरल और उच्च-प्रदर्शन वाली Rust लाइब्रेरी जो Apple की Unified Log फ़ाइलों को पार्स करने में मदद कर सकती है।
Unified Logs को macOS 10.12 (Sierra, 2016) में macOS, iOS, watchOS और tvOS में Apple की एकीकृत लॉगिंग प्रणाली के हिस्से के रूप में पेश किया गया था। यह लाइब्रेरी बाइनरी tracev3 फ़ाइलों को पार्स कर सकती है और संरचित लॉग प्रविष्टियाँ उत्पन्न कर सकती है।
प्रत्येक प्रविष्टि निम्नलिखित को उजागर करती है: स्वरूपित संदेश (साथ ही कच्चा संदेश और कच्चे लॉग आइटम), टाइमस्टैम्प (Intel और ARM), इवेंट और लॉग प्रकार, उनके UUID के साथ प्रक्रिया और लाइब्रेरी पथ, सबसिस्टम, श्रेणी, PID, थ्रेड ID, EUID, गतिविधि ID (और पैरेंट), बूट UUID, और टाइमज़ोन।
उदाहरण बाइनरीज़ examples/ में स्थित हैं:
unifiedlog_iterator - एक logarchive (या लाइव macOS सिस्टम पर लॉग) को JSONL या CSV फ़ाइल में पार्स करता है, बुकमार्क/रिज़्यूम समर्थन के साथ। आउटपुट फ़ाइल काफ़ी बड़ी होगी।cargo run --release --manifest-path examples/Cargo.toml -p unifiedlog_iterator -- --mode log-archive --input system_logs.logarchive
अधिक उपयोग, लॉगआर्काइव बनाने का तरीका और अपेक्षित चेतावनियों के लिए RUNNING.md देखें।
मुख्य प्रकार LogEntry<'a, 'b> है — एक ज़ीरो-कॉपी लॉग एंट्री जो सीधे पार्स किए गए फ़ाइल बफ़र्स से उधार लेती है। संदेशों को मांग पर विलंब से .message() के माध्यम से फ़ॉर्मेट किया जाता है, जिससे स्पष्ट रूप से आवश्यकता होने तक हीप आवंटन से बचा जाता है। UUIDText और साझा-कैश (DSC) स्ट्रिंग फ़ाइलें विलंब से पढ़ी जाती हैं क्योंकि लॉग एंट्रियाँ उन्हें संदर्भित करती हैं, जिससे मेमोरी उसी अनुपात में रहती है जितना लॉग वास्तव में उपयोग करते हैं; उत्सुक मोड के लिए cache::StringStorage::preload देखें। लंबे समय तक चलने वाली प्रक्रियाओं के लिए, logarchive::VisitOptions::memory_budget tracev3 फ़ाइलों के बीच डेटा को पुनः प्राप्त करके लोड किए गए स्ट्रिंग डेटा को सीमित करता है (डिफ़ॉल्ट रूप से बंद)। पूर्ण पाइपलाइन के लिए ARCHITECTURE.md देखें।
[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();
माउंट किए गए इमेज या गैर-मानक रूट्स के लिए, logarchive::visit_provider के साथ
filesystem::LiveSystemProvider::with_roots का उपयोग करें।
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();
पार्सर को कहीं से भी फ़ीड करने के लिए traits::FileProvider लागू करें — एक माउंटेड
इमेज, एक एविडेंस कंटेनर, या सादे मेमोरी से। filesystem::InMemoryProvider
एक तैयार इन-मेमोरी कार्यान्वयन है:
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();
UUIDText/DSC डेटा को UUID द्वारा मांग पर लोड किया जाता है क्योंकि प्रविष्टियाँ इसका संदर्भ देती हैं। इसके बजाय सब कुछ पहले से लोड करने के लिए logarchive::visit_provider_preloaded का उपयोग करें (अधिकतम मेमोरी पर अधिकतम थ्रूपुट)।
printf-शैली की त्रुटि कोड लुकअप (%m) नहीं है। लाइब्रेरी कच्चा त्रुटि संख्या आउटपुट करती है, न कि वह मानव-पठनीय स्ट्रिंग जो macOS log कमांड प्रदान करता है।
असमर्थित कस्टम लॉग ऑब्जेक्ट्स को डिकोड करने के बजाय base64-एन्कोड किया जाता है।