Lewati ke konten
AbyfineIntermedia
Hosting & Server

Cron Job Andal: Jadwal, Lock, Log, dan Alert

Cron yang andal bukan sekadar jadwal: kenali perbedaan lingkungan, pasang lock, tulis log yang terbaca, dan kirim alert saat job benar-benar gagal.

A4 menit baca
Bagikan
Ilustrasi artikel: Cron Job Andal: Jadwal, Lock, Log, dan Alert

Skrip yang berjalan sempurna saat dijalankan manual sering gagal begitu dipindahkan ke cron. Penyebabnya jarang dramatis: lingkungan yang berbeda, folder kerja yang tidak sesuai, atau dua jadwal yang ternyata bertumpuk.

Cron memang sederhana, tetapi justru kesederhanaannya membuat kesalahan sulit terlihat. Tidak ada yang memberi tahu kecuali kita sengaja merancangnya.

Yang perlu diingat

  • Cron tidak mewarisi PATH dan variabel shell seperti terminal interaktif.
  • Gunakan flock dan timeout agar job tidak saling menimpa atau macet selamanya.
  • Job penting butuh heartbeat, bukan hanya notifikasi saat exit code gagal.

Skrip yang berjalan sempurna saat dijalankan manual sering gagal begitu dipindahkan ke cron. Penyebabnya jarang dramatis: lingkungan yang berbeda, folder kerja yang tidak sesuai, atau dua jadwal yang ternyata bertumpuk.

Cron memang sederhana, tetapi justru kesederhanaannya membuat kesalahan sulit terlihat. Tidak ada yang memberi tahu kecuali kita sengaja merancangnya.

Lingkungan cron berbeda dari terminal

Saat login, shell memuat PATH, variabel, dan alias dari profil pengguna. Cron tidak melakukan itu. Perintah yang tersedia di terminal bisa berakhir dengan “command not found” karena PATH hanya berisi direktori dasar.

Tulis path absolut untuk perintah dan file, atau definisikan PATH di awal crontab. Setel juga MAILTO bila ingin menerima keluaran, dan ingat bahwa zona waktu cron mengikuti sistem, bukan zona waktu pribadi. Untuk pekerjaan yang sensitif terhadap jam, simpan konversi waktunya di komentar agar tidak salah saat tim berada di zona berbeda.

Di sistem modern, banyak pekerjaan terjadwal lebih rapi dijalankan sebagai unit systemd timer. Keuntungannya, dependensi, batas resource, dan log terintegrasi. Namun cron tetap berguna untuk skrip sederhana dan lingkungan yang sudah terbiasa. Pilih satu pendekatan per pekerjaan agar tidak ada dua penjadwal yang menjalankan hal sama.

Satu pekerjaan, satu kunci

Masalah klasik adalah job yang berjalan lebih lama dari intervalnya. Jika job pertama belum selesai, job kedua mulai, lalu keduanya berebut file atau baris database yang sama. Gejalanya bisa berupa duplikasi data, file rusak, atau beban yang tiba-tiba melonjak.

Gunakan flock agar hanya satu instans berjalan. Jika kunci masih dipegang, proses baru langsung keluar dengan rapi. Tambahkan juga batas waktu, misalnya dengan timeout, supaya job yang macet tidak menahan kunci selamanya.

Log yang bisa dibaca manusia

Keluaran cron yang dikirim lewat email jarang dibaca sampai ada masalah. Lebih baik arahkan keluaran ke file log dengan penanda waktu dan status akhir. Satu baris ringkas per eksekusi sudah cukup: kapan mulai, berapa lama, dan berhasil atau gagal.

Hindari menulis log yang tidak terbatas. Gunakan rotasi atau tulis ke file terpisah per job. Saat menelusuri kegagalan, kita ingin melihat konteks, bukan menebak dari pesan “exit code 1”.

Memberi tahu saat gagal

Job yang gagal diam-diam lebih berbahaya daripada job yang tidak pernah dibuat, karena orang mengira data sudah diperbarui. Bungkus perintah dalam skrip kecil yang memeriksa exit code, lalu kirim notifikasi ke email atau kanal tim hanya ketika gagal.

Untuk job penting, tambahkan heartbeat. Skrip menulis tanda “selesai” ke file atau endpoint setiap kali berhasil. Pemantau terpisah memeriksa apakah tanda itu masih segar. Dengan cara ini, job yang tidak berjalan sama sekali juga terdeteksi, bukan hanya job yang mengembalikan error.

Beri nama job yang menjelaskan tujuan, bukan sekadar nama skrip. Pesan alert sebaiknya menyebut apa yang gagal dan dampaknya, misalnya “sinkronisasi stok gagal, data pesanan bisa tertinggal”. Informasi ini mempercepat keputusan tanpa harus membuka kode.

Contoh struktur yang rapi

#!/bin/sh
set -eu
LOG=/var/log/jobs/sinkron.log
echo "$(date -Is) mulai" >> "$LOG"
if timeout 600 /usr/bin/flock -n /run/sinkron.lock \
    /usr/local/bin/sinkron --quiet >> "$LOG" 2>&1; then
    echo "$(date -Is) sukses" >> "$LOG"
else
    kode=$?
    echo "$(date -Is) gagal kode=$kode" >> "$LOG"
    /usr/local/bin/kirim-alert "Sinkron gagal kode=$kode" || true
fi

Skrip seperti ini memisahkan tiga hal: penjadwalan, eksekusi, dan pemberitahuan. Crontab cukup memanggil skrip tersebut, sehingga perubahan logika tidak perlu mengubah jadwal.

Audit jadwal secara berkala

Seiring waktu, crontab cenderung menumpuk. Job lama yang sudah tidak relevan tetap berjalan, kadang menabrak job baru. Setiap beberapa bulan, buka daftar job, catat pemilik dan tujuannya, lalu hapus yang tidak lagi dipakai.

Simpan crontab di repositori atau salinan yang bisa dibaca. Perubahan langsung di server sulit dilacak, terutama bila ada beberapa admin. Catat juga job yang dinonaktifkan sementara, supaya tidak lupa mengaktifkannya kembali.

Dokumentasikan jadwal di tempat yang bisa dibaca tim, bukan hanya di dalam server. Cron yang andal bukan yang paling banyak fiturnya, melainkan yang kegagalannya cepat diketahui dan mudah ditelusuri.

Layanan yang berkaitan

Jika Anda ingin menerapkan panduan ini tanpa mengerjakan sendiri, tim Abyfine bisa membantu.

cronotomasilinuxmonitoring
Bagikan
Kembali ke blog
A
Tim Abyfine

Tim teknis Abyfine Intermedia di Cilacap. Kami membangun dan merawat website, server, serta jaringan untuk sekolah, UMKM, dan instansi sejak 2004.

Baca juga

Artikel terkait

Masih seputar hosting & server.

Semua artikel

Lanjutkan dari sini

Panduan sudah dibaca. Sekarang waktunya diterapkan.

Ceritakan kondisi server, jaringan, atau website Anda. Kami bantu susun langkah yang realistis tanpa membeli perangkat berlebihan.