
크로스 플랫폼 Apple UnifiedLogs 파서!
Apple의 Unified Log 파일을 파싱하는 데 도움을 줄 수 있는 간단하고 고성능인 Rust 라이브러리입니다.
Unified Logs는 macOS, iOS, watchOS, tvOS 전반에 걸친 Apple의 통합 로깅 시스템의 일부로 macOS 10.12(Sierra, 2016)에서 도입되었습니다. 이 라이브러리는 바이너리 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로 인코딩됩니다.