进程查看器（Process Viewer）

一款面向系统运维人员的工具集，用于扫描、监控和管理系统进程。支持记录观测结果、跟踪告警、运行基准测试及生成报告——全部通过命令行完成，并具备持久化的本地存储能力。

快速开始

bash scripts/script.sh  [args...]

命令列表

核心操作

• scan — 记录一次进程扫描条目（不带参数时：显示最近的扫描记录）
• monitor — 记录一次监控观测（不带参数时：显示最近的观测记录）
• report — 创建一份报告条目（不带参数时：显示最近的报告）
• alert — 记录一条告警或警告（不带参数时：显示最近的告警）
• top — 记录 top 进程快照数据（不带参数时：显示最近的快照）
• usage — 跟踪资源使用情况（不带参数时：显示最近的使用记录）
• check — 执行或记录一次健康检查（不带参数时：显示最近的检查）
• fix — 文档化已应用的修复措施（不带参数时：显示最近的修复）

维护操作

• cleanup — 记录一次清理操作（不带参数时：显示最近的清理）
• backup — 记录一次备份操作（不带参数时：显示最近的备份）
• restore — 记录一次恢复操作（不带参数时：显示最近的恢复）
• log — 添加一条通用日志条目（不带参数时：显示最近的日志）

分析操作

• benchmark — 记录基准测试结果（不带参数时：显示最近的基准测试）
• compare — 记录对比数据（不带参数时：显示最近的对比）

实用工具

• stats — 显示所有类型条目的汇总统计信息
• export — 导出全部数据（支持格式：json、csv、txt）
• search — 在所有日志文件中搜索关键词
• recent — 显示最近 20 条活动日志条目
• status — 显示健康检查状态：版本号、数据目录路径、条目总数、磁盘占用
• help — 显示可用命令列表
• version — 输出当前版本（v2.0.0）

每个命令均接受自由文本输入。若不带任何参数调用，则默认显示该类别下最近的 20 条记录。

数据存储

所有数据均以纯文本日志文件形式保存在以下路径：

~/.local/share/process-viewer/
├── scan.log          # 进程扫描条目
├── monitor.log       # 监控观测记录
├── report.log        # 报告条目
├── alert.log         # 告警与警告记录
├── top.log           # top 进程快照
├── usage.log         # 资源使用记录
├── check.log         # 健康检查记录
├── fix.log           # 已应用的修复措施
├── cleanup.log       # 清理操作记录
├── backup.log        # 备份操作记录
├── restore.log       # 恢复操作记录
├── log.log           # 通用日志条目
├── benchmark.log     # 基准测试结果
├── compare.log       # 对比数据
└── history.log       # 统一的活动历史记录

每条记录格式为 YYYY-MM-DD HH:MM|，每行一条。其中 history.log 按时间顺序记录所有命令执行历史。

依赖要求

• Bash 4.0+，并启用 set -euo pipefail
• 标准 Unix 工具： date、wc、du、tail、grep、sed、cat、basename
• 无外部依赖，无需网络访问
• 需对 ~/.local/share/process-viewer/ 具有写入权限

适用场景

1. 长期跟踪系统进程变化 — 使用 scan 和 monitor 构建进程观测日志，便于后续复盘或趋势分析
2. 事件响应过程文档化 — 使用 alert 记录告警信息，fix 文档化修复步骤，report 编写事件后总结报告
3. 性能基准测试 — 使用 benchmark 和 compare 记录并横向对比不同配置或不同时段下的性能指标
4. 备份与恢复审计 — 使用 backup 和 restore 维护数据保护操作的可追溯审计日志
5. 周期性系统健康审查 — 使用 status 快速检查系统状态，stats 获取全局概览，export json 归档数据供外部分析使用

使用示例

# 扫描并记录一次进程观测
process-viewer scan "nginx worker count: 4, memory 128MB"

# 记录一条监控告警
process-viewer alert "CPU usage exceeded 90% on web-server-03"

# 文档化一项修复操作
process-viewer fix "Restarted memcached after OOM kill"

# 运行基准测试并记录结果
process-viewer benchmark "Disk I/O test: 450MB/s sequential read"

# 查看所有类别的汇总统计信息
process-viewer stats

# 将全部数据导出为 JSON 格式，供外部处理
process-viewer export json

# 在所有日志中搜索特定关键词
process-viewer search "nginx"

# 检查系统当前状态
process-viewer status

配置方式

可通过设置环境变量 PROCESS_VIEWER_DIR 覆盖默认数据目录。默认值为：~/.local/share/process-viewer/

输出说明

所有命令均输出至 stdout。可通过重定向保存到文件，例如：process-viewer > output.txt。导出命令（json、csv、txt）会将文件写入数据目录，并在终端中打印输出路径与文件大小。

由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com