
通过 shell 包装脚本并捕获退出码、执行时长和标准输出,可轻量、可靠地实现对 python 脚本的成功/失败判定及基础运行时监控。
通过 shell 包装脚本并捕获退出码、执行时长和标准输出,可轻量、可靠地实现对 python 脚本的成功/失败判定及基础运行时监控。
在自动化运维、定时任务(如 cron)或 CI/CD 流程中,准确判断 Python 脚本是否成功执行至关重要。最简洁、健壮且无需修改原脚本的方式,是使用 Bash 脚本进行外部封装——它天然支持进程退出码($?)、时间统计和错误流捕获,避免了在 Python 内部手动打点、日志解析或引入额外依赖的复杂性。
以下是一个生产就绪的监控封装示例:
#!/bin/bash
# monitor_script.sh
SCRIPT_NAME="myscript.py"
START_TIME=$(date '+%Y-%m-%d %H:%M:%S')
echo "[$START_TIME] Starting $SCRIPT_NAME..."
# 使用 `time -p` 输出 POSIX 格式(秒级精度,便于解析),同时重定向 stderr 避免干扰
{ time python "$SCRIPT_NAME" 2>&1; } 2> /tmp/time_output.$$
DURATION=$(awk '/real/{print $2}' /tmp/time_output.$$ | sed 's/s//')
EXIT_CODE=$?
END_TIME=$(date '+%Y-%m-%d %H:%M:%S')
# 统一输出结构化信息
echo "----------------------------------------"
echo "Script: $SCRIPT_NAME"
echo "Start Time: $START_TIME"
echo "End Time: $END_TIME"
echo "Duration (sec): ${DURATION:-0.00}"
echo "Exit Code: $EXIT_CODE"
echo "Status: $(if [ $EXIT_CODE -eq 0 ]; then echo "SUCCESS"; else echo "FAILED"; fi)"
echo "----------------------------------------"
# 清理临时文件
rm -f /tmp/time_output.$$
# 可选:根据退出码触发告警或写入日志
if [ $EXIT_CODE -ne 0 ]; then
echo "[$(date)] ERROR: $SCRIPT_NAME failed with exit code $EXIT_CODE" >> /var/log/script_monitor.log
exit $EXIT_CODE
fi
✅ 关键优势说明:
- 退出码即真相:Python 程序正常结束返回 0,异常终止(未捕获异常、sys.exit(1)、os._exit() 等)均返回非零值,$? 是操作系统层面最权威的状态标识;
- 时间精准可控:time 命令提供 real/user/sys 三类耗时,-p 参数确保格式统一,适合后续解析;
- 零侵入性:无需修改原始 .py 文件,不增加日志耦合,兼容任何已有脚本;
- 可扩展性强:可轻松集成邮件通知(mail)、Prometheus 指标上报(通过 curl)、或写入数据库(sqlite3/psql)。
⚠️ 注意事项:
- 确保目标 Python 脚本本身遵循“失败即非零退出”原则(例如:显式调用 sys.exit(1) 或让未捕获异常自然终止);
- 若脚本内部吞并异常(如 try...except: pass),则仍会返回 0,需从代码逻辑层修复;
- 在容器或受限环境(如某些云函数)中,time 命令可能不可用,此时建议改用 Python 内置 time.perf_counter() + atexit 钩子作为备选方案。
综上,Bash 封装法以极小代价提供了高可靠性、高兼容性的执行监控能力,是工程实践中推荐的首选实践。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











