SuperAPI AI 工具集

splunk-spl2-pipeline-kit

数据与分析

查看项目

更新于 10-15 23:46

技能介绍

用途:该技能是 splunk-ingest-processor-setup 与 splunk-edge-processor-setup 共享的 SPL2 编写与校验工具,完全离线运行,用于渲染起步 SPL2、对管道文件做 lint,并报告 profile 兼容性问题,不调用 Splunk API。新版 Cisco Data Fabric 表述下可作为可复用 SPL2 编写路径;原生 Observability Metrics Pipeline Management 仍属单独的 UI 工作流,由 splunk-observability-deep-native-workflows 覆盖。

主要能力:为 Splunk 托管 Ingest Processor 使用 ingestProcessor,为 Edge Processor 使用 edgeProcessor。输出默认目录为 splunk-spl2-pipeline-kit-rendered/,包含 templates/<profile>/.spl2(路由、分支、脱敏、采样、lookup、提取、时间戳、JSON/XML、OCSF、解密、指标、stats、S3 及兼容性起步模板,依支持情况而定)、custom-template-app/default/data/spl2/.spl2(使用 @template 与运行 profile 元数据的自定义模板模块示例)、lint-report.json、lint-report.md 和 coverage-report.json。

使用方式:渲染全部模板并 lint 输出,可运行 bash skills/splunk-spl2-pipeline-kit/scripts/setup.sh --phase all --profile both;对用户提供的管道做 lint 可用 --phase lint --profile ingestProcessor --pipeline-file pipelines/my_pipeline.spl2;离线冒烟测试为 bash skills/splunk-spl2-pipeline-kit/scripts/smoke_offline.sh。修改受支持命令、模板或 lint 规则前应先读 reference.md。

限制与护栏:真实样本、私钥、HEC token、Observability token 及 lookup 内容不得进入对话与渲染文件,只渲染占位符与文件路径交接;SPL 转 SPL2 仅作审查辅助,产品内转换工具才是权威流程。logs_to_metrics 需 import logs_to_metrics from /splunk.ingest.commands 形式且仅限 Ingest Processor;decrypt 仅限 Ingest Processor 且须作为私钥 lookup 交接,不得渲染私钥材料;stats lint 拒绝 avg(),因 Ingest Processor 文档以 sum()/count() 为支持的平均模式,Edge Processor stats 受支持并含当前 EP 版本较新的 state-window 行为;object_to_array() 在 SPL2 发行说明中已弃用,应改用 json_entries();正则建议 PCRE2 风格,优先使用 (?P<fieldName>...) 具名捕获;Edge Processor 专属与 Ingest Processor 专属差异会在 lint 输出中报告。