拦截日志为空这件事,很多时候并不是AdGuard没有工作,而是你看的不是同一种日志,或者日志筛选条件把记录“筛没了”。把Filtering log与调试日志分开处理,再按平台把入口、筛选与记录级别配置好,日志一般就能正常出现,并且可用于后续定位问题。
一、adguard拦截日志为什么为空
1、看的不是同一种日志入口
AdGuard在不同平台的展示名称不完全一致,Windows与浏览器扩展用的是Filtering log,Android端对应的是Recent activity,如果入口找错了,看到空白很常见。
2、日志筛选条件把记录过滤掉了
Android端的Recent activity支持按状态筛选,包含regular、blocked、modified、allowlisted,也支持按first-party与third-party筛选,如果只勾选了某个状态但当前时间段没有对应记录,列表就会表现为空。
3、保护或过滤模块没有真正参与到流量处理
如果AdGuard没有处理到请求,日志自然不会增长,Windows端Filtering log是从Ad blocking模块进入查看请求记录的入口,先确认自己是在该模块的日志里观察。
4、浏览器扩展日志页偶发空白属于已知问题形态
浏览器扩展的Filtering log曾出现过页面打开后只显示框架、列表不渲染的情况,排查时要把“界面渲染异常”和“确实无请求记录”分开判断,优先升级扩展版本并重启浏览器再验证。
5、误把调试日志当成拦截日志来判断
有些用户开启了调试日志后仍然去看Filtering log,或只看Filtering log不去看调试日志,两个日志用途不同,Filtering log用于看请求被如何处理,调试日志用于看程序内部事件与错误记录。
二、adguard日志记录应怎样开启
1、Windows端先确认Filtering log入口可用
打开AdGuard进入【Settings】,切到Ad blocking模块,点击【Filtering log】查看浏览器与应用发出的请求记录,这里也支持基于请求创建自定义规则。
2、Android端用Statistics里的Recent activity作为拦截日志
打开AdGuard点击底部【Statistics】,在Requests区域进入Recent activity查看最近处理的请求,点击右上角三点菜单后选择Customize,按状态与来源调整筛选条件,避免把记录过滤成空。
3、浏览器扩展从Additional settings打开Filtering log
在AdGuard浏览器扩展的【Settings】页进入【Additional settings】,从这里打开【Filtering log】,同时确认扩展已启用且能正常拦截再观察记录变化。
4、需要更深层排查时开启Windows调试日志
打开AdGuard进入【Settings】→【General Settings】,滑到页面底部把Logging Level切到Debug,复现问题后点击【Export Logs】导出日志包;导出完成后把Logging Level改回Default,因为Debug级别会拖慢应用表现。
5、Android端开启Debug级别并通过Report a bug带出日志
打开AdGuard进入【Settings】→【General】→【Advanced】,把Logging level设为Debug,复现问题后回到【Support】页点击【Report a bug】,勾选Send app logs and system info并发送;如果需要自行导出,也可以在Advanced页面使用导出入口。
三、adguard日志导出与定位应怎样做
1、先记下复现的准确时间点
无论Windows还是Android,官方都建议在复现问题时记录具体发生时间,这样回看调试日志时更容易锁定相关条目。
2、用拦截日志确认请求有没有被处理过
Filtering log与Recent activity的价值在于告诉你请求是blocked、allowed还是modified,把“没有请求进入过滤”与“进入过滤但未命中规则”先区分开,再决定是查网络链路还是查规则本身。
3、导出后及时恢复默认日志级别
调试日志只在排查窗口期开启即可,导出后回到Default能避免长期记录带来的性能影响,也减少日志体积膨胀。
4、如果扩展日志页仍为空优先做版本与重启验证
扩展Filtering log出现空白时,先升级扩展并重启浏览器再测,确认问题是否来自界面渲染而非拦截链路本身,再决定是否提交问题反馈。
总结
拦截日志为空通常是入口与筛选条件导致的“看起来为空”,按平台分别从Windows的【Filtering log】、Android的【Statistics】里Recent activity、扩展的【Additional settings】进入核对最直接;需要深度排查时再开启Debug日志并导出,同时记下复现时间点并在事后恢复默认日志级别,日志就能真正用于定位问题。