plox

从日志文件中提取数值并生成时间序列图的命令行工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:plox。
它的用途是:从日志文件中提取数值并生成时间序列图的命令行工具。
完整的 Skill 内容见:https://321skill.com/skills/plox/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我分析一下今天 Nginx 的 access.log,画出每分钟请求量的变化趋势图。” 它会指导你使用类似 `plox graph --input access.log --plot "count" --time-bucket 1min` 的命令来生成图表。或者,当你想比较两个服务版本的延迟时,可以说:“对比 A 版本和 B 版本日志中的 API 响应时间。” 它会建议使用 `plox graph --input version_a.log,version_b.log --plot duration` 来生成对比图。

介绍

plox 是一个专为开发者设计的命令行工具,它能帮你快速分析日志文件中的时间序列数据。你是否曾面对海量日志,想从中找出性能指标(如响应时间、错误率)的变化趋势,却苦于手动处理?plox 正是为此而生。

你只需通过简单的命令行参数,指定日志文件路径、时间戳格式和需要提取的数值字段(使用正则表达式匹配),它就能自动解析日志,并调用 gnuplot 引擎生成清晰的 PNG 格式时间序列图。你还可以创建多面板布局来对比不同指标,或将多个日志文件的数据绘制在同一张图上进行比较。

它非常适合需要频繁分析系统日志、应用性能监控数据或任何带有时间戳的数值型日志的工程师。无论是排查线上服务的性能瓶颈,还是分析自动化测试的运行结果,plox 都能将枯燥的文本日志转化为直观的图表,大幅提升分析效率。

使用前请确保系统已安装 gnuplot。对于复杂的分析需求,建议先使用其内置的 statcat 子命令预览数据分布和原始值,再调整绘图参数。配置文件(TOML格式)功能可以帮助你复用复杂的图表设置。

核心特点

与通用日志分析工具(如ELK)相比,plox 极度轻量、CLI驱动,无需搭建复杂环境,通过正则表达式即可灵活提取任意格式日志中的数值;与简单的绘图脚本相比,它原生支持多日志文件对比、多面板布局和事件标记统计,更适合工程场景下的快速数据可视化。

注意事项

不适合处理非结构化的纯文本日志或需要复杂聚合、关联分析的场景,其图表渲染依赖外部的 gnuplot。

常见问题

plox 支持哪些时间戳格式?

支持灵活的时间戳格式,可通过 `--timestamp-format` 参数指定,例如常见的 Unix 时间戳、ISO 8601 等格式。

如何从日志中提取像 'duration: 125ms' 这样的带单位的值?

plox 支持单位感知,在正则表达式中匹配数值部分即可,工具会自动识别常见的时间、数据大小等单位并进行归一化处理。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/plox/raw/index.md 读取 plox 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。