用途:该技能是 Materialize pipelines-as-code 项目的入口,面向仓库贡献者(SRE、Field Engineering、CloudOps、数据库工程师)与阅读此技能的 AI 智能体,用于编写和维护 packages/alloy-pipelines/ 下的 alloy 日志与指标处理流水线。稳定约定存放在仓库 docsite 的 docs/content/reference/internal/pipelines/ 下,本文件只做链接与状态快照。
主要能力:提供流水线模型、严格属性策略、raw: 转义规则与 schema 扩展方式;覆盖日志与指标流水线约定;给出 schema 与代码映射(YAML 输入、校验 schema、Rust AST/渲染/校验/流水线模块、CLI mz-monitoring-build gen-pipelines)。类型化 schema 覆盖 loki.echo、loki.process、loki.relabel、loki.source.journal、loki.source.file、discovery.kubernetes、discovery.relabel 及多种 loki.process stage 与子块。
使用方式:常用命令包括 make pipelines(渲染 YAML 为 .alloy 并逐目标运行 alloy validate)、cargo test -p mzmon-lib、cargo clippy -p mzmon-lib --all-targets、cargo fmt。修改 schemas/alloy/*.yaml 后必须先 cargo build --bin mz-monitoring-build 再手动 gen-pipelines,否则会用到编译期嵌入的旧 schema。
适用场景与限制:适用于 agent.yaml 等已实现流水线的维护与扩展;gateway.yaml 目前仍是占位符,真实 gateway 处理器流水线移植尚未开始。仅记录常用属性,未文档化属性会被严格校验拒绝,需走 raw: 转义或扩展 schema。存在若干需保持的约束(如 AttributeValue 变体顺序、raw: 必须是最后一个 oneOf 分支、schema 文件 $id 与路径及 ID_* 常量一致)以及已知工具问题(yaml-language-server 递归 schema 栈溢出,CLI 校验器为准)。