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。对于复杂的分析需求,建议先使用其内置的 stat 和 cat 子命令预览数据分布和原始值,再调整绘图参数。配置文件(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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/plox/raw/index.md(查看排版版本)