Heartbeat / Cron izleme

Heartbeat monitörü, düzenli çalışması gereken işlerin (yedekleme, fatura üretimi, veri senkronizasyonu vb.) gerçekten çalıştığını izler. İşiniz her başarılı çalışmasının sonunda size özel adrese bir istek gönderir; beklenen sürede istek gelmezse kesinti açılır ve bildirim gönderilir.

Ping adresi

Heartbeat monitörü oluşturduğunuzda aşağıdaki biçimde gizli bir adres üretilir:

https://isletme.net.tr/hb/hb_<40 karakterlik anahtar>

• Adres yalnızca oluşturulduğu anda tam olarak gösterilir; sistemde anahtarın yalnızca SHA-256 özeti saklanır. Kaybederseniz panelden yeni anahtar üretin (eski adres geçersiz olur).
• GET, POST ve HEAD yöntemleri kabul edilir. İstek gövdesi okunmaz.
• Başarılı yanıt {"ok":true}; monitör duraklatılmışsa {"ok":true,"paused":true}; bilinmeyen adres için 404 ve {"ok":false} döner.
• Aynı saniye içinde gelen ikinci ping yeni ölçüm oluşturmaz. Adres başına dakikada 30 istek sınırı vardır.

Zamanlama ve tolerans

Her ping'ten sonra bir sonraki ping için süre kontrol aralığı + tolerans süresi olarak hesaplanır. Tolerans süresi varsayılan olarak aralığın %20'si, en az 60 saniyedir ve 30 saniye ile 24 saat arasında ayarlanabilir. Bu süre içinde ping gelmezse “beklenen süre içinde heartbeat pingi alınmadı” sonucu kaydedilir. Heartbeat monitörlerinde ardışık hata eşiği varsayılan olarak 1'dir; yani tek bir kaçırılan ping kesinti açar.

Kesinti sonrası ilk başarılı ping'le birlikte düzelme süreci başlar (ardışık başarı eşiği kadar ping gerekir).

Örnekler

crontab

0 3 * * * /usr/local/bin/yedek-al.sh && curl -fsS -m 10 --retry 3 https://isletme.net.tr/hb/hb_XXXXXXXX > /dev/null

&& sayesinde ping yalnızca komut başarılı bittiğinde gönderilir.

systemd zamanlayıcısı

[Service]
Type=oneshot
ExecStart=/usr/local/bin/senkronize-et
ExecStartPost=/usr/bin/curl -fsS -m 10 https://isletme.net.tr/hb/hb_XXXXXXXX

PHP

file_get_contents('https://isletme.net.tr/hb/hb_XXXXXXXX');

PowerShell

Invoke-RestMethod -Uri "https://isletme.net.tr/hb/hb_XXXXXXXX" -Method Post -TimeoutSec 10

İpuçları

• Kontrol aralığını işin çalışma sıklığıyla aynı seçin; işin süresi değişkense toleransı artırın.
• Ping adresini gizli tutun: adresi bilen herkes “çalıştı” sinyali gönderebilir.
• Heartbeat hedef doğrulaması gerektirmez, çünkü platform sisteminize bağlanmaz.