常駐ジョブのログを 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 から導き、除外した名前と根拠は黙って消さずに出す。