4. 巡检脚本基础：巡检脚本的作用与分类、脚本语言选择与执行环境
在自动化部署与容量压测体系中，巡检脚本是连接“数据采集”与“决策执行”的核心纽带。本章将系统讲解巡检脚本的三大作用、三大分类、两种主流脚本语言的选型对比，以及脚本执行环境的标准化配置。理解这些基础，是后续编排安全权限控制的前提。
4.1 巡检脚本的作用与分类
巡检脚本的核心作用可归纳为三点：状态感知（判断系统是否健康）、趋势预警（发现资源瓶颈）、故障定位（通过日志分析缩小根因范围）。根据巡检目标的不同，脚本可分为以下三大类：
| 分类 | 核心目标 | 典型指标/内容 | 输出格式 | 执行频率 |
|---|---|---|---|---|
| 健康检查 | 确认服务进程、端口、API 响应是否正常 | 进程存活、端口监听、HTTP 状态码、心跳延迟 | JSON / 简单文本 | 高频（秒级/分钟级） |
| 资源监控 | 采集 CPU、内存、磁盘、网络等系统资源使用率 | CPU 使用率、内存剩余、磁盘 IOPS、带宽吞吐 | 时序数据 / CSV | 中频（分钟级） |
| 日志分析 | 从应用/系统日志中提取错误、慢查询、异常模式 | ERROR 关键字、响应时间 P99、堆栈频率 | 结构化摘要 / 告警事件 | 低频（小时级/事件触发） |
实践建议： 在容量压测场景中，三类脚本通常串联执行：健康检查脚本先确认压测目标可用，资源监控脚本在压测过程中持续采集，日志分析脚本在压测结束后扫描异常。不要将三类逻辑混写在同一个脚本中，应保持职责单一。
4.2 脚本语言选择：Python vs Shell
选择脚本语言时，需综合考虑执行效率、跨平台能力、第三方库依赖和运维团队技术栈。下表从六个关键维度对比 Python 与 Shell：
| 对比维度 | Shell (Bash) | Python |
|---|---|---|
| 启动速度 | 极快（毫秒级） | 较慢（百毫秒级，含解释器启动） |
| 系统命令调用 | 原生支持，管道/重定向简洁 | 需 subprocess 模块，代码稍长 |
| 数据处理 | awk/sed/grep 组合，适合文本流 | pandas/json 库，适合结构化数据 |
| 第三方库生态 | 弱，依赖系统命令 | 强，requests/psutil/paramiko 等 |
| 跨平台兼容 | 差（Linux/macOS 为主） | 好（Windows/Linux/macOS 均可） |
| 适合场景 | 快速健康检查、简单文件操作、进程管理 | 复杂逻辑、API 调用、数据分析、多线程 |
选型原则： 健康检查类脚本优先使用 Shell（轻量、无依赖）；资源监控与日志分析类脚本推荐使用 Python（数据处理能力强、可维护性好）。在同一个项目中，允许两种语言共存，但需通过统一的执行框架（如 Makefile 或 Ansible）进行调度。
4.3 脚本执行环境
脚本执行环境决定了巡检脚本的可靠性、安全性和可观测性。一个标准化的执行环境应包含以下要素：
- 运行时隔离： 使用容器（Docker）或虚拟环境（Python venv）避免依赖冲突。
- 超时控制： 所有脚本必须设置超时阈值（如 timeout 30），防止脚本卡死导致巡检任务堆积。
- 日志与退出码： 脚本必须输出结构化日志（JSON 格式），并遵循标准退出码规范（0 成功，非 0 失败）。
- 最小权限原则： 执行脚本的系统用户仅授予所需的最小权限（如只读文件、特定端口访问）。
- 环境变量注入： 敏感信息（密码、）通过环境变量传入，禁止硬编码在脚本中。
下图展示了巡检脚本从触发到结果回传的完整执行环境架构：
4.4 脚本编写规范示例
以下是一个符合生产标准的健康检查脚本示例（Shell 版本），展示了超时控制、退出码规范与结构化输出：
#!/bin/bash
# 健康检查脚本：检查 Nginx 进程与 80 端口
# 使用规范：超时 10 秒，输出 JSON，退出码 0/1
TIMEOUT=10
SERVICE="nginx"
PORT=80
# 检查进程
if ! pgrep -x "$SERVICE" >/dev/null 2>&1; then
echo '{"status":"DOWN","service":"nginx","reason":"process_not_found"}'
exit 1
fi
# 检查端口（超时控制）
timeout $TIMEOUT bash -c "echo >/dev/tcp/127.0.0.1/$PORT" 2>/dev/null
if [ $? -ne 0 ]; then
echo '{"status":"DOWN","service":"nginx","reason":"port_unreachable"}'
exit 1
fi
echo '{"status":"UP","service":"nginx","port":80}'
exit 0
常见陷阱： 不要在生产巡检脚本中使用
exit -1，退出码应为 0-255 之间的正整数。另外，timeout 命令在 macOS 上可能不存在，建议在脚本开头检测并兼容（如使用 gtimeout 或自行实现超时逻辑）。
4.5 执行环境标准化清单
在部署巡检脚本前，建议按以下清单检查执行环境是否就绪：
- 依赖安装： Python 脚本需提前安装 requirements.txt，Shell 脚本需确认 awk/sed/curl/jq 等命令可用。
- 目录结构： 统一脚本存放路径（如
/opt/scripts/health/），日志输出路径（如/var/log/patrol/）。 - 权限配置： 脚本文件权限设为 750（属主可读写执行，属组可读执行），属主为专用巡检用户（如
patrol）。 - 测试验证： 在非生产环境先执行一次，确认输出格式与退出码符合预期。
通过以上基础建设，巡检脚本才能稳定、安全地融入自动化部署与容量压测的编排体系，为后续的权限控制与安全审计打下坚实基础。