シェルスクリプトのログ設計パターン｜ログレベル関数・タイムスタンプ付与・ファイルとコンソール分岐を実装する方法

この記事のポイント

・DEBUG/INFO/WARN/ERROR の4段階ログレベル関数を自作できる
・タイムスタンプとスクリプト名を付与して追跡しやすくする
・tee でコンソールとログファイルへ同時に書き出す設計を実装できる
・trap EXIT でスクリプト終了時の自動ログ記録を組み込める

#!/bin/bash
set -euo pipefail

# ログレベル定数（0=DEBUG 1=INFO 2=WARN 3=ERROR）
LOG_LEVEL=${LOG_LEVEL:-1}
LOG_FILE=${LOG_FILE:-/var/log/myscript.log}

_log() {
    local level="$1"
    local level_num="$2"
    local msg="$3"
    local ts
    ts=$(date '+%Y-%m-%d %H:%M:%S')
    local line="${ts} [${level}] ${BASH_SOURCE[1]##*/}:${BASH_LINENO[0]} ${msg}"
    if [ "${level_num}" -ge "${LOG_LEVEL}" ]; then
        echo "${line}" | tee -a "${LOG_FILE}"
    fi
}

log_debug() { _log "DEBUG" 0 "$*"; }
log_info()  { _log "INFO"  1 "$*"; }
log_warn()  { _log "WARN"  2 "$*"; }
log_error() { _log "ERROR" 3 "$*"; }

log_info  "バックアップ処理を開始します"
log_debug "対象ディレクトリ: /var/data"
log_warn  "ディスク使用率が80%を超えています"
log_error "接続に失敗しました"

2026-10-19 10:00:01 [INFO]  backup.sh:45 バックアップ処理を開始します
2026-10-19 10:00:01 [DEBUG] backup.sh:46 対象ディレクトリ: /var/data
2026-10-19 10:00:05 [WARN]  backup.sh:52 ディスク使用率が80%を超えています
2026-10-19 10:00:08 [ERROR] backup.sh:60 接続に失敗しました

# bash 4.2以降: サブシェルを使わないタイムスタンプ取得
printf -v ts '%(%Y-%m-%d %H:%M:%S)T' -1
echo "${ts} [INFO] 処理開始"

# ファイルのみに出力する（cronなどサイレント実行）
echo "${line}" >> "${LOG_FILE}"

# コンソール + ファイルの両方に出力する
echo "${line}" | tee -a "${LOG_FILE}"

# WARN以上だけ標準エラーへ出力する
if [ "${level_num}" -ge 2 ]; then
    echo "${line}" | tee -a "${LOG_FILE}" >&2
else
    echo "${line}" >> "${LOG_FILE}"
fi

#!/bin/bash
# スクリプト全体の stdout/stderr をログファイルへ記録する
exec > >(tee -a /var/log/myscript.log) 2>&1

echo "この行もログに記録される"
ls /nonexistent  # エラーも記録される

#!/bin/bash
set -euo pipefail

LOG_FILE=/var/log/myscript.log
SCRIPT_START=$(date '+%Y-%m-%d %H:%M:%S')

# 終了時ハンドラ: 終了コードをログに記録する
_on_exit() {
    local exit_code=$?
    local end_ts
    end_ts=$(date '+%Y-%m-%d %H:%M:%S')
    if [ "${exit_code}" -eq 0 ]; then
        echo "${end_ts} [INFO]  スクリプト正常終了 (exit_code=0)" >> "${LOG_FILE}"
    else
        echo "${end_ts} [ERROR] スクリプト異常終了 (exit_code=${exit_code})" >> "${LOG_FILE}"
    fi
}
trap '_on_exit' EXIT

echo "${SCRIPT_START} [INFO]  処理開始" >> "${LOG_FILE}"

# ERR トラップ: 失敗したコマンドの行番号を記録する
_on_err() {
    local exit_code=$?
    local line_no="${BASH_LINENO[0]}"
    echo "$(date '+%Y-%m-%d %H:%M:%S') [ERROR] ${BASH_SOURCE[1]##*/} line ${line_no} で失敗 (exit_code=${exit_code})" >> "${LOG_FILE}"
}
trap '_on_err' ERR

# 日付付きログファイル: /var/log/backup/2026-10-19.log のように自動分割
LOG_DIR=/var/log/backup
mkdir -p "${LOG_DIR}"
LOG_FILE="${LOG_DIR}/$(date '+%Y-%m-%d').log"

# /etc/logrotate.d/myscript
/var/log/myscript.log {
    daily
    rotate 30
    compress
    missingok
    notifempty
    create 0644 root root
}

# 30日以上古いログファイルを削除する
find /var/log/backup -name '*.log' -mtime +30 -delete

LOG_DIR=/var/log/backup
mkdir -p "${LOG_DIR}" || { echo "ログディレクトリ作成失敗: ${LOG_DIR}"; exit 1; }
LOG_FILE="${LOG_DIR}/myscript.log"

# ERRトラップが発火しないケース（if文の中は例外）
if some_command; then
    log_info "成功"
fi

# ERRトラップが発火するケース（直接呼び出し）
some_command
log_info "成功"