シェルスクリプトのエラー通知設計｜mailx・sendmail・Webhookで障害をすぐ知らせる仕組みの作り方

この記事のポイント

・シェルスクリプト エラー通知の最短実装は「echo 本文 | mailx -s 件名 宛先」の1行
・trap ERR でエラーを自動検知し、通知関数を呼び出すのが実務の基本設計
・Slack Webhook は curl 1コマンドで送れ、メールより即時性が高い
・sendmail はメールヘッダを自由に制御でき、From アドレスを明示したい場合に使う

# RHEL 9系ではs-nailパッケージがmailxコマンドを提供する
dnf install mailx -y

apt install mailutils -y

echo "テスト送信" | mailx -s "mailxテスト" admin@example.com

echo "バックアップが失敗しました" | mailx -s "[ALERT] backup.sh エラー" admin@example.com

mailx -s "[ALERT] backup.sh エラー" admin@example.com << MAIL_BODY
スクリプト: backup.sh
サーバー: $(hostname)
発生日時: $(date '+%Y-%m-%d %H:%M:%S')
ログ: /var/log/backup.log
MAIL_BODY

#!/bin/bash
set -euo pipefail

ALERT_TO="admin@example.com"
SCRIPT_NAME=$(basename "$0")
SERVER_HOST=$(hostname)

notify_by_mail() {
    local exit_code=$1
    local line_no=$2
    {
        echo "スクリプト: ${SCRIPT_NAME}"
        echo "サーバー:   ${SERVER_HOST}"
        echo "失敗した行: ${line_no} 行目"
        echo "終了コード: ${exit_code}"
        echo "発生日時:   $(date '+%Y-%m-%d %H:%M:%S')"
        echo ""
        echo "ログを確認してください: /var/log/${SCRIPT_NAME%.sh}.log"
    } | mailx -s "[ALERT] ${SCRIPT_NAME} がエラー終了 @ ${SERVER_HOST}" "$ALERT_TO"
}

trap 'notify_by_mail $? $LINENO' ERR

# --- 実際の処理（失敗するとtrapが自動発動する）---
rsync -avz /data/src/ backup-server:/mnt/backup/
tar czf /backup/db-$(date +%Y%m%d).tar.gz /var/lib/mysql/

スクリプト: backup.sh
サーバー:   web01.example.com
失敗した行: 28 行目
終了コード: 23
発生日時:   2026-07-20 02:35:17

ログを確認してください: /var/log/backup.log

# /etc/scripts/notify.conf （パーミッション: 600, root所有）
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/TXXXX/BXXXX/XXXXXXXX"
ALERT_EMAIL="admin@example.com"

send_slack_alert() {
    local message="$1"
    [[ -z "${SLACK_WEBHOOK_URL:-}" ]] && return 0

    curl -s -X POST \
        -H 'Content-type: application/json' \
        --data "{\"text\":\":x: ${message}\"}" \
        "$SLACK_WEBHOOK_URL" > /dev/null
}

# 使用例
send_slack_alert "バックアップが失敗しました (サーバー: $(hostname), 日時: $(date '+%Y-%m-%d %H:%M:%S'))"

#!/bin/bash
set -euo pipefail

source /etc/scripts/notify.conf

SCRIPT_NAME=$(basename "$0")
SERVER_HOST=$(hostname)

notify_slack_error() {
    local exit_code=$1
    local line_no=$2
    local msg=":x: *[ALERT]* \`${SCRIPT_NAME}\` が \`${SERVER_HOST}\` でエラー終了"
    msg="${msg} (行: ${line_no}, 終了コード: ${exit_code})"

    curl -s -X POST -H 'Content-type: application/json' \
        --data "{\"text\":\"${msg}\"}" \
        "$SLACK_WEBHOOK_URL" > /dev/null
}

trap 'notify_slack_error $? $LINENO' ERR

# --- 実際の処理 ---

#!/bin/bash

MAIL_TO="admin@example.com"
MAIL_FROM="noreply@web01.example.com"
SCRIPT_NAME=$(basename "$0")
HOST=$(hostname)
DATE=$(date '+%Y-%m-%d %H:%M:%S')

/usr/sbin/sendmail "$MAIL_TO" << MAIL_BODY
From: ${MAIL_FROM}
To: ${MAIL_TO}
Subject: [ALERT] ${HOST} でスクリプトエラーが発生しました
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8

${DATE} に ${HOST} でエラーが発生しました。

スクリプト名: ${SCRIPT_NAME}
ログ確認先: /var/log/${SCRIPT_NAME%.sh}.log

MAIL_BODY

#!/bin/bash
# /opt/scripts/lib/notify.sh --- エラー通知ライブラリ

# デフォルト値（呼び出し元でexportして上書き可）
ALERT_EMAIL="${ALERT_EMAIL:-admin@example.com}"
SLACK_WEBHOOK_URL="${SLACK_WEBHOOK_URL:-}"

notify_error() {
    local msg="$1"
    local host
    host=$(hostname)
    local ts
    ts=$(date '+%Y-%m-%d %H:%M:%S')
    local full_msg="[${ts}] [ERROR] ${host}: ${msg}"

    # メール通知（常に送信）
    echo "$full_msg" | mailx -s "[ALERT] ${host} スクリプトエラー" "$ALERT_EMAIL"

    # Slack通知（Webhook URLが設定されている場合のみ）
    if [[ -n "$SLACK_WEBHOOK_URL" ]]; then
        curl -s -X POST -H 'Content-type: application/json' \
            --data "{\"text\":\":x: ${full_msg}\"}" \
            "$SLACK_WEBHOOK_URL" > /dev/null
    fi
}

#!/bin/bash
set -euo pipefail

# 追加1行目: ライブラリ読み込み
source /opt/scripts/lib/notify.sh

# 追加2行目: エラー時に自動通知するtrap
trap 'notify_error "$(basename "$0") が行 ${LINENO} で失敗 (終了コード: $?)"' ERR

# --- 既存の処理（変更不要）---
tar czf /backup/data-$(date +%Y%m%d).tar.gz /var/www/html/
rsync -az /backup/ backup-server:/mnt/nfs/backup/

# Postfixの稼働状態を確認
systemctl status postfix

# 出力例（正常時）
* postfix.service - Postfix Mail Transport Agent
     Loaded: loaded (/usr/lib/systemd/system/postfix.service; enabled)
     Active: active (running) since Sun 2026-07-20 01:00:00 JST

# 送信キューの確認
mailq

# メールログの確認（RHEL系）
tail -f /var/log/maillog

# メールログの確認（Debian/Ubuntu系）
tail -f /var/log/mail.log

curl -w "\nHTTP Status: %{http_code}\n" \
    -X POST -H 'Content-type: application/json' \
    --data '{"text":"疎通テスト"}' \
    "$SLACK_WEBHOOK_URL"

# if文の条件では失敗してもtrapは発動しない（仕様）
if ls /nonexistent_path; then
    echo "found"
fi

# trapを確実に発動させるには明示的な終了コードチェックを使う
ls /nonexistent_path || { notify_error "ディレクトリが見つかりません"; exit 1; }