命令行与文本处理 / 系统课时

脚本结束时怎样输出执行结果

脚本结束时怎样输出执行结果

定时脚本只输出业务日志,往往很难快速判断这次任务是否成功。本节把开始时间、结束时间、耗时、最终状态和退出码统一输出,让日志既方便人工检查,也便于后续监控系统采集。

学习目标

  • 记录脚本的开始时间、结束时间和执行耗时
  • 根据核心命令的退出状态生成 SUCCESS 或 FAILED 结果
  • 保留正确退出码,让调度器能够判断任务是否成功

记录一次执行需要哪些信息

一条有用的结束记录至少应回答四个问题:任务什么时候开始、什么时候结束、运行了多久、最终是否成功。对于由 cron 或其他调度器启动的脚本,还应保留退出码,因为外部系统通常不会解析自然语言日志,而是直接根据退出码判断任务状态。

Shell 命令执行成功时通常返回 0,失败时返回非零值。因此可以先记录开始时间,再执行核心任务,保存其结果,最后统一计算耗时并退出。

在脚本结束时统一输出结果

下面的脚本可以直接运行。示例用 sleep 和 echo 代表真正的业务操作,实际使用时只需要替换 if 中的命令即可。

bash
cat > run-job.sh <<'EOF'
#!/usr/bin/env bash
set -u

start_epoch=$(date +%s)
start_time=$(date '+%Y-%m-%d %H:%M:%S')
status="SUCCESS"
exit_code=0

echo "start_time=$start_time"

if sleep 1 && echo "work completed"; then
  status="SUCCESS"
else
  status="FAILED"
  exit_code=$?
fi

end_epoch=$(date +%s)
end_time=$(date '+%Y-%m-%d %H:%M:%S')
duration_seconds=$((end_epoch - start_epoch))

echo "end_time=$end_time"
echo "duration_seconds=$duration_seconds"
echo "status=$status"
echo "exit_code=$exit_code"

exit "$exit_code"
EOF

chmod +x run-job.sh
./run-job.sh

预期输出

text
start_time=<TIME>
work completed
end_time=<TIME>
duration_seconds=<TIME>
status=SUCCESS
exit_code=0

其中时间和耗时会随实际运行时刻变化,因此用 <TIME> 表示动态值。

正确保存失败命令的退出码

退出码必须在失败命令执行后立即取得。上例把核心任务放在 if 条件中,可以在启用更严格的错误处理策略时仍然显式处理成功与失败,而不会在输出最终结果之前意外结束脚本。

需要特别注意,不能先执行其他命令,再用 $? 获取之前任务的结果。$? 只表示最近一条命令的退出状态,例如先打印日志再读取 $?,得到的可能只是 echo 的状态。

让日志和调度器得到一致结论

脚本打印 status=FAILED 后,还必须以非零值退出;否则调度器仍可能把任务标记为成功。同样,成功执行时应以 0 退出。这样日志中的状态、Shell 退出码以及外部调度系统看到的结果才能保持一致。

对于长期运行的自动化任务,可以固定使用 key=value 形式输出关键字段。相比自由文本,这种格式更容易通过 grep、日志采集器或监控规则提取,也能在故障发生时快速确认某次执行的起止时间和最终状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

脚本结束时怎样输出执行结果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通