定期バッチの「サイレント死」を防ぐ。シェルスクリプトのTrapとWebhook通知の安全設計

定期バッチの「サイレント死」を防ぐ。シェルスクリプトのTrapとWebhook通知の安全設計

公開: 2026/07/24
更新: 2026/11/06
目次
開閉

深夜や早朝に自動実行される定期バッチ処理。

ログのローテーション、データベースのバックアップ、外部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)と終了ステータス($?)を捕捉します。
Lowom 編集長 編集長
CAUTION trap内のコマンド失敗に注意
set -e が有効な状態で handle_error 内のコマンドが失敗すると、ハンドラー自体が中断されてしまいます。通知関数の中では一時的に set +e にするか、失敗しても無視できるように || true を付与しておくのが安全です。

エラー時の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バックアップ設計については、以下の記事でも具体的な実装パターンを解説しています。あわせて参考にしてみてください。

Lowom 編集長
この記事を書いた人:Lowom 編集長 現役Webエンジニア

都内IT企業に勤める業界20年のWebエンジニア。業務効率化・自動化スクリプトや快適な開発環境の構築、厳選したツール・ガジェットの活用法など、手元で実際に検証したリアルな一次情報をお届けします。