该技能是 Apache SkyWalking 中新增监控目标/层(Layer)的接线图,帮助判断哪类信号该用哪个扩展点、契约在哪、哪些文档需同步更新。
用途:为移动 OS、网关、数据库、语言运行时等新监控对象在 OAP 中新增 Layer 并接入遥测。默认范围较窄,多数新目标复用现有 trace 分析,常见形态是经 OTLP 扩展 MAL 与 LAL;仅在引入全新语义约定属性(如 gen_ai.、mcp.)时才需新写 SpanListener,除非 OAP 核心协议新增 SpanLayer 枚举值,否则不要改动 CommonAnalysisListener、RPCAnalysisListener、SegmentAnalysisListener。
主要能力:一是注册 Layer,内建层在 Layer.java 加常量(序数 0–49),外置规则用 layerDefinitions:,插件模块实现 LayerExtension 并经 META-INF/services 注册,运维配置写入 layer-extensions.yml;序数存储为 int,各节点须一致,注册在 Core.notifyAfterCompleted() 后封闭。二是按信号选扩展点:原生 segment 用 AnalysisListener 工厂,OTLP/Zipkin 用 SpanListener,OTel 指标用 MAL,日志用 LAL,预计算指标用 meter-analyzer-config,聚合用 OAL。三是 MAL 规则须把路径追加到 application.yml 的 enabledOtelMetricsRules,并同步 test/e2e-v2/cases/storage/expected/config-dump.yml,否则静默不加载。还需注意直方图按桶计数而非累计、le 标签单位换算及命名控制等。
使用方式:本地先跑通编译、checkstyle、license-eye,再用 swctl 手工验证,跑通 e2e 后再提交 CI。
限制:资料仅给出上述范围,具体命令行参数、版本与平台支持等细节暂未提供。