AdGuard中文网站 > 最新资讯 > adguard拦截日志为什么为空 adguard日志记录应怎样开启
教程中心分类
adguard拦截日志为什么为空 adguard日志记录应怎样开启
发布时间:2025/12/30 15:34:02

  拦截日志为空这件事,很多时候并不是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日志并导出,同时记下复现时间点并在事后恢复默认日志级别,日志就能真正用于定位问题。

135 2431 0251