系列目录:第一篇:全景图与架构概览 | 第二篇:logd守护进程—启动、初始化与Socket通信 | 第三篇:liblog库—日志写入的完整链路 | 第四篇:日志写入接口—Java层与Native层 | 第五篇:日志读取—logcat源码深度分析 | 第六篇:日志缓冲区管理—容量、裁剪与统计机制 | 第七篇:实战调试与常见问题分析 | 第八篇:定制安卓的日志系统
一、为什么要定制日志系统
前六篇拆解了 Android 日志从写入到裁剪的完整链路,第七篇讲了如何用这些原理排查问题。但还有一类需求是原理篇和调试篇覆盖不到的——当你需要改变系统行为本身。
考虑以下场景:
- “长稳测试跑了一夜,日志全丢了”:默认 256KB 的缓冲区在高频日志场景下几分钟就满了,裁剪机制会把最旧的日志丢弃。你需要的不是更快的
logcat,而是更大的缓冲区。 - “设备在现场出故障,回来查不到日志”:设备没有连接 PC,重启后日志全部丢失。你需要的是实时将日志持久化到文件系统。
- “内核 oops 日志和系统日志对不上时间线”:你需要同时导出内核日志和系统日志,按时间戳对齐排查。
- “user 版本不需要 V/D 日志,但缓冲区被大量调试日志占满”:VERBOSE 和 DEBUG 日志在正式发布版本中没有价值,却消耗了宝贵的缓冲区空间。你需要从源头过滤掉这些低级别日志。
本篇解决这四个问题:扩大缓冲区容量、user 版本不打印 V/D 日志、系统日志实时导出、内核日志实时导出,给出从源码修改到部署验证的完整方案。
二、扩大日志缓冲区:256KB → 512KB
2.1 缓冲区大小的决定链
回顾第六篇,LogBuffer为每个log_id维护独立的容量上限。这个值的决定链在LogBuffer::init()中:
源码路径:system/core/logd/LogBuffer.cpp
// 默认值#defineLOG_BUFFER_SIZE(256*1024)// Tuned with ro.logd.size per-platform#defineLOG_BUFFER_MIN_SIZE(64*1024UL)#defineLOG_BUFFER_MAX_SIZE(256*1024*1024UL)voidLogBuffer::init(){staticconstcharglobal_tuneable[]="persist.logd.size";// Settings Appstaticconstcharglobal_default[]="ro.logd.size";// BoardConfig.mkunsignedlongdefault_size=property_get_size(global_tuneable);if(!default_size){default_size=property_get_size(global_default);if(!default_size){default_size=property_get_bool("ro.config.low_ram",BOOL_DEFAULT_FALSE)?LOG_BUFFER_MIN_SIZE// 64K:LOG_BUFFER_SIZE;// 256K}}log_id_for_each(i){// 每个 log_id 还可以独立覆盖:persist.logd.size.<name>charkey[PROP_NAME_MAX];snprintf(key,sizeof(key),"%s.%s",global_tuneable,android_log_id_to_name(i));unsignedlongproperty_size=property_get_size(key);// ... 回退到 default_size ...}}属性查找链:
persist.logd.size.<name>→ro.logd.size.<name>→persist.logd.size→ro.logd.size→ro.config.low_ram(low_ram 设备 64KB)→LOG_BUFFER_SIZE(256KB)。每个缓冲区可独立配置,未配置的继承全局默认值。
2.2 方案一:运行时属性配置(推荐,无需重新编译)
# 将 main 缓冲区从 256KB 扩大到 512KBadb shell setprop persist.logd.size.main 512K# 同时扩大其他缓冲区(可选)adb shell setprop persist.logd.size.system 512K adb shell setprop persist.logd.size.events 512K adb shell setprop persist.logd.size.radio 512K adb shell setprop persist.logd.size.crash 512K adb shell setprop persist.logd.size.kernel 512K# 发送 SIGHUP 让 logd 重新加载配置adb shellkill-HUP$(pidof logd)关键:
persist.前缀确保配置在重启后仍然生效。ro.前缀(只读属性)只能在编译时通过PRODUCT_PROPERTY_OVERRIDES设置,运行时无法修改。
logd --reinit处理 SIGHUP 信号,重新调用LogBuffer::init()读取所有属性并更新mMaxSize[]。已有的日志条目不会被清空。
2.3 方案二:源码级修改(编译时固化)
如果希望所有设备默认使用 512KB,直接修改宏定义:
源码路径:system/core/logd/LogBuffer.cpp
// 修改前#defineLOG_BUFFER_SIZE(256*1024)// 修改后:扩大一倍#defineLOG_BUFFER_SIZE(512*1024)然后重新编译 logd 模块:
cd<AOSP_ROOT>sourcebuild/envsetup.sh lunch<target>mmm system/core/logd adb root&&adb remount adb push out/target/product/<device>/system/bin/logd /system/bin/ adb shellkill-HUP$(pidof logd)2.4 方案三:logcat -G 命令(临时生效,无需重启 logd)
最直接的方式——通过logcat -G向 logd 发送setLogSize命令,即时生效,无需 SIGHUP:
# 将 main 缓冲区设为 512KBadb logcat-G512K# 查看效果adb logcat-g注意:
logcat -G只修改 logd 内存中的mMaxSize[],不写入任何系统属性。logd 重启或设备重启后恢复为默认值。适合临时调试,不适合长期配置。
源码调用链:
logcat -G 512K │ ├─ logcat.cpp: case 'G' → strtoll("512K") → 512 × 1024 = 524288 │ → android_logger_set_log_size(dev->logger, 524288) │ ├─ liblog/logd_reader.c: logdSetSize() │ → snprintf("setLogSize 0 524288") │ → send_log_msg() → write(/dev/socket/logd, "setLogSize 0 524288") │ └─ logd/CommandListener.cpp: SetBufSizeCmd::runCommand() → mBuf.setSize(LOG_ID_MAIN, 524288) → LogBuffer.cpp: mMaxSize[id] = 524288 ← 只写内存,不写属性源码路径:system/core/logd/LogBuffer.cpp
intLogBuffer::setSize(log_id_t id,unsignedlongsize){if(!valid_size(size))return-1;pthread_mutex_lock(&mLogElementsLock