Agent Skills
返回列表
数式日志解析器

数式日志解析器

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的指引,将 @user_e634750a/sectestgravy1223133 安装到当前 AI 助手中。

技能介绍

要解决的问题

应用日志常在行内嵌入按时间汇总的计算结果,例如 queue_depth=132 + 17、gc_ms=240 * 1.25、p99_latency=round(48.7, 1)。这类表达式通常由业务代码动态拼接,可能是错误兜底计算、阈值判断或采集脚本产出。人工核对需要逐行展开算术,既容易遗漏异常,也难以快速判断指标是否符合预期。

技能如何工作

该技能按以下链路处理日志文件:

  • 表达式提取:扫描日志行,识别符合语法特征的算术表达式,支持括号分组与基本运算符。
  • 安全求值:使用受限解析器执行计算,仅允许数字字面量、算术运算和内置函数,不涉及代码执行、变量绑定或属性访问。
  • 聚合统计:对提取结果计算平均值、中位数、p95、p99 等分布指标,帮助定位尾部延迟或堆积异常。
  • 摘要生成:基于聚合结果输出结构化摘要,覆盖关键指标区间与异常值分布,可直接用于报告或告警归档。
  • 自定义公式:支持针对特定日志格式输入自定义公式,适配项目独有的指标计算逻辑。

内置函数包括 abs、min、max、round、sqrt、pow、log、log10、ceil、floor,可覆盖常见指标换算与分位数计算。

适用边界

  • 表达式提取依赖日志格式的一致性,混合语言日志需先按规则过滤。
  • 仅支持基础算术与内置数学函数,不支持条件表达式、循环或字符串运算。
  • 自定义公式必须符合受限语法,否则会被解析器拒绝。
  • 该工具用于验证日志中已有计算结果的正确性,不替代指标采集与上报链路。

使用场景

  • 排查线上性能问题时,从服务日志中提取延迟计算表达式并核对聚合指标是否符合预期。
  • 验证日志中告警阈值计算是否正确,需要批量解析日志行内的算术表达式。
  • 对周期性采集的指标日志生成汇总摘要,快速查看均值与分位数分布。
  • 分析包含自定义公式的日志文件,确认采集脚本的计算结果无误。

适合人员

  • 后端工程师:需要核对日志中内嵌的计算结果,确认监控指标正确性的工程师。
  • SRE 工程师:需要从服务日志中提取并验证延迟表达式,定位性能回归问题的运维人员。
  • 日志平台开发者:需要解析多来源日志中的算术表达式并生成统计摘要的开发人员。
  • 性能测试工程师:需要验证压测日志中采集脚本计算结果是否符合预期的测试人员。