
محلل عبر المنصات لسجلات Apple UnifiedLogs!
مكتبة Rust بسيطة وعالية الأداء يمكنها المساعدة في تحليل ملفات Unified Log الخاصة بشركة Apple.
تم تقديم Unified Logs في macOS 10.12 (Sierra، 2016) كجزء من نظام التسجيل الموحد من Apple عبر macOS وiOS وwatchOS وtvOS. يمكن لهذه المكتبة تحليل ملفات tracev3 الثنائية وإخراج إدخالات سجل منظمة.
يعرض كل إدخال: الرسالة المنسقة (بالإضافة إلى الرسالة الخام وعناصر السجل الخام)، والطابع الزمني (Intel وARM)، ونوع الحدث والسجل، ومسارات العمليات والمكتبات مع معرّفات UUID الخاصة بها، والنظام الفرعي، والفئة، ومعرّف العملية PID، ومعرّف الخيط، وEUID، ومعرّف النشاط (والأصل)، ومعرّف 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 لمزيد من الاستخدام، وكيفية إنشاء logarchive، والتحذيرات المتوقعة.
النوع الأساسي هو LogEntry<'a, 'b> — وهو إدخال سجل بدون نسخ (zero-copy) يستعير مباشرةً
من مخازن الملفات المُحلَّلة. تُنسَّق الرسائل بشكل كسول عند الطلب عبر
.message()، مما يتجنب تخصيص الذاكرة في الكومة (heap) حتى الحاجة الصريحة إليها. تُقرأ ملفات 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();
بالنسبة للصور المُثبَّتة أو الجذور غير القياسية، استخدم filesystem::LiveSystemProvider::with_roots
مع 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();
نفّذ 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). تُخرج المكتبة رقم الخطأ الخام، وليس السلسلة القابلة للقراءة البشرية التي يوفرها أمر log في macOS.
تُرمَّز كائنات السجل المخصصة غير المدعومة بترميز base64 بدلًا من فك ترميزها.