サービスが勝手に止まる・再起動を繰り返す

夜間にサービスが止まっていた、監視で起動と停止を何度も繰り返している、という状況です。systemdが記録している「止まった理由」を順に読んでいきます。

どんな症状か

朝になるとサービスが止まっている、systemctl statusでactivating (auto-restart)が続く、またはstart request repeated too quicklyと表示されて起動できない、といった症状です。最後のものは、systemdが「短時間に失敗を繰り返したので、これ以上は再起動しない」と判断した状態です。

原因を切り分ける

ステップ1:状態と、最後に止まった理由を確認する

$ systemctl status myapp --no-pager
× myapp.service - My Application
     Loaded: loaded (/etc/systemd/system/myapp.service; enabled; preset: enabled)
     Active: failed (Result: exit-code) since Mon 2026-11-16 03:12:44 JST; 6h ago
    Process: 2318 ExecStart=/opt/myapp/bin/server (code=exited, status=1/FAILURE)
   Main PID: 2318 (code=exited, status=1/FAILURE)

Result:に止まった理由の種類が出ます。exit-codeはプログラムがエラーで終了、signalはシグナルで終了(status=9/KILLなら強制終了)、oom-killはメモリ不足による強制終了、start-limit-hitは再起動の回数制限に達した状態です。

ステップ2:止まる直前のログを読む

$ journalctl -u myapp --since "today" --no-pager | tail -n 20
$ journalctl -u myapp -p err -b --no-pager

プログラム自身のエラーメッセージ(設定ファイルの読み込み失敗、接続先のデータベースに接続できない、ポートが使用中など)は、ここに記録されます。-p errでエラー以上だけに絞り込むと、原因の行を見つけやすくなります。

ステップ3:OOM Killerで強制終了されていないか確認する

$ journalctl -k --since "today" | grep -i -E 'out of memory|oom'
$ systemctl show myapp -p MemoryMax -p NRestarts

メモリが不足すると、カーネルがプロセスを強制終了します。ユニットにMemoryMax(メモリの上限)が設定されている場合は、その上限を超えただけで強制終了されます。NRestartsは、自動再起動した回数です。

ステップ4:再起動の設定を確認する

$ systemctl cat myapp

Restart=on-failureなどの自動再起動の設定と、StartLimitBurst・StartLimitIntervalSec(一定時間内に何回まで再起動するか)を確認します。自動再起動があると、障害に気付かないまま再起動が繰り返され、根本的な原因が放置されがちです。

解決方法

  • 原因を取り除いてから起動する:
    ログに出たエラー(設定の誤り・依存先の停止・メモリ不足など)を直し、sudo systemctl reset-failed myappで失敗の記録を消してから、sudo systemctl start myappで起動します。
  • メモリが原因の場合:
    アプリケーションのメモリ設定を見直すか、MemoryMaxやサーバーのメモリを増やします(「メモリ不足・スワップの使用量が増えている」)。
  • 設定を変えた場合:
    ユニットファイルを編集したら、sudo systemctl daemon-reloadを忘れずに実行します。

再発を防ぐために

自動再起動は、一時的な障害からの回復には便利ですが、再起動したことを監視で検知できるようにしておくことが大切です。サービスの状態(systemctl is-active)や、ジャーナルのエラーの件数を監視し、再起動が繰り返されたら通知する仕組みにしておきましょう。

関連する章:
systemdのユニットの書き方は上級「システム起動のカスタマイズ(systemd詳細)」、起動しないときは「systemctlでサービスが起動しない」を参照してください。

この記事の内容を練習できる課題

同じような状況を、ブラウザの練習用ターミナルで再現して試せます。本番のサーバーで慌てないよう、手順を一度なぞっておきましょう。

ほかの課題は、練習問題の一覧から選べます。