常駐ジョブのログを newsyslog で回すと決めた。conf を書いただけでは回らなかった

  • #macOS
  • #launchd
  • #newsyslog
  • #運用
常駐ジョブのログを newsyslog で回すと決めた。conf を書いただけでは回らなかった

今回やったこと / この記事について

launchd の常駐ジョブのログは、追記しっぱなしで launchd 自身は回転しない。2026-08-27 の実測では、ある機で 264MB、別の機で 87MB に育っていた。そこで macOS 標準の newsyslog で回転させる設定を入れた(PR #2780)。設定は 5MB を超えたら回転・5世代保持・gzip 圧縮である。

ところが、設定ファイルを書いただけでは回らなかった。実害が2件出たので、その経緯を記録する。

設定ファイルは置いて初めて効く

設定は scripts/config/newsyslog-ntmedia.conf にある。ただし、root が /etc/newsyslog.d/ に置かなければ効かない。実行は macOS 標準の newsyslog が毎時30分に行う。

sudo install -o root -g wheel -m 644 \
  scripts/config/newsyslog-ntmedia.conf /etc/newsyslog.d/ntmedia.conf
sudo newsyslog -nv | grep ntmedia   # -n は実際には回さない

リポジトリに conf があることと、実機で回っていることは別である。

実害1:glob の行に G フラグが要った(2026-08-27)

ログのファイル名は ntmedia-*.log のような glob で書く。この行に G フラグが無いと、newsyslog は * を含むただのファイル名として探しに行く。1件も一致しないまま、エラーも出さずに正常終了する。man 5 newsyslog.conf には「G indicates that the specified logfile_name is a shell pattern」とある。

手元で見た macOS 標準の conf には glob の行が無かったので、実例からは気づけなかった。G を付けずに設置して、13:30 と 14:30 の2回とも 5.3MB のログが回らなかった。

実害2:owner 列を省くと root 所有になった(2026-08-28)

[owner:group] 列を書かずに置くと、回転後の新ファイルは root 所有で作られる。man 5 newsyslog.conf に「By default, log files are owned by root:admin.」とある。一般ユーザーで走る launchd のジョブは、ログを開けず、プロセスが起動する前に exit 78 で落ちる。ジョブ本体が動いていないので、ログには1行も残らない。

2026-08-27 15:48 にこの設定を設置した後、16:30 の初回回転で6ジョブ+別の機の1ジョブが同時に止まった。復旧までは約18時間かかった。回った1本だけが元の所有者のまま exit 0 で、これが対照実験になった。

症状原因対策
ログが回らない(無音)glob の行に G が無いflags に G を付ける
ジョブが exit 78 で止まるowner 列が無く root 所有になる501:20 のように数値で書く
設定を直しても止まったまま既に root 所有のファイルは残るそのファイルを消す

owner は名前でなく数値の uid:gid で書く。1枚の conf を複数の機で共有するので、相手の機に無いユーザー名は書けない。

設定を直しても root 所有のファイルは残る

newsyslog は所有者を直さない。したがって、conf を直したあとも、すでに root 所有になったログは残り続ける。出口は、そのファイルを消すことである。次回の起動時に launchd が作り直す。

検査:conf の存在ではなく実機の症状を見る

scripts/test_log_rotation.py は、次のものを見る。

  • plist が書き出す先が conf に載っているか(新しいジョブを足して conf を忘れたら鳴る)
  • glob の行に G があるか
  • owner 列があるか、uid のズレが無いか
  • 実機に、閾値を大きく超えたログや root 所有のログが残っていないか

conf の読み取りだけで済む検査と、実ファイルのサイズを見る検査を分けている。後者は、次の毎時30分を待たないと判定できないためである。root で走る LaunchDaemon のログは root 所有が正しいので、除外は plist から導き、除外した名前と根拠は黙って消さずに出す。