Görev Hata Yönetimi: Otomasyon Hatalarını Hızla Çözün

Otomasyon görevleri çoğu zaman sessizce çalışır; fark edilmeleri genellikle bir şey ters gittiğinde olur. Bu yazıda LLCBullet'te bir görev çalıştırmasının hangi durumlardan geçtiğini, hata olduğunda sistemin ne yaptığını ve sık görülen hataları nasıl çözeceğini anlatıyoruz. Görev kurulumunun temelleri için önce site erişilebilirlik kontrolü rehberine göz atabilirsin.

Önce ayrımı yap: görev hatası mı, site sorunu mu?

Bir site kontrolü görevi erişilemeyen site bulduğunda görevin kendisi başarısız olmaz; görev işini yapmış ve sorunu tespit etmiştir. Bu durumda "Erişilemeyen site" bildirimi gelir ve çalıştırma sonucunda erişilemeyen site sayısı görünür. Görev hatası ise çalıştırmanın kendisinin tamamlanamamasıdır: zaman aşımı, webhook adresinin hata dönmesi ya da görevin çalışma koşullarının sağlanmaması gibi. Bu yazı ikinci duruma odaklanıyor.

Çalıştırma durumları

• Kuyrukta: Zamanı gelmiş ya da elle tetiklenmiş, işlenmeyi bekliyor.
• Çalışıyor: Şu anda yürütülüyor.
• Başarılı: Tamamlandı; sonuç ayrıntıları çalıştırma geçmişinde.
• Başarısız: Tüm denemeler tükendi ve çalıştırma tamamlanamadı.
• Atlandı: Çalışma koşulları sağlanmadığı için yürütülmedi; neden sonuçta yazar.
• İptal edildi: Örneğin Tümünü duraklat seçeneğiyle kuyruktaki çalıştırmalar iptal edildiğinde.

Hata olduğunda sistem ne yapar?

Bir çalıştırma hata verirse hemen başarısız sayılmaz. Görev ayarlarındaki en fazla deneme sayısına (1 ile 10 arası, varsayılan 3; ilk deneme dahil) ulaşılana kadar yeniden denenir. Denemeler arasındaki bekleme yaklaşık yarım dakikayla başlar ve her denemede katlanarak artar; böylece geçici bir ağ sorunu kendiliğinden düzelme fırsatı bulur. Tüm denemeler başarısız olursa çalıştırma Başarısız durumuna geçer ve "Otomasyon görevi başarısız" bildirimi gönderilir.

Her denemenin bir süre sınırı vardır. Görev ayarlarındaki zaman aşımı 5 ile 120 saniye arasında seçilebilir, varsayılanı 30 saniyedir. Süre dolarsa deneme "Görev zaman aşımına uğradı" hatasıyla sonlanır ve kalan deneme hakkı varsa yeniden denenir.

Sık görülen nedenler ve çözümler

Atlanan çalıştırmalar

• "Bu altyapı için aktif paket yok": Görevin bağlı olduğu altyapının paketi sona ermiş. Paketini yenilediğinde görev sonraki zamanlamada yeniden çalışır.
• "Altyapı bakımda": Bakım süresince görevler bilinçli olarak çalıştırılmaz ve bakım bitince devam eder. Ayrıntılar bakım rehberinde.

Webhook hataları

• 2xx dışında yanıt: Teslimat yalnızca 2xx kodlarla başarılı sayılır. Hata mesajı karşı tarafın döndüğü HTTP kodunu içerir; 401 çoğu zaman imza doğrulamasının tutmadığını, 404 yanlış yolu, 5xx ise alıcı sunucudaki bir hatayı gösterir.
• Zaman aşımı: İstek başına bekleme en fazla 30 saniyedir. Alıcı tarafta isteği kuyruğa alıp hemen 200 dönmek bu sorunu çözer.
• Yönlendirme: Yönlendirmeler izlenmez. Adres başka bir adrese yönlendiriyorsa görevde doğrudan son adresi kullan.
• Özel ağ adresi: Yerel ya da özel ağ adreslerine çözülen alan adları reddedilir; webhook adresi herkese açık bir HTTPS adresi olmalıdır.

Site kontrolü hataları

• Çok sayıda sitenin kontrolü zaman aşımı süresi içinde bitmiyorsa görevin zaman aşımını artır ya da siteleri iki göreve böl; bir görev en fazla 50 site kontrol eder.
• Bir site sürekli erişilemez görünüyorsa sorun gerçekten sitede olabilir. Kendi yönettiğin bir sitede güvenlik duvarı izleme isteklerini engelliyorsa LLCBulletMonitor/1.0 kullanıcı ajanına izin vermek yanlış alarmları azaltabilir.

Adım adım sorun giderme

1. Otomasyon sayfasında görevi aç ve çalıştırma geçmişinde başarısız ya da atlanan satırı bul.
2. Hata ya da atlanma nedenini oku; webhook hatalarında HTTP kodunu not et.
3. Nedeni düzelt: paketi yenile, webhook adresini güncelle, zaman aşımını ya da site sayısını ayarla.
4. Zamanlamayı beklemeden görevi elle çalıştırarak düzeltmeyi test et.
5. Aynı sorun başka görevlerde de varsa Denetim kaydı sekmesinde yakın zamanda yapılan değişikliklere bak.

Webhook alıcını test ederken imza doğrulamasının gerçekten çalıştığını da kontrol et. İmza başlığı olmayan bir istek gönderdiğinde alıcının 401 dönmesi gerekir:

curl -i -X POST https://ornek.com/llcbullet-webhook \
  -H "Content-Type: application/json" \
  -d '{"type":"automation.webhook"}'

# Beklenen yanıt kodu: 401 (X-LLCBullet-Signature başlığı yok)

Bu istek 200 dönüyorsa alıcın imzayı doğrulamıyor demektir; bu hem güvenlik açığıdır hem de sahte isteklerin verini bozmasına yol açar. Doğru uygulama için webhook imza doğrulama rehberine bak.

Bildirim gelmiyorsa

Bazen görev doğru çalışır ama beklediğin bildirim gelmez. Bu durumda sırasıyla şunları kontrol et:

• Ayarlar sayfasında Otomasyon kategorisinin Telegram kanalı açık mı, kategori geçici olarak sessize alınmış mı?
• Site kontrolü görevinde erişilemeyen site bildirimi seçeneği açık mı?
• Telegram'da LLCBullet botunu engellemedin ya da sohbeti silmedin mi?
• Tarayıcı bildirimleri için izin verildi mi? Ayarlar sayfasından test bildirimi göndererek kontrol edebilirsin.

Kanal ayarları doğruysa, Telegram'a giden bildirimlerin bir kopyası panelin Bildirimler sayfasında da saklandığı için oradan kaçırdığın uyarıları görebilirsin.

Önleme için alışkanlıklar

• Yeni bir görevi kaydettikten sonra bir kez elle çalıştır ve sonucu kontrol et.
• Otomasyon bildirim kategorisini Telegram'da açık tut; başarısız görev bildirimini kaçırma.
• Kendi tarafındaki bakım ya da yoğun değişiklik dönemlerinde Tümünü duraklat seçeneğini kullan; kapattığında görevler kaldıkları yerden devam eder.
• Görev adlarını anlaşılır tut; bildirimlerde görev adı görünür ve hangi görevin sorun çıkardığını hemen anlarsın.

Sorun devam ederse Telegram'da /destek yazarak ya da panelden talep açarak görev adını, başarısız çalıştırmanın zamanını ve hata mesajını paylaş.

Otomasyon sayfasını aç