背景：内网穿透为什么特别需要可观测
ZeroNews 内网穿透把企业/个人的内网服务映射到公网，从而赋予内网应用公网访问的能力。
然后作为一个企业级的内网穿透平台，公网访问只是最基础的能力，在后续使用过程中， 真正让人头疼的，往往是外面说访问不了，不知道断在哪一层——是 客户端 离线、隧道没下发、上游进程挂了，还是被访问策略拦了？
因为内网穿透的引入，到时应用的访问链路变长，也给异常问题的处理增加了难度。
ZeroNews 控制台为企业提供一套完善的隧道应用的可观测能力，把连接态、内网应用可用性检测、访问行为、配置变更、异常告警和流量趋势等可视化呈现给用户，检测隧道整条链路的在各个节点，第一时间发现问题并通知给用户， 真正帮助企业解决使用过程中的各种问题。
内网穿透的访问链条
任何一段出问题，外网表现可能都是403、502、504 或超时，但根因完全不同：
- Client 进程停了 → 隧道整体不可用
- Client 在线但本地端口写错 → dial local service failed
- 网关策略拦截 → 401 / 403 / access denied
- 上游 API 本身慢或 OOM → 只有部分路径超时
若缺少统一的可观测入口，团队只能 SSH 上机器查进程、查本地日志、再对照控制台配置逐个排查， 排查难度大，也不利于审计合规。
ZeroNews 提供的可观测性能力图谱
ZeroNews以隧道维度，将隧道的状态、日志、流量和告警等信息都呈现在控制台中，当隧道访问出现异常时，用户可以精确定位故障点，缩短从【用户反馈】到【定位层级】的路径。
隧道的可用性监测——看隧道活没活、内网服务在不在。
客户端状态监测——客户端连没连上、掉了能不能通知你。
日志审计——控制台里谁动了什么，都有记录。
隧道访问日志——每一次公网访问谁、何时、结果怎样。
隧道流量监控——带宽走势、配额用得咋样。
Webhook 告警通知——将异常状态推到你的企微、飞书、钉钉上。
ZeroNews 可观测能力分解
客户端状态监测
ZeroNews的控制台支持多设备的集中管理，可实时看到每台客户端设备的在线 / 离线、版本、IP地址等。同时支持客户端离线通知告警，用户可以开启客户端离线通知告警,当出现客户端异常时，第一时间通知给用户，以便尽快处理问题。
隧道的可用性监测
我们经常遇到的一个现象：客户端是在线的，但是隧道不能访问
这里我们分析这个现象：客户端显示在线，只说明【跟 ZeroNews 云端连上了】，外面的人能不能真正访问你的博客、API、ssh 、 mysql，还得看内网的服务有没有在跑，能不能正常访问。
在ZeroNews 控制台→隧道管理，每条映射都有自己的状态：开没开、绑的是哪台客户端、公网端点是不是已经生效（active），都能实时展示。
外面访问时，客户端在线，但如果内网程序没启动或者端口写错了，出现隧道不能访问，这时日志里会有类似【连本地服务失败】的提示， 但是这个时候我们往往不会先想到是内网服务的异常导致，简单来说：隧道没问题，是内网应用这层不通。
ZeroNews 支持对内网内应的有效性进行周期性的探测，检测内网应用是否正常，能不能提供服务，在隧道下面，可以配置探测的内网URL 路由地址（比如 /health），同时再开启隧道应用异常告警通知， 当内网服务检测到异常时， 就能第一时间通知给用户，及时排查内网应用的问题并修复，恢复隧道访问。
日志审计
ZeroNews 提供完整的审计日志，控制台里的关键操作都会留下记录，方便事后追溯与合规留痕。主要日志行为包含如下：
登录行为 — 谁登录了控制台、从哪个 IP 访问，一目了然
隧道变更 — 新建、修改、删除等映射操作
集成与安全配置 — IP 白名单、Basic 认证等集成功能的变更
客户端生命周期 — 客户端上线、下线及相关操作
域名与证书 — 域名添加/删除、证书申请等
订阅与套餐 — 套餐订阅、集成功能开通/变更
所有记录可按时间与操作类型筛选查询，对账、排障、合规审计都更省心。
隧道访问日志
当我们想知道【谁在什么时候访问了我的隧道，访问了什么接口， 下载了什么文件、返回啥状态码】， 又或者当应用遭受攻击，找排查攻击源时，以前往往得翻 Nginx/Apache 访问日志，或在应用里开 debug——链路长、门槛高， 无疑给查询增加复杂性；
ZeroNews 把隧道访问日志统一收进控制台，查一条记录就能对齐关键信息，还能按 IP、路径做访问分布统计。
每条日志通常包含：
- 时间— 用户请求隧道的时间
- 来源 IP / 地区— 访问者的网络IP地址，定位用户时从哪里访问的
- 访问的路径— 具体路由或 API；某条路径日志暴增，往往是被扫或被攻击的信号
- 状态码— 用户请求时成功还是失败
- 方法— 用户用的是 GET 请求还是 POST 请求
- 哪条映射 / 哪个域名—对应哪条隧道、哪个域名，映射多也不乱
隧道流量监控
ZeroNews 精确统计每条隧道的实时流量使用情况，在控制台中，用户可以查看每条隧道有流量趋势图，根据隧道流量图，可以很轻松判断出：
- 看某条隧道带宽是不是突然飙高
- 对照套餐配额，决定要不要升配增加带宽或关掉不用的映射
- 区分【业务真的忙】和【是不是有人在异常刷接口】
跟访问日志搭配看，看流量哪条隧道在吃带宽，访问访问日志，流量高峰点的用户请求，哪些地方的 IP请求多、那个接口请求多，进而判断是正常业务访问量增加还是地址泄露被攻击扫描。
Webhook 告警通知
在以前，我们多半是等用户反馈或有空才登录控制台看一眼，才知道隧道或应用出了问题——从异常发生到被发现，往往已经滞后几十分钟甚至几小时。客户端在不在线、隧道通不通，很难靠【想起来再刷一眼】来保障。
ZeroNews 支持 Webhook 告警：客户端或隧道异常时，可通过企业微信、飞书、钉钉等渠道第一时间推送，便于快速定位、尽快恢复。
可推送的事件包括：
客户端离线 / 上线— 掉线即时通知，恢复上线也会提醒，运行状态心中有数
内网应用异常— 探测到内网服务不可用立刻告警，核心业务能缩短故障窗口
资源删除— 隧道、域名等关键资源被删，即时触发告警，避免误删后才发现
建议： 关键业务至少配置一种 Webhook 通知渠道，并开启客户端离线与隧道应用异常告警，出问题时能更快知道、更快处理。
小结
借助上述可观测能力，ZeroNews 让隧道业务看得见、查得清、控得住。你可以明确掌握：
- 谁登录了平台、做了什么 — 审计日志留痕
- 客户端是否正常运行 — 在线状态与异常告警
- 隧道访问是否正常、断在哪一层 — 可用性探测与访问日志
- 访问量是否异常、哪些接口在吃流量 — 流量趋势与访问分析，辅助判断是否扩容
- 是否存在攻击、何时发生 — 来源 IP、路径与状态码便于追溯
ZeroNews针对企业与团队对业务安全、稳定与合规的要求，我们持续完善可观测与安全策略，保障业务长期可靠运行。
：轻量化交叉注意力融合色度-强度特征，双路协同增强照亮暗部！)
)
 agent和组件)