本文介绍如何通过shell脚本封装、退出码捕获与时间统计,简洁可靠地监控python脚本的执行起止时间及成功/失败状态,无需额外python依赖,开箱即用。
本文介绍如何通过shell脚本封装、退出码捕获与时间统计,简洁可靠地监控python脚本的执行起止时间及成功/失败状态,无需额外python依赖,开箱即用。
在自动化任务、定时作业(如cron)或CI/CD流水线中,准确判断Python脚本是否成功执行至关重要。一个健壮的监控方案应至少包含三项核心信息:脚本启动时间、结束时间、执行结果(成功/失败)。虽然可在Python内部用time.time()和try/except手动记录,但该方式耦合度高、易受异常中断影响(如sys.exit()未被捕获、信号终止等),且难以统一管理多个脚本。
更推荐的做法是在进程层面进行外部封装——使用Bash脚本作为“运行代理”,利用操作系统原生机制完成轻量级、高可靠性监控。其原理清晰:
- time 命令自动输出真实耗时(real)、用户态CPU时间(user)和内核态CPU时间(sys),其中 real 即为端到端执行时长;
- $? 变量始终保存上一条命令的退出状态码:0 表示成功,非0(如1)表示异常退出;
- Python脚本只需遵循标准约定:正常结束时隐式返回0,发生未捕获异常(如ValueError)、显式调用sys.exit(1)或raise SystemExit(1)时返回非零值。
以下是一个生产就绪的监控脚本示例(保存为 run_with_monitor.sh):
#!/bin/bash
# 使用严格模式,避免未定义变量导致误判
set -euo pipefail
SCRIPT_PATH="${1:-./myscript.py}"
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
echo "[$TIMESTAMP] Starting: $SCRIPT_PATH"
START_TIME=$(date +%s.%N)
# 执行目标脚本,并捕获完整时间输出与退出码
if output=$( { time python "$SCRIPT_PATH"; } 2>&1 ); then
EXIT_CODE=0
echo "$output" | grep -E '^(real|user|sys)' # 仅显示time统计行
else
EXIT_CODE=$?
echo "$output" | grep -E '^(real|user|sys|Traceback|Error)' # 同时输出错误堆栈关键行
fi
END_TIME=$(date +%s.%N)
ELAPSED=$(echo "$END_TIME - $START_TIME" | bc -l | awk '{printf "%.3f", $1}')
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Finished: exit code $EXIT_CODE, duration $ELAPSED s"
使用方式:
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
chmod +x run_with_monitor.sh ./run_with_monitor.sh myscript.py
✅ 优势总结:
- 零侵入:无需修改原有Python脚本,兼容任意第三方库与框架;
- 强健性:即使脚本因KeyboardInterrupt、MemoryError或SIGTERM崩溃,Bash仍能捕获退出码;
- 可审计:时间戳、耗时、退出码全部结构化输出,便于日志采集与告警;
- 可扩展:可轻松集成邮件通知(mail -s "Fail: $SCRIPT_PATH" admin@example.com)、写入数据库或上报Prometheus。
⚠️ 注意事项:
- 确保系统已安装time命令(GNU time,通常默认存在)及bc(用于高精度浮点计算);
- 避免在Python脚本中使用os._exit(0)——它会绕过Python清理逻辑并直接终止进程,但仍会正确设置退出码;
- 若需更高精度(毫秒级)或跨平台支持(如Windows),建议改用Python内置subprocess模块编写监控器,但会增加复杂度。
这一方案以最小成本实现了最大可观测性,是运维友好、开发友好的黄金实践。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










