シェルスクリプトのロギング設計｜ログ関数・タイムスタンプ・teeで出力を二重化する実践パターン

この記事のポイント

・log_info/log_warn/log_errorの3関数でログレベルを統一できる
・execとteeを組み合わせるとファイルと画面に同時出力できる
・log_errorはstderrに出すとパイプラインで通知フィルタを挟める
・cron実行時はPATH・LANGが最小化され文字化けや「コマンドが見つからない」の原因になる

#!/bin/bash
# ログ関数ライブラリ（/usr/local/lib/log_functions.sh）

LOG_FILE="/var/log/myapp/$(date +%Y%m%d).log"

_log() {
  local level="$1"
  shift
  local timestamp
  timestamp=$(date '+%Y-%m-%d %H:%M:%S')
  echo "${timestamp} [${level}] $*"
}

log_info()  { _log "INFO"  "$@"; }
log_warn()  { _log "WARN"  "$@"; }
log_error() { _log "ERROR" "$@"; }

#!/bin/bash
# メインスクリプト（backup.sh）
source /usr/local/lib/log_functions.sh

log_info "バックアップを開始します"
log_warn "対象ディレクトリが空です: /data/work"
log_error "rsync に失敗しました（終了コード: $?）"

[miyazaki@web01 ~]$ bash backup.sh
2026-07-28 09:14:03 [INFO]  バックアップを開始します
2026-07-28 09:14:03 [WARN]  対象ディレクトリが空です: /data/work
2026-07-28 09:14:03 [ERROR] rsync に失敗しました（終了コード: 1）

#!/bin/bash
# log_errorだけstderrへ向ける（fd 2）
log_error() { _log "ERROR" "$@" >&2; }

#!/bin/bash
# ERRORだけをエラー専用ログに、INFOはメインログへ
bash backup.sh   1>> /var/log/myapp/info.log   2>> /var/log/myapp/error.log

#!/bin/bash
# ログレベル制御（0=DEBUG, 1=INFO, 2=WARN, 3=ERROR）
LOG_LEVEL=${LOG_LEVEL:-1}

_log() {
  local level_name="$1"
  local level_num="$2"
  shift 2
  if [ "${level_num}" -ge "${LOG_LEVEL}" ]; then
    local timestamp
    timestamp=$(date '+%Y-%m-%d %H:%M:%S')
    echo "${timestamp} [${level_name}] $*"
  fi
}

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

[miyazaki@web01 ~]$ LOG_LEVEL=0 bash backup.sh
2026-07-28 09:14:05 [DEBUG] rsync コマンドを構築中
2026-07-28 09:14:05 [INFO]  バックアップを開始します
2026-07-28 09:14:06 [INFO]  転送完了: 142 files

[miyazaki@web01 ~]$ bash backup.sh
2026-07-28 09:14:05 [INFO]  バックアップを開始します
2026-07-28 09:14:06 [INFO]  転送完了: 142 files

#!/bin/bash
# ===== ログ出力設定（スクリプト冒頭に置く）=====
LOG_DIR="/var/log/myapp"
LOG_FILE="${LOG_DIR}/$(date +%Y%m%d).log"
mkdir -p "${LOG_DIR}"

# 以降の全出力をファイルとコンソールに二重出力する
exec > >(tee -a "${LOG_FILE}") 2>&1
# ================================================

source /usr/local/lib/log_functions.sh

log_info "スクリプト開始: $0"

[miyazaki@web01 ~]$ bash backup.sh
2026-07-28 09:15:00 [INFO] スクリプト開始: backup.sh
2026-07-28 09:15:00 [INFO] バックアップを開始します
2026-07-28 09:15:02 [INFO] /data/web01 -> /backup/web01/20260728
2026-07-28 09:15:02 [INFO] 転送完了: 1,842 files, 2.3GB
2026-07-28 09:15:02 [INFO] スクリプト終了

[miyazaki@web01 ~]$ ls -la /var/log/myapp/
-rw-r--r-- 1 miyazaki miyazaki  312 Jul 28 09:15 20260728.log

[miyazaki@web01 ~]$ cat /var/log/myapp/20260728.log
2026-07-28 09:15:00 [INFO] スクリプト開始: backup.sh
2026-07-28 09:15:00 [INFO] バックアップを開始します
2026-07-28 09:15:02 [INFO] /data/web01 -> /backup/web01/20260728
2026-07-28 09:15:02 [INFO] 転送完了: 1,842 files, 2.3GB
2026-07-28 09:15:02 [INFO] スクリプト終了

#!/bin/bash
# cronで使う場合はスクリプト先頭でPATHを明示する
PATH=/usr/local/bin:/usr/bin:/bin
export PATH

LOG_DIR="/var/log/myapp"
LOG_FILE="${LOG_DIR}/$(date +%Y%m%d).log"
mkdir -p "${LOG_DIR}"
exec > >(tee -a "${LOG_FILE}") 2>&1

#!/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
LANG=ja_JP.UTF-8
export PATH LANG

# cronエントリ（スクリプト内でログを管理するためシンプルに書ける）
0 2 * * * /usr/local/bin/backup.sh

# crontabに一時的に以下を追加してcronの環境変数を確認する
* * * * * env > /tmp/cron_env.txt 2>&1