Mengapa systemd Tidak Me-restart Service Anda
Restart= hanya memantau proses utama. Pelajari mengapa proses anak yang mati dalam cgroup tidak terlihat, serta cara kerja Type=, batas restart, dan journal.
Jawaban singkat: kebijakan restart systemd memantau satu proses
Kebijakan restart systemd memantau satu proses untuk setiap unit: proses utama. Restart= membaca status keluar proses tersebut dan perintah singkat yang dijalankan systemd sendiri di sekitarnya, seperti ExecStartPre=, ExecStartPost=, dan ExecReload=. Selain itu, systemd tidak membaca hal lain. Control group suatu unit dapat menampung dua puluh proses. Salah satunya dapat berhenti, tetapi unit tetap berstatus active (running) karena proses utama masih berjalan. Dari sudut pandang systemd, tidak ada yang gagal sehingga tidak ada proses yang di-restart.
systemd mengetahui proses lainnya. systemd menghentikan proses tersebut saat unit dihentikan, menghitung penggunaan memorinya terhadap batas unit, menerapkan kuota CPU unit kepadanya, dan menampilkannya dalam systemctl status. Namun, systemd tidak pernah membaca status keluar proses tersebut. Logika restart dan cgroup adalah dua hal yang berbeda. Sebagian besar panduan ini membahas perbedaan di antara keduanya.
Apa yang ditampung cgroup dan apa yang dibaca logika restart
cgroup (control group) adalah objek kernel yang memiliki sekumpulan proses. Setiap service unit memiliki satu cgroup yang namanya mengikuti nama unit tersebut. Proses tidak dapat keluar dari cgroup itu. Proses anak mewarisi cgroup proses induknya, dan proses tanpa hak istimewa tidak dapat memindahkan dirinya ke tempat lain. Karena itu, systemd dapat membersihkan daemon yang melakukan fork dua kali. Skrip init lama tidak dapat melakukannya secara andal.
Perhatikan kedua fakta berikut secara berdampingan:
systemd-cgls --unit myapp.service
systemctl show -p MainPID -p NRestarts -p Restart -p RestartUSec myapp.servicesystemd-cgls mencantumkan setiap proses dalam unit. MainPID adalah satu-satunya angka yang dibaca oleh kebijakan restart. Jika kedua hal tersebut tidak sesuai dengan model mental Anda, ketidaksesuaian itulah bug-nya. MainPID=0 berarti systemd tidak memiliki proses utama untuk membaca status keluar. systemd tetap melacak cgroup, sehingga dapat mendeteksi saat proses terakhir di dalamnya sudah tidak ada. Namun, sampai saat itu, logika restart tidak memiliki status keluar untuk dinilai.
Ada satu pengecualian nyata terhadap aturan proses utama. Jika kernel out-of-memory killer menghentikan proses apa pun di dalam cgroup unit, systemd dapat mendeteksinya karena systemd memantau file memory.events pada cgroup tersebut. OOMPolicy= menentukan tindakan berikutnya. Nilai default-nya adalah stop: seluruh unit dihentikan, hasilnya dicatat sebagai oom-kill, dan hal itu dihitung sebagai kegagalan, sehingga Restart=on-failure dijalankan. Journal menyatakannya dengan jelas.
myapp.service: A process of this unit has been killed by the OOM killer.
myapp.service: Failed with result 'oom-kill'.Jadi, jika proses anak dihentikan karena kekurangan memori, unit memang ikut dihentikan. Namun, jika proses anak yang sama berhenti akibat segmentation fault, unit tidak ikut dihentikan. Jika Anda menetapkan batas memori pada unit, baca cara MemoryMax dan CPUQuota diterapkan pada cgroup unit sebelum menyesuaikan kebijakan restart, karena kedua fitur tersebut berinteraksi di sini dan tidak di tempat lain.
Cara Type= memilih proses utama
Type= pada bagian [Service] tidak hanya mengatur urutan startup. Parameter ini menentukan PID (process ID) yang menjadi MainPID. Dengan demikian, parameter ini juga menentukan apa yang dapat dilihat oleh Restart=.
Type=simpleadalah nilai default. Proses yang dibuat dengan fork oleh systemd dariExecStart=menjadi proses utama. systemd langsung menandai unit sebagai berhasil dimulai sebelum mengetahui apakahexecbenar-benar berhasil. Kesalahan ketik pada path biner membuat job start berhasil, laluMain process exited, code=exited, status=203/EXECsesaat kemudian.Type=execbekerja sepertisimple, tetapi job start menunggu hinggaexecberhasil. Dengan demikian, kesalahan ketik di atas menghasilkan kegagalan start yang sebenarnya. Parameter ini memerlukan systemd 240 atau yang lebih baru. Ubuntu 20.04 dan versi setelahnya serta Debian 12 memilikinya, tetapi Ubuntu 18.04, yang masih mendapatkan dukungan melalui Ubuntu Pro, menggunakan systemd 237 sehingga tidak memilikinya. Jika tersedia, pilih parameter ini daripadasimple.Type=forkingmengharapkan proses dariExecStart=melakukan fork untuk menjalankan daemon di latar belakang, lalu keluar. systemd menunggu proses induk keluar, kemudian mencari daemon yang sebenarnya. BerikanPIDFile=. Tanpa parameter tersebut,GuessMainPID=(aktif secara default) hanya berfungsi jika tepat satu proses tersisa dalam cgroup. Jika dua proses tersisa,MainPIDtetap0.Type=notifyberarti service memanggilsd_notify(3)dan mengirimREADY=1ketika sudah dapat melayani trafik. Service tersebut juga dapat mengirimMAINPID=untuk menyerahkan proses lain kepada systemd agar dipantau. DenganType=notify,NotifyAccess=diatur kemainkecuali Anda memilih nilai lain. Karena itu, notifikasi yang dikirim oleh proses anak diabaikan dan journal mencantumkan PID pengirimnya.Type=oneshottidak memiliki proses utama yang bertahan. Unit menjadi inactive segera setelahExecStart=selesai, kecuali Anda mengaturRemainAfterExit=yes.Restart=alwaysdanRestart=on-successditolak di sini dengan pesanService has Restart= set to either always or on-success, which isn't allowed for Type=oneshot services. Refusing.. Nilai lainnya, termasukon-failure, diterima.
Dua error Type=forking perlu diingat karena masing-masing dapat menghasilkan unit yang tampak rusak tanpa alasan yang terlihat:
myapp.service: Can't open PID file /run/myapp.pid (yet?) after start: No such file or directory
myapp.service: New main PID 4711 does not belong to service, and PID file is not owned by root. Refusing.Yang pertama berarti daemon menulis file PID di lokasi lain atau menulisnya setelah systemd selesai mencarinya. Yang kedua berarti file PID mencantumkan proses di luar cgroup unit. systemd menolak mengambil alih proses tersebut karena file PID yang dapat ditulis dapat digunakan untuk membuat systemd mengirim sinyal ke proses apa pun pada server.
Mengapa skrip wrapper menyembunyikan berhentinya proses turunannya
Berikut bentuk konfigurasi yang menimbulkan pertanyaan pada judul.
#!/bin/bash
/usr/local/bin/myapp-web &
/usr/local/bin/myapp-worker &
waitUnit tersebut adalah Type=simple, sehingga proses utamanya adalah shell. wait tanpa argumen hanya mengembalikan hasil setelah semua proses turunan berhenti. Hentikan worker, lalu shell tetap menunggu proses web. Akibatnya, shell tidak berhenti, MainPID tidak selesai, dan Restart= tidak pernah diperiksa. cgroup kini menampung satu proses lebih sedikit, systemctl status menampilkan pohon proses yang lebih pendek, dan unit tetap berstatus active (running). systemd tidak memantau perubahan pada pohon tersebut.
Versi kedua dari kesalahan yang sama lebih sulit terlihat:
ExecStart=/bin/sh -c 'export APP_ENV=production; /usr/local/bin/myapp'Proses utamanya adalah shell, bukan myapp. Saat systemctl stop, systemd mengirim SIGTERM ke proses utama. Shell yang sedang menunggu proses turunan foreground tidak meneruskan sinyal tersebut. Proses penghentian kemudian berlangsung selama TimeoutStopSec, yaitu 90 detik secara default, lalu berakhir seperti ini:
myapp.service: State 'stop-sigterm' timed out. Killing.
myapp.service: Killing process 4711 (myapp) with signal SIGKILL.Solusinya adalah exec. Tulis exec /usr/local/bin/myapp agar shell digantikan oleh program. Dengan demikian, MainPID adalah program tersebut dan sinyal dapat diterimanya. Lebih baik lagi, hapus shell dan gunakan Environment= atau EnvironmentFile= dalam unit. Perhatikan bahwa bug ini tidak terlihat ketika string -c hanya berisi satu perintah, karena bash dan dash mengoptimalkan kasus tersebut menjadi exec langsung. Tambahkan perintah kedua ke dalam string tersebut, lalu shell akan tetap berjalan di depan program Anda.
Reproduksi pada VPS pengujian dalam dua menit
Simpan wrapper di atas sebagai /usr/local/bin/two-children.sh, jadikan file tersebut executable dengan chmod +x, lalu ganti kedua path program dengan sleep 3600. Arahkan sebuah unit ke file tersebut menggunakan Type=simple dan Restart=on-failure, lalu jalankan systemctl daemon-reload dan start unit tersebut. Jalankan systemd-cgls --unit two-children.service dan catat tiga PID: shell dan kedua proses turunannya. Hentikan salah satu proses turunan dengan sudo kill <pid>. Periksa kembali unit tersebut. Pohon proses kini lebih pendek satu proses, statusnya tetap active (running), dan journal tidak menampilkan informasi baru. Sekarang jalankan sudo kill -9 <shell pid>. Unit gagal, proses turunan yang masih berjalan dibersihkan karena KillMode=control-group adalah nilai default, dan journal menampilkan Scheduled restart job, restart counter is at 1.
Seluruh kosakata Restart= dan kapan on-failure lebih tepat daripada always
Restart= memiliki tujuh nilai. Perbedaan di antara nilai-nilai tersebut ditentukan oleh apa yang dianggap sebagai keluar secara normal. systemd menganggap kode keluar 0, semua kode yang tercantum dalam SuccessExitStatus=, serta sinyal SIGHUP, SIGINT, SIGTERM, dan SIGPIPE sebagai keluar secara normal untuk semua jenis kecuali Type=oneshot. Selain itu, termasuk SIGKILL dan SIGSEGV, dianggap sebagai keluar secara tidak normal.
noadalah nilai default. Unit tidak pernah me-restart dirinya sendiri. Karena itu, unit tanpa barisRestart=akan berhenti saat crash pertama dan tetap berhenti.on-successhanya me-restart unit setelah unit berhenti secara normal.on-failureme-restart unit setelah kode keluar non-zero, sinyal yang tidak normal, timeout saat start atau stop, atau watchdog kedaluwarsa.on-abnormalme-restart unit setelah sinyal yang tidak normal, timeout, atau watchdog kedaluwarsa, tetapi tidak setelah kode keluar non-zero biasa.on-aborthanya me-restart unit setelah sinyal yang tidak normal, yang berarti crash.on-watchdoghanya me-restart unit saatWatchdogSec=kedaluwarsa.alwaysme-restart unit setelah semua kondisi di atas, termasuk keluar secara normal dengan status 0.
on-failure adalah nilai default yang tepat untuk daemon yang berjalan lama. Nilai ini memulihkan daemon setelah crash, tetapi membiarkan exit 0 yang disengaja. always sesuai untuk program yang berhenti secara normal karena alasan di luar kendalinya, seperti klien tunnel yang mengembalikan 0 saat sisi tujuan terputus. Dampak always adalah bug dapat tersembunyi. Service yang start, membaca file konfigurasi yang rusak, mencatat error, lalu keluar dengan kode 0 akan langsung di-start lagi. Dengan jeda default 100 milidetik, service tersebut segera mencapai batas laju start yang dijelaskan di bawah dan berakhir dalam status failed dengan start-limit-hit. Dengan RestartSec= yang cukup panjang untuk tetap berada di bawah batas tersebut, service akan loop tanpa henti. Satu-satunya tanda adalah penghitung restart yang terus meningkat.
SuccessExitStatus= mengubah batas antara kondisi normal dan tidak normal. Borg keluar dengan kode 1 untuk peringatan dan 2 untuk error. Karena itu, unit backup tanpa SuccessExitStatus=1 ditandai failed setiap kali melewati satu file yang tidak dapat dibaca. RestartPreventExitStatus= mencantumkan kode yang mencegah restart bahkan dengan always. Ini adalah cara yang tepat bagi program untuk menyatakan bahwa program tersebut tidak boleh dijalankan kembali. RestartForceExitStatus= melakukan kebalikannya. Pekerjaan backup sebaiknya berada dalam unit Type=oneshot yang dijalankan oleh timer, bukan dalam loop restart. pasangan service dan timer yang menjalankan pekerjaan sesuai jadwal adalah pola yang dapat digunakan.
Ada satu peringatan saat melakukan pengujian. Menghentikan service dengan kill <pid> biasa mengirimkan SIGTERM, yang termasuk dalam daftar keluar normal. Karena itu, Restart=on-failure tidak melakukan apa pun secara tepat dan Anda dapat menyimpulkan bahwa konfigurasi Anda rusak. Gunakan kill -9 <pid> atau systemctl kill -s SIGKILL myapp.service sebagai gantinya. Ingat juga bahwa tidak ada nilai Restart= yang dijalankan setelah systemctl stop atau ketika unit dihentikan karena dependensi BindsTo= atau PartOf= tidak lagi tersedia. Pekerjaan stop bukanlah kegagalan.
RestartSec dan default 100 milidetik
RestartSec= adalah jeda antara unit berhenti dan systemd menjalankannya kembali. Nilai defaultnya adalah 100 milidetik. Periksa nilai yang benar-benar dimuat oleh unit Anda:
systemctl show -p RestartUSec -p StartLimitIntervalUSec -p StartLimitBurst myapp.serviceUnit yang tidak menetapkan nilai ini akan menampilkan RestartUSec=100ms, kecuali seseorang mengubah DefaultRestartSec= di /etc/systemd/system.conf. Dari situlah nilai yang tidak ditetapkan berasal. Default tersebut sesuai untuk service yang gagal sekali lalu kembali berjalan. Namun, nilai tersebut tidak sesuai untuk service yang sama sekali tidak dapat start. Pada program yang langsung gagal, proses start pertama dan empat restart berikutnya dapat selesai jauh di bawah satu detik. Proses tersebut menghabiskan lima percobaan start yang diizinkan oleh batas laju yang dijelaskan berikutnya. Untuk service yang menunggu database, mount, atau rute jaringan, tetapkan RestartSec=5s atau lebih.
Per Oktober 2026, systemd 254 dan versi yang lebih baru juga menyediakan RestartSteps= dan RestartMaxDelaySec=. Keduanya meningkatkan jeda dari RestartSec= hingga mencapai batas maksimum setelah sejumlah percobaan tersebut. Ubuntu 24.04 menyertakan systemd 255 dan mendukung keduanya. Debian 12 menyertakan systemd 252 dan tidak mendukungnya, meskipun bookworm-backports menyediakan systemd 254. Jeda yang meningkat merupakan pilihan yang tepat ketika dependensi mungkin tidak tersedia dalam waktu lama.
Apa arti sebenarnya dari "start request repeated too quickly"
Inilah kondisi yang sering dianggap sebagai systemd menyerah secara acak. Sebenarnya, ini adalah penghitung. Aturannya: jika sebuah unit dijalankan lebih dari StartLimitBurst= kali dalam StartLimitIntervalSec=, systemd menolak menjalankannya lagi dan menempatkannya dalam status failed. Nilai defaultnya adalah 5 kali start dalam 10 detik.
Journal menampilkan urutannya:
myapp.service: Scheduled restart job, restart counter is at 5.
myapp.service: Start request repeated too quickly.
myapp.service: Failed with result 'start-limit-hit'.
Failed to start myapp.service - My application.dan systemctl start memberikan jawaban berupa perbaikan yang sudah dituliskan:
Job for myapp.service failed because start of the service was attempted too often. See "systemctl status myapp.service" and "journalctl -xeu myapp.service" for details. To force a start use "systemctl reset-failed myapp.service" followed by "systemctl start myapp.service" again.systemctl reset-failed myapp.service menghapus penghitung dan status failed. Tanpa perintah ini, systemctl start biasa akan terus ditolak sampai jendela StartLimitIntervalSec= berakhir, dan restart otomatis tetap dinonaktifkan sampai sesuatu menjalankan unit tersebut lagi. Start manual juga dihitung dalam batas ini. Jadi, beberapa kali menjalankan systemctl restart dengan tidak sabar saat mengedit file konfigurasi dapat memicunya, meskipun tidak ada crash sama sekali.
Bagian yang menyesatkan adalah: start-limit-hit tidak pernah menjelaskan mengapa service gagal. Pesan ini hanya menyatakan bahwa service gagal berulang kali dalam waktu singkat. Alasan sebenarnya ada pada baris-baris journal sebelumnya.
Kedua pengaturan tersebut harus berada di bagian [Unit]. Anda mungkin menemukan contoh yang menempatkannya di [Service], yang diterima oleh systemd versi lama. Di sinilah kebingungan biasanya bermula. Tulis pengaturan tersebut di [Unit], lalu tanyakan kepada systemd nilai yang dimuatnya dengan systemctl show, karena hanya nilai yang dimuat yang berlaku.
[Unit]
Description=My application
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
ExecStart=/usr/local/bin/myapp
Restart=on-failure
RestartSec=10sDengan konfigurasi tersebut, unit akan mencoba sebanyak lima kali dalam jendela lima menit sebelum berhenti mencoba. StartLimitIntervalSec=0 menonaktifkan batas ini sepenuhnya. Anda harus memahami konsekuensinya: service yang tidak pernah dapat start akan mencoba lagi tanpa batas dan menulis pesan ke journal setiap kali. Nilai default untuk seluruh mesin berada di /etc/systemd/system.conf sebagai DefaultStartLimitIntervalSec= dan DefaultStartLimitBurst=.
Ada satu pengaturan terkait yang perlu diperhatikan. StartLimitAction= menentukan tindakan saat batas tercapai, dan menerima nilai seperti reboot, reboot-force, dan poweroff. Nilai defaultnya adalah none, yang membuat unit gagal dan membiarkan mesin tetap menyala. Pada VPS jarak jauh, poweroff berarti mesin yang tetap mati sampai Anda membuka console dari provider.
Perbaikan satu: satu proses per unit
Ini adalah jawaban yang tepat dalam hampir semua kasus. Jika dua program harus berjalan, tulis dua unit. Dengan demikian, masing-masing unit memiliki proses utama yang jelas, status keluar yang jelas, dan kebijakan restart sendiri. Anda juga mendapatkan log, batas resource, dan penghitung restart yang terpisah. Ini diperlukan saat terjadi masalah pada pukul tiga pagi.
Nyatakan hubungan antarunit dalam file unit, bukan dalam shell script.
After=hanya mengatur urutan start-up. Opsi ini tidak menjelaskan apa pun tentang kegagalan.Requires=menjalankan unit lain secara bersamaan dengan unit ini dan menghentikan unit ini jika unit lain dihentikan secara eksplisit.BindsTo=adalahRequires=ditambah kasus yang penting: unit ini berhenti jika unit lain berhenti karena alasan apa pun, termasuk crash. Pasangkan denganAfter=. Jika tidak, urutannya tidak ditentukan.PartOf=meneruskan penghentian dan restart ke unit-unit di bawahnya, sehinggasystemctl restart myapp.targetmenjangkau setiap unit yang menjadiPartOf=unit tersebut.Upholds=(systemd 249 dan yang lebih baru, yaitu Ubuntu 22.04 dan yang lebih baru) memastikan unit yang disebutkan tetap berjalan. Jika unit tersebut berhenti, systemd akan menjalankannya lagi. Opsi ini tetap tunduk pada batas laju start yang sama seperti unit lainnya.
Contoh worker yang tidak boleh berjalan tanpa API server dan selalu dijaga tetap aktif oleh systemd selama API aktif:
# /etc/systemd/system/myapp-api.service
[Unit]
Description=myapp API server
Wants=network-online.target
After=network-online.target
Upholds=myapp-worker.service
[Service]
Type=exec
User=myapp
ExecStart=/usr/local/bin/myapp serve
Restart=on-failure
RestartSec=5s
[Install]
WantedBy=multi-user.target# /etc/systemd/system/myapp-worker.service
[Unit]
Description=myapp background worker
BindsTo=myapp-api.service
After=myapp-api.service
StartLimitIntervalSec=120
StartLimitBurst=5
[Service]
Type=exec
User=myapp
ExecStart=/usr/local/bin/myapp worker
Restart=on-failure
RestartSec=5sWorker tidak memiliki bagian [Install] dan tidak pernah diaktifkan secara manual. Unit API memanggilnya melalui Upholds=, sehingga systemctl enable --now myapp-api.service adalah satu-satunya perintah yang perlu Anda jalankan. Muat ulang konfigurasi dan periksa hasil konfigurasi pasangan unit tersebut menurut systemd:
sudo systemctl daemon-reload
systemd-analyze verify /etc/systemd/system/myapp-worker.service
systemctl list-dependencies myapp-api.servicesystemd-analyze verify tidak menampilkan apa pun jika file sudah benar. Setiap output menunjukkan masalah, biasanya berupa key systemd yang tidak dikenali pada bagian tempat Anda menuliskannya, atau dependensi pada unit yang tidak ada.
Perbaikan dua: Type=notify, sehingga systemd mengetahui lebih dari sekadar PID
Jika program mendukung protokol notifikasi systemd, gunakan protokol tersebut. Dengan Type=notify, service memberi tahu systemd saat sudah siap. Ini membuat pengurutan startup benar-benar dapat diandalkan, bukan sekadar mengandalkan perkiraan. Service juga dapat mengirim MAINPID= untuk mengarahkan systemd ke proses yang relevan, bukan ke proses launcher.
WatchdogSec= adalah bagian yang layak diupayakan. Setelah opsi ini ditetapkan, service harus mengirim WATCHDOG=1 melalui sd_notify(3) setidaknya sesering itu. Jika pesan berhenti, systemd menghentikan service dengan SIGABRT dan menandainya sebagai gagal. Dengan demikian, Restart=on-failure atau Restart=on-watchdog dapat menjalankannya kembali. Ini adalah satu-satunya cara bawaan untuk me-restart proses yang masih hidup tetapi macet. Kebijakan status keluar tidak akan pernah dapat mendeteksi kondisi tersebut.
[Service]
Type=notify
NotifyAccess=main
ExecStart=/usr/local/bin/myapp serve
WatchdogSec=30s
Restart=on-failure
RestartSec=5sWatchdog yang terpicu muncul di journal sebagai myapp.service: Watchdog timeout (limit 30s)!, lalu diikuti oleh penghentian proses. Jika unit justru tetap berada dalam activating (start) sampai TimeoutStartSec habis, berarti READY=1 tidak pernah tiba atau tidak pernah dihitung. Kemungkinan pertama, program tidak mendukung protokol tersebut. Kemungkinan kedua, NotifyAccess=main menolak notifikasi yang dikirim dari proses anak. Journal akan mencatat kedua PID tersebut. Kemungkinan lainnya, proses helper mengirim pesan lalu keluar sebelum systemd dapat menentukan unit asalnya. Pesan terakhir itu diabaikan bahkan saat NotifyAccess=all digunakan. Perbaikannya harus dilakukan pada program: program tersebut harus memanggil sd_notify_barrier() sebelum helper keluar.
Untuk software yang menyediakan endpoint pemeriksaan kesehatan HTTP tetapi tidak mendukung sd_notify, pilihan yang tepat adalah menggunakan unit timer kecil yang memeriksa endpoint tersebut lalu memanggil systemctl restart, atau membiarkan container runtime melakukan pemeriksaan. Itulah kegunaan healthcheck Compose dan perilaku restart-nya.
Perbaikan tiga: supervisor di dalam unit, hanya jika tidak ada pilihan lain
Beberapa software memang dirilis sebagai kumpulan proses di balik launcher yang tidak dapat Anda pisahkan. Dalam kasus ini, jalankan supervisor di dalam unit dan terima konsekuensinya: systemd memantau supervisor, supervisor memantau semua proses lainnya, dan kebijakan restart kini berada di dua file.
Bentuk yang umum adalah container runtime. Unit docker compose atau podman persis menggunakan pola ini, dengan kebijakan restart untuk setiap container dinyatakan dalam file Compose, sedangkan unit systemd hanya memastikan runtime tetap berjalan. Jika struktur Anda seperti itu, unit yang menjalankan stack Compose saat boot menunjukkan versi yang berfungsi, termasuk alasan Type=oneshot dengan RemainAfterExit=yes biasanya tepat dalam kasus tersebut.
cgroup tetap bekerja untuk Anda. Semua proses yang dijalankan supervisor tetap berada di dalam cgroup unit, sehingga MemoryMax=, CPUQuota=, dan pembersihan saat dihentikan tetap mencakup seluruh hierarki proses. Hanya keputusan restart yang didelegasikan.
Apa pun supervisor yang Anda pilih, jangan menetapkan Restart=always pada unit luar dan kebijakan restart agresif di dalamnya tanpa pertimbangan. Dua lapisan logika restart, masing-masing dengan backoff sendiri, dapat membuat service terus gagal dan dimulai ulang selama beberapa menit. Journal juga tidak akan menjelaskan penyebabnya.
ExitType=cgroup bukan berarti “restart saat proses apa pun berhenti”
ExitType= (systemd 250 dan yang lebih baru, sehingga Ubuntu 24.04 dan Debian 12 sudah memilikinya) adalah pengaturan yang ditemukan orang saat mencari solusi untuk masalah ini. Namun, pengaturan tersebut justru bekerja berlawanan dengan yang disiratkan namanya. Nilai default, ExitType=main, berarti service dianggap berhenti saat proses utama keluar. ExitType=cgroup berarti service dianggap tetap berjalan sampai proses terakhir dalam cgroup keluar.
Jadi, ExitType=cgroup membuat unit lebih tidak sensitif terhadap satu proses yang berhenti, bukan lebih sensitif. Pengaturan ini tepat untuk program yang melakukan fork terhadap worker sebenarnya lalu menghentikan proses induknya tanpa menulis file PID, sehingga Type=forking tidak dapat menemukan daemon tersebut. Pengaturan ini tidak tepat untuk kegagalan yang dijelaskan di sini.
Tidak ada nilai Restart= yang berarti “restart unit saat proses apa pun dalam cgroup berhenti”. Jika memerlukan perilaku tersebut, Anda harus menggunakan satu proses untuk setiap unit. Jika program tidak dapat dipisah dan Anda mengendalikan wrapper script, pilihan yang paling mendekati adalah wait -n, yang segera mengembalikan hasil saat child pertama keluar:
#!/bin/bash
/usr/local/bin/myapp-web &
/usr/local/bin/myapp-worker &
wait -n
exit 1Jika ada child yang berhenti, wrapper kini ikut berhenti dengan status non-zero, sehingga Restart=on-failure akan bekerja. Ini adalah kompromi, bukan perbaikan. Anda tetap mendapatkan satu penghitung restart untuk dua program, satu aliran log, dan tidak memiliki cara untuk me-restart bagian yang gagal secara terpisah.
Cara memeriksa apa yang sebenarnya terjadi
Empat perintah, dalam urutan ini.
systemctl status myapp.service
systemd-cgls --unit myapp.service
systemctl show -p MainPID -p NRestarts -p Result -p ExecMainStatus myapp.service
journalctl -u myapp.service -b -o short-precisesystemctl status menampilkan status, PID utama, dan pohon cgroup dalam satu layar. Unit yang sehat menampilkan Active: active (running) dengan baris Main PID: yang mencantumkan proses yang diharapkan. Jika pohon di bagian bawah mencantumkan proses yang tidak Anda kenali, atau tidak mencantumkan proses yang Anda kenali, jawabannya sudah jelas.
systemd-cgls --unit menampilkan pohon yang sama tanpa pemotongan. Hal ini mulai penting ketika sebuah unit menjalankan lebih dari beberapa proses.
systemctl show menampilkan fakta dalam format yang dapat dibaca mesin. NRestarts= adalah penghitung restart. Ini adalah cara tercepat untuk membedakan service yang telah restart empat puluh kali dari service yang sudah berjalan sejak boot. Result= menyimpan alasan kegagalan terakhir: exit-code, signal, timeout, oom-kill, watchdog, atau start-limit-hit. ExecMainStatus= adalah status keluar mentah dari proses utama terakhir.
Journal menyimpan urutannya. Berikut tiga baris yang perlu dicari:
myapp.service: Main process exited, code=exited, status=1/FAILURE
myapp.service: Failed with result 'exit-code'.
myapp.service: Scheduled restart job, restart counter is at 1.code=exited, status=N berarti program memilih untuk mengembalikan N. Jadi, masalahnya ada pada program atau konfigurasinya. code=killed, signal=SEGV berarti program mengalami crash. code=killed, signal=TERM biasanya berarti ada sesuatu yang meminta program tersebut berhenti. Ini bukan kegagalan dan tidak akan memicu Restart=on-failure. code=dumped berarti program meninggalkan file core. File tersebut dapat ditampilkan oleh coredumpctl list jika systemd-coredump terpasang.
Untuk lebih dari satu mesin, NRestarts adalah nilai yang perlu dikumpulkan secara terjadwal. Unit yang penghitungnya meningkat setiap hari mengalami kegagalan setiap hari, meskipun tidak ada yang menyadarinya. Setelah Anda mengelola dua atau tiga server, cara konsisten menjalankan satu perintah di setiap server mengubah dugaan tersebut menjadi laporan.
FAQ
Mengapa systemctl menyatakan service saya aktif padahal prosesnya sudah berhenti?
systemd melacak satu proses untuk setiap unit service, yaitu proses utama, dan Restart= hanya membaca status keluar proses tersebut. Semua proses lain yang dijalankan unit berada dalam cgroup yang sama. systemd akan menghentikan proses-proses tersebut ketika unit berhenti, tetapi tidak pernah memantau status keluarnya. Jalankan systemctl show -p MainPID myapp.service dan bandingkan jumlahnya dengan systemd-cgls --unit myapp.service. Jika proses yang berhenti terlihat dalam tree tetapi bukan MainPID, systemd bekerja sesuai desainnya. Solusinya adalah menjalankan satu proses per unit, lalu menuliskan hubungan tersebut sebagai BindsTo= dan Upholds= antarsatuan.
Apa arti "start request repeated too quickly"?
Artinya, unit telah dijalankan lebih dari StartLimitBurst= kali dalam StartLimitIntervalSec=, yang secara default berarti 5 kali dalam 10 detik, sehingga systemd berhenti mencoba. Ini adalah batas laju. Pesan tersebut tidak menjelaskan alasan service gagal, jadi baca baris journal di atasnya. Hapus statusnya dengan systemctl reset-failed myapp.service, lalu perbaiki kegagalan dasarnya. Jika service menunggu sesuatu yang lambat aktif, naikkan RestartSec=, karena jeda default 100 milidetik menghabiskan kelima percobaan dalam waktu kurang dari satu detik.
Sebaiknya saya menggunakan Restart=always atau Restart=on-failure?
Gunakan on-failure untuk hampir semua kasus. Opsi ini me-restart service setelah crash, exit dengan kode selain 0, timeout, atau watchdog trip, tetapi membiarkan exit 0 yang disengaja. Gunakan always hanya jika program keluar secara normal karena alasan di luar kendalinya, misalnya client yang mengembalikan 0 ketika peer-nya terputus. Dampak always adalah service yang membaca konfigurasi rusak, mencatat satu error, lalu keluar dengan kode 0 akan dijalankan berulang kali. Dengan jeda default, service tersebut segera gagal dengan start-limit-hit. Dengan RestartSec= yang lebih panjang, prosesnya dapat berulang tanpa batas, sementara NRestarts terus meningkat dalam systemctl show sebagai satu-satunya gejala yang terlihat.
Mengapa menghentikan proses secara manual tidak memicu restart?
Karena, untuk setiap type selain Type=oneshot, systemd menganggap SIGHUP, SIGINT, SIGTERM, dan SIGPIPE sebagai exit normal, sedangkan perintah kill <pid> biasa mengirim SIGTERM. Dengan Restart=on-failure, exit normal bukan kegagalan, sehingga tidak ada restart. Akibatnya, konfigurasi tampak rusak padahal tidak. Uji dengan kill -9 <pid> atau systemctl kill -s SIGKILL myapp.service. Keduanya merupakan penghentian tidak normal dan akan memicu kebijakan tersebut. Aturan yang sama menjelaskan mengapa systemctl stop tidak pernah bertentangan dengan kebijakan restart Anda.
Di mana StartLimitIntervalSec dan StartLimitBurst harus ditempatkan?
Di bagian [Unit]. Materi lama dan versi systemd yang lebih lama menempatkannya di [Service], sehingga contoh yang disalin dapat saling bertentangan. Jangan menebak bagian yang digunakan oleh versi Anda. Setelah systemctl daemon-reload, tanyakan kepada systemd apa yang dimuat dengan systemctl show -p StartLimitBurst -p StartLimitIntervalUSec myapp.service, lalu anggap angka tersebut sebagai acuan yang benar. systemd-analyze verify /etc/systemd/system/myapp.service mendeteksi key yang sama sekali tidak dikenali systemd dan tidak mencetak apa pun jika file tersebut bersih.