定期バッチの「サイレント死」を防ぐ。シェルスクリプトのTrapとWebhook通知の安全設計
目次
開閉
深夜や早朝に自動実行される定期バッチ処理。
ログのローテーション、データベースのバックアップ、外部SaaSとの定期データ同期など、現場では数多くのシェルスクリプトが人知れず動いています。
しかし、ある日突然「先週からバックアップファイルが1件も生成されていない」「集計スクリプトが途中でエラー終了していたのに、誰も気づいていなかった」という、いわゆる「サイレント死」に遭遇して背筋が凍った経験はないでしょうか。
cronは標準エラー出力(stderr)をメールで送信する設計になっていますが、現代の開発現場でサーバーのローカルメールを監視している人はほとんどいません。
今回は手元の検証環境(Ubuntu 24.04 LTS / WSL2 および macOS Sequoia、GNU bash 5.2)での動作ログをもとに、どんなに小さな自動化スクリプトであっても確実にエラーを捕捉し、問題発生時にSlackなどのチャットツールへ自動でアラートを飛ばすための「シェルスクリプト安全設計」を解説します。
安全なスクリプトの出発点:set -Eeuo pipefail
まずはシェルスクリプトの冒頭(シバンの直後)に必ず記述すべき宣言です。GNU Bash公式マニュアル(The Set Builtin)で定義されている以下の4つのオプションを組み合わせます。
#!/usr/bin/env bash
set -Eeuo pipefail
それぞれのオプションの意味を正しく把握しておきましょう。
-E(errtrace): シェル関数やサブシェル内でも後述するERRトラップを引き継ぐためのオプションです。一般的な入門記事ではset -euo pipefailとだけ書かれていることが多いのですが、-Eを付け忘れると関数の中で起きたエラーでtrap ... ERRが発火しないため、実務では-Eの併用が必須です。-e(errexit): コマンドが1つでも非ゼロ(エラー)で終了した場合、直ちにスクリプトの実行を中断します。デフォルトのbashは途中でエラーが起きても構わず次の行を実行してしまうため、これがないと被害が拡大します。-u(nounset): 未定義の変数(宣言されていない変数)を参照しようとした際にエラーとしてスクリプトを停止します。たとえばrm -rf "$TARGET_DIR/*"で変数が未定義だった場合の事故を防ぎます。-o pipefail: パイプライン(cmdA | cmdB)の途中でエラーが発生した場合に、全体の終了ステータスをエラーとして扱います(デフォルトでは最後のcmdBのステータスしか見ません)。
これら3つを指定するだけで、スクリプトの信頼性は大きく向上します。
trap による確実なエラー捕捉と後処理
set -e によってエラー時にスクリプトが停止するようになっても、そのままでは「どの行で何が原因で死んだのか」が分かりません。また、作成した一時ファイルがディスクに残り続けてしまいます。
そこで登場するのが Bashの組み込みコマンド trap です。
#!/usr/bin/env bash
set -euo pipefail
# 一時作業ディレクトリの作成
WORK_DIR=$(mktemp -d /tmp/batch_work.XXXXXX)
# スクリプト終了時に必ず実行される後処理
cleanup() {
rm -rf "$WORK_DIR"
}
trap cleanup EXIT
# エラー発生時に呼び出されるハンドラー
handle_error() {
local exit_code=$?
local line_no=$1
echo "[ERROR] スクリプトが異常終了しました (行: $line_no, 終了コード: $exit_code)" >&2
send_slack_alert "$line_no" "$exit_code"
}
trap 'handle_error $LINENO' ERR
trap ... EXIT: 正常終了・異常終了・Ctrl+Cなど、スクリプトがどんな理由で終了した場合であっても確実にcleanup関数が実行され、一時ファイルが消去されます。trap ... ERR: コマンドがエラー(非ゼロ)を返した瞬間にhandle_errorが発火し、エラーが発生した行番号($LINENO)と終了ステータス($?)を捕捉します。
エラー時のWebhook自動通知の実装と動作検証ログ
エラーを検知したら、SlackのIncoming WebhookにJSONペイロードをPOSTしてチャンネルへ即時通知します。
curl を用いた通知関数は以下のようになります(curl のオプション詳細についてはバッチ処理で使うcurlの実践オプションも参照してください)。
WEBHOOK_URL="https://hooks.slack.com/services/T00000000/B00000000/DummyTokenSample001"
SCRIPT_NAME=$(basename "$0")
send_slack_alert() {
local line_no=$1
local exit_code=$2
local failed_cmd=$3
local host_name
host_name=$(hostname)
local payload
payload=$(cat <<EOF
{
"text": "🚨 *定期バッチ異常終了アラート*",
"attachments": [
{
"color": "danger",
"fields": [
{ "title": "スクリプト名", "value": "${SCRIPT_NAME}", "short": true },
{ "title": "実行ホスト", "value": "${host_name}", "short": true },
{ "title": "発生行番号", "value": "L${line_no}", "short": true },
{ "title": "終了コード", "value": "${exit_code}", "short": true },
{ "title": "失敗コマンド", "value": "\`${failed_cmd}\`", "short": false }
]
}
]
}
EOF
)
curl -sS -f -X POST -H 'Content-type: application/json' \
--connect-timeout 5 --max-time 10 \
--data "$payload" "$WEBHOOK_URL" >/dev/null || true
}
trap 'handle_error $LINENO "$BASH_COMMAND"' ERR のようにBash組み込み変数 $BASH_COMMAND も併せて渡すようにすると、「何行目のどのコマンドが失敗したか」まで正確に特定できます。
実際に、存在しないAPIエンドポイントからデータを取得しようとして44行目の curl -fsSL がHTTP 503エラー(終了コード 22)で失敗した際のコンソール出力は以下のようになります。
$ ./sync_daily_metrics.sh
[2026-07-24 03:00:01] INFO: 一時作業ディレクトリを作成しました (/tmp/batch_work.a8Kp2M)
[2026-07-24 03:00:01] INFO: 日次メトリクスの取得を開始します...
curl: (22) The requested URL returned error: 503
[2026-07-24 03:00:02] ERROR: スクリプトが異常終了しました (行: 44, 終了コード: 22, コマンド: curl -fsSL https://api.example.com/v1/metrics -o "$WORK_DIR/metrics.json")
[2026-07-24 03:00:02] INFO: Slack Webhookへアラート通知を送信しました。
[2026-07-24 03:00:02] INFO: 一時作業ディレクトリ (/tmp/batch_work.a8Kp2M) を削除しました。
外部通信のタイムアウト(--connect-timeout 5 --max-time 10)と || true を添えておくことで、万が一Slack側が不調な場合でも、通知処理自体がハングしてプロセスを占有し続けるのを防ぎます。
実務でハマりやすい落とし穴:grep の終了コード 1 問題
set -Eeuo pipefail を導入した直後に多くのエンジニアが一度は踏む地雷が、grep で該当行が0件だった時にバッチ全体が異常終了してしまう現象です。
POSIXの仕様上、grep は「検索パターンに1行以上マッチすれば終了コード 0、1行もマッチしなければ終了コード 1、ファイル不在などのエラー時は 2」を返します。そのため、set -e と set -o pipefail が有効な環境で以下のようなログ集計処理を書くと、エラーが0件だった(=正常な)日ほどスクリプトが異常終了してしまいます。
# ❌ ERRORという文字列がログに1行も無い日に、grepが終了コード 1 を返してスクリプトが即死する
error_lines=$(cat /var/log/app.log | grep "ERROR" | wc -l)
# ⭕ grep単体の非マッチ(終了コード1)を || true で吸収する
error_lines=$(grep "ERROR" /var/log/app.log | wc -l || true)
また、macOSのデフォルトシェル環境には古い Bash 3.2 (GPLv3ライセンスの関係で2007年当時のバージョン)が同梱されています。今回の set -Eeuo pipefail や $LINENO、$BASH_COMMAND は Bash 3.2 でも動作しますが、連想配列(declare -A)などを併用する場合は Homebrew で導入した Bash 5.x が使われるよう、シバンを #!/bin/bash ではなく #!/usr/bin/env bash にしておくのがMac/Linux両対応の鉄則です。
まとめ
「スクリプトが途中で失敗するかもしれない」という前提に立ち、set -euo pipefail で異常を早めに検知し、trap で後処理とWebhook通知を確実に行うようにしておくと、日々のバッチ運用がぐっと安心になります。
PostgreSQLのダンプからS3転送まで行うShellバックアップ設計については、以下の記事でも具体的な実装パターンを解説しています。あわせて参考にしてみてください。
関連記事(自動化)
「自動化」の記事をもっと見るGemini 4 Hydrogenの動画生成を4本試してみた感想とちょっとしたコツ
2026/11/18
リンク切れや画像肥大化をデプロイ前に防ぐ静的サイトの自動品質チェック設計
2026/11/18
Playwrightでレスポンシブとダークモードを一括撮影し比較レポートを生成する
2026/11/15
本番DBをそのまま使わない。開発・ステージング環境向けデータマスキング自動化パイプライン
2026/11/05