シェルスクリプトの死活監視設計｜curlとncコマンドでサービス状態を自動確認してアラートを送る方法

この記事のポイント

・curlの終了コードとHTTPステータスでWeb サービスの死活確認がワンライナーで書ける
・ncコマンドでTCPポートチェックを行い、Postfix など非HTTP系サービスも監視できる
・アラート連射を防ぐ「冷却期間設計」を組み込まないと障害復旧前にメールが爆発する
・cronで5分おきに実行しても負荷はほぼゼロで、1台でも多複数サービスを監視できる

# HTTP ステータスコードを取得して判定する
STATUS=$(curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time 10 https://www.example.com/)

if [ "$STATUS" -ge 200 ] && [ "$STATUS" -lt 400 ]; then
    echo "[OK] HTTP $STATUS"
else
    echo "[NG] HTTP $STATUS" >&2
fi

$ curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time 10 https://web-srv-01.example.local/
200
$ curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time 10 https://web-srv-02.example.local/
000
# 000 は接続失敗（サーバーダウン・ネットワーク不通など）

# TCP ポートが開いているか確認する
# -z: ポートスキャンモード（接続確立後すぐ切断）
# -w: タイムアウト秒数
nc -z -w 5 192.168.10.20 25
echo "終了コード: $?"
# 0 = 開いている / 1 = 閉じているまたは到達不能

# HTTP チェック関数（0=正常, 1=異常）
check_http() {
    local url="$1"
    local timeout="${2:-10}"
    local status
    status=$(curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time "$timeout" "$url")
    [ "$status" -ge 200 ] && [ "$status" -lt 400 ]
}

# TCP ポートチェック関数（0=到達可, 1=不到達）
check_port() {
    local host="$1"
    local port="$2"
    local timeout="${3:-5}"
    nc -z -w "$timeout" "$host" "$port"
}

#!/bin/bash
# -------------------------------------------------------
# service-monitor.sh — 複数サービス死活監視スクリプト
# 動作確認環境: RHEL 9.4 / Ubuntu 24.04 LTS
# cron: */5 * * * * /usr/local/bin/service-monitor.sh
# -------------------------------------------------------
set -uo pipefail

ALERT_MAIL="ops@example.com"
LOG="/var/log/service-monitor.log"
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')

# ログ関数
log_info()  { echo "[$TIMESTAMP] INFO  $*" >> "$LOG"; }
log_error() { echo "[$TIMESTAMP] ERROR $*" | tee -a "$LOG" >&2; }

# アラートメール送信関数（Postfix 経由）
send_alert() {
    local subject="$1"
    local body="$2"
    echo "$body" | mail -s "$subject" "$ALERT_MAIL"
}

# HTTP チェック（0=正常, 1=異常）
check_http() {
    local url="$1"
    local status
    status=$(curl -s -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time 10 "$url")
    [ "$status" -ge 200 ] && [ "$status" -lt 400 ]
}

# TCP ポートチェック（0=到達可, 1=不到達）
check_port() {
    nc -z -w 5 "$1" "$2"
}

# --------[ 監視実行 ]--------
errors=0

# Web サービスの監視
if ! check_http "https://www.example.com/"; then
    log_error "www.example.com HTTP 異常"
    send_alert "[監視] Web サービスダウン検知" \
        "www.example.com が HTTP 応答しません。サーバーを確認してください。"
    errors=$((errors + 1))
else
    log_info "www.example.com OK"
fi

# SMTP (Postfix) の監視
if ! check_port "mail.example.local" 25; then
    log_error "Postfix SMTP (port 25) 不到達"
    send_alert "[監視] Postfix ダウン検知" \
        "mail.example.local の SMTP ポート(25)に到達できません。"
    errors=$((errors + 1))
else
    log_info "Postfix (port 25) OK"
fi

log_info "チェック完了 (エラー数: $errors)"
exit "$errors"

# tail -10 /var/log/service-monitor.log
[2026-07-24 10:00:01] INFO  www.example.com OK
[2026-07-24 10:00:01] INFO  Postfix (port 25) OK
[2026-07-24 10:00:01] INFO  チェック完了 (エラー数: 0)
[2026-07-24 10:05:01] INFO  www.example.com OK
[2026-07-24 10:05:01] ERROR Postfix SMTP (port 25) 不到達
[2026-07-24 10:05:01] INFO  チェック完了 (エラー数: 1)
[2026-07-24 10:10:01] INFO  www.example.com OK
[2026-07-24 10:10:01] ERROR Postfix SMTP (port 25) 不到達
[2026-07-24 10:10:01] INFO  チェック完了 (エラー数: 1)

#!/bin/bash
# 冷却期間付きアラート設計のコアロジック
COOLDOWN_FILE="/tmp/monitor_alert_cooldown"
COOLDOWN_MINUTES=30

# 冷却期間中かどうか判定（0=送信してよい, 1=冷却中）
is_in_cooldown() {
    if [ ! -f "$COOLDOWN_FILE" ]; then
        return 1  # フラグなし = 冷却期間外
    fi
    local file_age
    file_age=$(( $(date +%s) - $(stat -c %Y "$COOLDOWN_FILE") ))
    [ "$file_age" -lt $(( COOLDOWN_MINUTES * 60 )) ]
}

# 冷却期間を考慮したアラート送信
send_alert_with_cooldown() {
    local subject="$1"
    local body="$2"
    if is_in_cooldown; then
        log_info "冷却期間中のためアラートスキップ"
        return 0
    fi
    echo "$body" | mail -s "$subject" "$ALERT_MAIL"
    touch "$COOLDOWN_FILE"  # フラグファイルを更新
    log_info "アラート送信: $ALERT_MAIL"
}

# 全サービスが正常に戻ったら冷却フラグをリセット
clear_cooldown() {
    rm -f "$COOLDOWN_FILE"
    log_info "冷却フラグをリセット（全サービス正常）"
}

[2026-07-24 10:05:01] ERROR Postfix SMTP (port 25) 不到達
[2026-07-24 10:05:01] INFO  アラート送信: ops@example.local
[2026-07-24 10:10:01] ERROR Postfix SMTP (port 25) 不到達
[2026-07-24 10:10:01] INFO  冷却期間中のためアラートスキップ
[2026-07-24 10:15:01] ERROR Postfix SMTP (port 25) 不到達
[2026-07-24 10:15:01] INFO  冷却期間中のためアラートスキップ
[2026-07-24 10:35:01] INFO  Postfix (port 25) OK
[2026-07-24 10:35:01] INFO  冷却フラグをリセット（全サービス正常）

# crontab -e で設定する（5分おきに実行する例）
*/5 * * * * /usr/local/bin/service-monitor.sh

# スクリプトに実行権限を付与する
chmod 700 /usr/local/bin/service-monitor.sh

# /etc/logrotate.d/service-monitor として保存する
/var/log/service-monitor.log {
    daily
    rotate 14
    compress
    missingok
    notifempty
    create 0644 root root
}

# 内部 CA を指定する（推奨）
curl --cacert /etc/pki/ca-trust/source/anchors/internal-ca.crt \
     -s -o /dev/null -w '%{http_code}' https://internal.example.local/

# 証明書検証をスキップする（開発環境のみ・本番不可）
curl -k -s -o /dev/null -w '%{http_code}' https://internal.example.local/

# /dev/tcp を使った TCP ポートチェック（bash 組み込み機能）
# nc が使えない環境での代替手段
check_port_bash() {
    local host="$1"
    local port="$2"
    local timeout="${3:-5}"
    (timeout "$timeout" bash -c "echo >/dev/tcp/$host/$port") 2>/dev/null
}

# service-monitor.sh の末尾に追記するハートビート更新
touch /var/run/service-monitor.heartbeat

# ハートビートチェック（別の cron ジョブや別サーバーから実行）
HEARTBEAT="/var/run/service-monitor.heartbeat"
MAX_AGE=600  # 10分以上更新されていなければ異常
if [ -f "$HEARTBEAT" ]; then
    age=$(( $(date +%s) - $(stat -c %Y "$HEARTBEAT") ))
    if [ "$age" -gt "$MAX_AGE" ]; then
        echo "監視スクリプトが停止している可能性があります" | \
            mail -s "[緊急] 監視スクリプト停止疑い" ops@example.com
    fi
fi