loggerコマンドでシステムログに任意のメッセージを記録する方法｜rsyslog転送やシェルスクリプト活用も

この記事のポイント

・logger コマンドでシェルから /var/log/messages（syslog）に直接書き込める
・-t でタグを付けるとスクリプト名で絞り込み検索できる
・-p でファシリティとプライオリティを指定してログの重要度を明示できる
・シェルスクリプトに組み込むことで cronジョブの実行記録・エラー検知が容易になる

# バージョン確認（インストール確認）
$ logger --version
logger from util-linux 2.37.4

# RHEL9 / Rocky Linux 9 の環境例
# Ubuntu 24.04 LTS でも同様に動作する

# 書式
logger "メッセージ"

# 実際のコマンド例
$ logger "バックアップスクリプトを開始しました"

# /var/log/messages への記録確認
$ tail -3 /var/log/messages
Apr 30 10:15:23 webserver01 tomohiro: バックアップスクリプトを開始しました

# Ubuntu / Debian の場合
$ tail -3 /var/log/syslog
Apr 30 10:15:23 ubuntu-server tomohiro: バックアップスクリプトを開始しました

# タグを付けてログを書き込む
$ logger -t backup_script "バックアップ処理を開始"
$ logger -t backup_script "バックアップ処理が正常に完了しました"

# 確認
$ tail -5 /var/log/messages
Apr 30 10:30:01 webserver01 backup_script: バックアップ処理を開始
Apr 30 10:30:45 webserver01 backup_script: バックアップ処理が正常に完了しました

# タグで絞り込む
$ grep "backup_script" /var/log/messages
Apr 30 10:30:01 webserver01 backup_script: バックアップ処理を開始
Apr 30 10:30:45 webserver01 backup_script: バックアップ処理が正常に完了しました

# エラーレベルで書き込む
$ logger -t backup_script -p local0.err "バックアップ先に接続できませんでした"

# 情報レベルで書き込む
$ logger -t backup_script -p local0.info "バックアップ処理を開始します"

# 警告レベルで書き込む
$ logger -t backup_script -p local0.warn "ディスク使用率が80%を超えました"

# コマンド出力をloggerに渡す
$ df -h / | logger -t disk_check

# 確認
$ grep "disk_check" /var/log/messages | tail -5
Apr 30 10:45:10 webserver01 disk_check: Filesystem      Size  Used Avail Use% Mounted on
Apr 30 10:45:10 webserver01 disk_check: /dev/sda1        50G   38G  9.5G  81% /

# /dev/stdinを経由しての記録（-fオプション）
$ cat /tmp/result.txt | logger -t batch_output

#!/bin/bash
# backup.sh - loggerでジョブ実行を記録するサンプル

SCRIPT_NAME="backup_nightly"
BACKUP_SRC="/var/www/html"
BACKUP_DEST="/mnt/nas/backup"

# 開始ログ
logger -t "$SCRIPT_NAME" -p local0.info "バックアップ開始: $BACKUP_SRC -> $BACKUP_DEST"

# バックアップ実行
if rsync -a "$BACKUP_SRC" "$BACKUP_DEST"; then
    # 成功ログ
    logger -t "$SCRIPT_NAME" -p local0.info "バックアップ正常完了"
else
    # エラーログ（errプライオリティ）
    logger -t "$SCRIPT_NAME" -p local0.err "バックアップ失敗: rsync が終了コード$?を返しました"
    exit 1
fi

# /etc/rsyslog.d/99-local.conf に追記（rsyslogの設定例）
# local0.* -> バックアップスクリプトのログ
local0.*    /var/log/backup.log

# local1.* -> デプロイスクリプトのログ
local1.*    /var/log/deploy.log

# rsyslog を再起動して設定を反映
$ sudo systemctl restart rsyslog

# 以降、logger -p local0.info で書いたログは /var/log/backup.log に記録される
$ logger -t backup_script -p local0.info "テスト書き込み"
$ tail -1 /var/log/backup.log
Apr 30 11:00:05 webserver01 backup_script: テスト書き込み

# -s で端末にも表示しながら syslog に記録
$ logger -s -t test_script "これはテストメッセージです"
test_script: これはテストメッセージです

# 端末に表示された後、syslogにも書き込まれている
$ tail -1 /var/log/messages
Apr 30 11:15:22 webserver01 test_script: これはテストメッセージです

# リモートsyslogサーバー（192.168.1.100）のUDP 514番ポートへ送信
$ logger -n 192.168.1.100 -P 514 -t web01_backup "バックアップ完了"

# TCP での送信（--tcp オプションを追加）
$ logger --tcp -n 192.168.1.100 -P 514 -t web01_backup "バックアップ完了"

# スクリプトの実行結果ファイルをsyslogに転送
$ logger -t result_check -f /tmp/job_result.txt

# job_result.txtの中身
$ cat /tmp/job_result.txt
処理件数: 1523件
エラー件数: 0件
処理時間: 3分42秒

# syslogへの記録確認
$ grep "result_check" /var/log/messages
Apr 30 11:30:10 webserver01 result_check: 処理件数: 1523件
Apr 30 11:30:10 webserver01 result_check: エラー件数: 0件
Apr 30 11:30:10 webserver01 result_check: 処理時間: 3分42秒

# rsyslogの状態確認
$ sudo systemctl status rsyslog
* rsyslog.service - System Logging Service
   Loaded: loaded (/usr/lib/systemd/system/rsyslog.service; enabled)
   Active: inactive (dead)  ← 停止中

# rsyslogを起動する
$ sudo systemctl start rsyslog
$ sudo systemctl enable rsyslog

# 再度loggerを試す
$ logger -t test "rsyslog再起動後のテスト"
$ tail -1 /var/log/messages
Apr 30 11:40:05 webserver01 test: rsyslog再起動後のテスト

# journaldで確認
$ journalctl -t backup_script --since "1 hour ago"
Apr 30 11:00:05 webserver01 backup_script[12345]: バックアップ開始

# /var/log/messages に記録されない場合でも journalctl で取得できる
# タグ(-t)で絞り込み可能なので logger の -t 指定は journald でも有効

# Ubuntu / Debian系の確認コマンド
$ grep "backup_script" /var/log/syslog

# どちらの環境か分からない場合はjournalctlで確認するのが確実
$ journalctl -t backup_script --no-pager | tail -10

#!/bin/bash
# cron から呼ばれる場合は LANG を明示する
export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

logger -t batch_job "処理件数: 1523件"

#!/bin/bash
# cronから呼ばれるスクリプトの先頭に追記
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
export LANG=ja_JP.UTF-8

/usr/bin/logger -t my_job "cronスクリプト開始"