Apache SkyWalking 8.2.0 版本解读:Browser 监控、MAL 与告警生态的全面进化
Apache SkyWalking 8.2.0 版本解读:Browser 监控、MAL 与告警生态的全面进化
本篇文章基于 Apache SkyWalking 8.2.0 官方变更记录(changes-8.2.0.md),系统梳理该版本在项目工程化、Java Agent、OAP 后端、UI 与文档五个维度带来的能力升级。读者可以据此掌握:8.2.0 引入了哪些新插件与新协议(Browser 监控、Thrift、Quartz、Spring @Scheduled 等)、OAP 侧新增的 Meter Analysis Language(MAL)与复合告警规则如何使用,以及如何配置超级数据集(Super Dataset)等关键特性。
一、版本总览:8.2.0 的定位
8.2.0 是 SkyWalking 在 2020 年发布的一个重要功能版本。从变更记录看,它并非一次小修小补,而是同时覆盖了"可观测性范围扩张"与"基础能力加固"两大主题:
- 可观测性范围扩张:新增 Browser 监控(前端浏览器端到端可观测)、Envoy 链路追踪支持、Meter 分析语言(MAL)、以及 Thrift、Quartz、Spring @Scheduled、ElasticJob、HBase 客户端、Kafka 客户端 2.1+ 等一批全新插件;
- 基础能力加固:Agent 侧引入插件选择器(Plugin Selector)机制、
mount命令动态加载插件、SQL 长度限制防 OOM;OAP 侧引入超级数据集(Super Dataset)概念、按标签查询 Trace、复合告警规则、告警消息推送钉钉/企业微信/Slack 等。
该版本的完整 issue 与 PR 列表见官方 milestone 记录(原文档末尾链接)。
二、工程与项目层面的改进
变更记录首先列出了 4 项工程化改进,它们直接关系到开发者如何构建与测试本项目:
- 支持 Browser 监控:首次为前端(浏览器端)场景提供完整监控能力,包括 Browser 数据接收、存储与 UI 展示,详见下文第四节;
- 为 Service Mesh 可观测性的 ALS 方案新增 e2e 测试:ALS(Access Log Service)是 Service Mesh 场景下基于访问日志的可观测方案,8.2.0 为其补充了端到端测试用例,保障该方案的稳定性;
- 支持在 JDK 11 下编译(含测试):项目构建环境从 JDK 8 扩展到 JDK 11,便于开发者使用更新的 JDK 进行本地编译与测试;
- 支持构建单个模块:此前构建往往需要全量编译,8.2.0 起可针对某个模块单独执行 Maven 构建,显著提升大规模迭代场景下的构建效率。
三、Java Agent:新插件与插件选择器机制
8.2.0 的 Java Agent 部分信息量最大,既有一批新插件,也有若干影响深远的基础机制改进。
3.1 全新插件:覆盖更多中间件与框架
8.2.0 一次性提供了大量新插件,按用途可大致分为几类:
- RPC / 协议类:Thrift 插件、Kafka 客户端 2.1+ 插件、HBase 客户端插件;
- 任务调度类:Quartz 调度器插件、Spring
@Scheduled插件、ElasticJob 2.x 插件、XXL-job 插件; - 数据访问类:MongoDB 4.x 插件(并增强了既有 MongoDB 插件的 witness classes,用于适配新版本类结构变化);
- 响应式 / HTTP 客户端:WebFlux-WebClient 插件;同时 Spring WebFlux 插件被移入可选插件(Optional Plugin)目录,需要显式启用;
- 异常处理类:ignore-exception 插件,允许在 Span 中忽略指定异常,避免误报错误状态。
这些插件在 8.2.0 之后的版本中持续演进,当前仓库中依然可以找到它们的身影,例如 oap-server/server-receiver-plugin/skywalking-browser-receiver-plugin 目录下的 BrowserModuleProvider.java、BrowserServiceModuleConfig.java 等类,即 Browser 监控在后端侧对应的接收器实现。
3.2 插件选择器(Plugin Selector)机制
8.2.0 为 Agent 引入了 插件选择器 机制,这是本次 Agent 侧最值得关注的基础能力之一。它允许用户通过配置决定哪些插件生效、哪些插件被禁用,从而解决"插件与业务类库冲突"或"不需要某些插件"的常见问题。结合 mount 命令(支持运行时加载一组新的插件),Agent 的插件管理从"启动时全量加载"演变为"可按需选择 + 可动态追加"。
3.3 关键配置与稳定性修复
- 新增
PROPERTIES_REPORT_PERIOD_FACTOR配置:用于调整实例属性上报周期,避免实例属性(如操作系统、JVM 参数等)被清空,解决多实例场景下属性丢失的问题; - 限制被追踪 SQL 的大小:避免超大 SQL 文本导致 Agent 或下游 OOM;
- 增强 SQL 插件的参数截断机制:统一并完善 SQL 参数截断逻辑;
- 增强 SpringMVC 插件:在响应式(reactive)API 场景下增强支持,并可将 HTTP Header 收集为 Span Tag;
- 增强 Feign / Dubbo 插件:支持收集调用参数;
- 增强 Kafka 插件:支持
@KafkaPollAndInvoke注解场景;修复 Kafka reporter 阻塞目标服务、Kafka 上报配置不生效、Kafka reporter 与采样插件冲突、Kafka 插件某些场景下 Span Layer 缺失等问题; - 修复类:PrefixMatch 逻辑不一致、Feign LoadBalancer 机制下重复 exit spans、RestTemplate 并发冲突、ActiveMQ 插件 NPE、日志格式化器 NPE、serviceTraffic 更新时间格式错误等;
- 依赖升级:ByteBuddy 升级到 1.10.14,为上述插件增强提供底层字节码操作能力。
此外,8.2.0 还增强了配置初始化核心(插件可以拥有自己的插件配置)、支持将 gRPC 与 Kafka 的 slf4j 日志输出到 Agent 日志文件,并提供 JSON 日志格式输出能力。
四、OAP 后端:MAL、超级数据集与告警生态
OAP 侧是本版本改动最集中的区域,围绕"指标表达能力""存储模型""告警通知"三条主线展开。
4.1 Meter Analysis Language(MAL)
MAL(Meter Analysis Language) 是 8.2.0 的核心新增能力,用于对 Meter 数据(如 Prometheus 拉取的指标)进行声明式分析。在 8.2.0 之前,OAP 对指标的处理主要依赖 OAL(Observability Analysis Language);MAL 的引入使得来自外部监控生态(尤其是 Prometheus 格式)的指标可以直接在 OAP 内被解析、转换并生成标准指标,而无需编写 Java 代码。
与 MAL 配套,8.2.0 还完成了:
- 支持带标签(labeled)的 Meter:Meter receiver 可以接收和处理带标签维度的指标;
- 支持 Prometheus 格式的带标签直方图(labeled histogram);
- Prometheus 分析新增
latest函数; - 支持 Prometheus fetcher 与自监控(self telemetry)的 SSL。
当前仓库中,MAL 的实现沉淀在 oap-server/analyzer/meter-analyzer 模块(含 ANTLR 语法文件与解析执行器),其使用方式可参考 meter-analyzer 的 CLAUDE.md 与 backend-meter.md。
4.2 超级数据集(Super Dataset)与独立副本配置
针对 Trace 与 Log 这类数据量大、写入频繁、但对可用性要求更高的数据,8.2.0 提出了 超级数据集(Super Dataset) 概念:
- 通过
@SuperDataset注解(见 SuperDataset.java)标记 Trace 段、日志等高频数据模型; - 在 ElasticSearch 存储中,超级数据集可配置独立的 副本数(replicas),与普通指标数据隔离,避免副本放大导致存储成本失控。
从当前源码看,这一机制已被完整保留并延续:oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/manual/segment/SegmentRecord.java(Trace 段)、LogRecord.java(日志)、BrowserErrorLogRecord.java(浏览器错误日志)等数据模型均带有超级数据集标记;ElasticSearch 存储侧的配置项包括:
superDatasetDayStep:超级数据集索引的时间分片步长(默认 -1,即跟随全局 dayStep);superDatasetIndexReplicasNumber:超级数据集索引副本数(默认 0);superDatasetIndexShardsFactor:超级数据集索引分片因子(默认 5)。
这些配置项定义于 StorageModuleElasticsearchConfig.java,通过 application.yml 中 storage.elasticsearch 段进行设置。
4.3 OAL 语法增强:IN、!= 与 like 操作符
OAL(Observability Analysis Language)是 SkyWalking 定义流式指标的语言,8.2.0 为其新增三个常用操作符:
IN:判断属性是否属于给定集合;!=:不等于判断(支持布尔、数值、字符串、枚举与 null 值);like:字符串模糊匹配。
这些操作符的语法规则定义于 OALParser.g4(其中可看到 NOT_EQUAL、LIKE、CONTAIN 等规则),它们让 OAL 编写复杂过滤条件时更加灵活。
4.4 告警:复合规则与多渠道推送
8.2.0 将告警能力做了系统性增强:
- 支持复合告警规则(Composite Alarm Rules):可以将多个告警规则的触发状态组合计算,只有当组合表达式成立时才对外告警,减少单指标抖动带来的误报;
- 支持带标签指标参与告警规则设置:告警规则可以基于带标签的指标数据定义;
- 告警消息推送新增钉钉(DingTalk)、企业微信(WeChat)、Slack:在既有 webhook 基础上,8.2.0 让告警能直接投递到国内常用 IM 工具。当前仓库中,这三类渠道的实现分别位于
oap-server/server-alarm-plugin/src/main/java/org/apache/skywalking/oap/server/core/alarm/provider/dingtalk/DingtalkHookCallback.java、.../wechat/WechatHookCallback.java与.../slack/SlackhookCallback.java,它们都继承自HttpAlarmCallback,并配有各自的*Settings配置类; - 修复 Slack 通知设置 NPE。
告警规则的配置示例可参考 dist-material/config-examples/alarm-settings.yml:每个规则包含 expression(如 sum((endpoint_sla / 100) < 75) >= 3)、period(评估周期)、silence-period(静默期)、recovery-observation-period(恢复观察期)、message 与 tags 等字段;hooks 段则用于配置 webhook、wechat 等通知渠道及消息模板。
4.5 查询、追踪与安全能力
- 支持按标签查询 Trace(OAP 与 UI 双侧打通);
- 支持基于入口 Span 或首个 Span 判定 Segment 状态,并支持采样机制中的错误 Segment(保证错误样本不被漏采);
- 优化 Trace 查询性能,优化拓扑查询(无服务端映射时使用客户端组件名);
- 支持 gRPC Server 的 SSL 证书、在 mesh 分析中加入 TLS 参数、为 gRPC server 增加更多配置项;
- 支持 Nacos 认证;
- InfluxDB 存储增加健康检查;
- 指标批量持久化新增
syncBulkActions配置,用于设置批量大小,并修复 metrics batch 持久化大小计算错误; - 修复 Exporter
INCREMENT模式失效、CLR receiver 缺陷、查询过程 end time 错误、sharing server 认证失效等问题; - 组件 ID 扩展:新增 Python 组件 ID,并为 C++ 预留组件 ID 区间。
五、UI:Browser 仪表盘与按标签查询
UI 侧与 OAP 侧的新能力一一对应:
- 新增 Browser 仪表盘(browser dashboard):展示浏览器端性能指标;
- 新增 Browser 日志查询页面:检索浏览器端上报的错误日志;
- 支持按标签查询 Trace:与后端能力打通,运维人员可直接在 UI 上按自定义标签过滤链路;
- 修复 JVM 配置与 CLR 配置:修正了 UI 上 JVM/CLR 监控配置的展示问题。
六、文档补充
8.2.0 同步完善了三处文档:
- 新增
SW_NO_UPSTREAM_REAL_ADDRESS相关文档,说明该环境变量在网关/代理场景下如何影响上游真实地址的解析; - 更新 ALS(Access Log Service)搭建文档;
- 在插件开发指南中新增 Customization Config(自定义配置) 章节,指导插件作者如何在插件中声明与读取自定义配置项——这与 8.2.0 中"配置初始化核心增强、插件可拥有自己的配置"的代码改动相互印证。
七、小结
回顾 8.2.0 的变更清单,可以清晰看到 SkyWalking 当时的演进方向:向前端可观测性延伸(Browser)、向生态指标开放(MAL)、向存储弹性与查询效率优化(Super Dataset、Trace 按标签查询)、向告警闭环完善(复合规则 + 多渠道推送)。这些能力大多在后续版本中被保留、打磨并成为日常运维的标配功能;对于研究 SkyWalking 演进历史的读者,8.2.0 是一个理解"从 APM 走向全面可观测性平台"的关键节点。
注:本文所有源码路径均指向当前仓库,相关实现可能随版本演进有所调整,请以仓库实际内容为准。