Home Assistant otomasyonu çalışmıyor: İzler ve günlüklerle adım adım teşhis

Bir ışık, kilit, bildirim veya sensör otomasyonu elle çalıştırıldığında görevini yapabilir; fakat gerçek olayda hiç tetiklenmeyebilir. Bazen otomasyon tetiklenir ancak koşulda durur, yanlış varlığa eylem gönderir veya önceki çalışma bitmediği için yeni tetikleme çalışma moduna takılır. Home Assistant’ın İzler özelliği, tahmin etmek yerine son çalışmanın hangi adımda durduğunu gösterir.

Kısa yanıt: Önce hedef cihazı otomasyondan bağımsız olarak panelden çalıştırın. Otomasyonun etkin olduğunu doğrulayın, “Eylemleri çalıştır” ile yalnızca eylemi test edin; bunun tetikleyiciyi kanıtlamadığını unutmayın. Ardından gerçek olayı oluşturup Ayarlar > Otomasyonlar ve sahneler > otomasyon > İzler bölümünde tetikleyici, koşul ve eylem sonucunu inceleyin.

1. Cihazı otomasyondan ayırarak test edin

1. Otomasyonun kontrol ettiği ışık, anahtar, kilit veya bildirimi doğrudan Home Assistant arayüzünden çalıştırın.
2. Varlık unavailable veya unknown durumundaysa önce entegrasyon ve ağ sorununu çözün.
3. Geliştirici Araçları’nda varlığın tam entity_id değerini ve beklenen durumunu doğrulayın.
4. Fiziksel cihazı ve Home Assistant durumunu karşılaştırın; durum güncellenmiyorsa otomasyon doğru karar veremez.

Güvenlik: Kilit, vana, garaj kapısı, ısıtma veya yüksek güçlü rölelerde “Eylemleri çalıştır” düğmesine basmadan önce gerçek dünyadaki sonucu düşünün. Test için mümkünse lamba veya bildirim gibi düşük riskli hedef kullanın.

2. Otomasyonun etkin ve kaydedilmiş olduğunu doğrulayın

Ayarlar > Otomasyonlar ve sahneler bölümünde otomasyonun anahtarının açık olduğunu kontrol edin. Düzenlediğiniz değişikliklerin kaydedildiğinden ve yapılandırma yeniden yükleme gerektiriyorsa tamamlandığından emin olun.

YAML otomasyonu kullanıyorsanız biçim ve girinti hataları için yapılandırmayı kontrol edin. Resmî Home Assistant belgesine göre YAML otomasyonuna benzersiz id eklemek, arayüzden düzenleme ve debug izlerinin kullanılmasını sağlar.

3. “Eylemleri çalıştır” testini doğru yorumlayın

Otomasyonu elle “Eylemleri çalıştır” ile başlatmak, tetikleyici ve bazı üst düzey koşulları atlayarak eylem dizisini sınamanızı sağlar. Işık yanıyorsa eylem hedefi büyük olasılıkla doğrudur; fakat zaman, bölge, cihaz veya durum tetikleyicisinin çalıştığı kanıtlanmış olmaz.

4. Gerçek olayı oluşturup İzler ekranını açın

1. Otomasyonu açın ve üç nokta menüsünden İzler seçeneğine gidin.
2. Son iz zamanının beklediğiniz olayla eşleşip eşleşmediğini kontrol edin.
3. Adım görünümünde tetikleyici, koşul ve eylemleri sırayla açın.
4. “false” dönen koşulun o andaki varlık değerini ve şablon sonucunu inceleyin.
5. Hata veren eylemde yanlış varlık adı, kullanılamayan entegrasyon veya eksik parametre olup olmadığını kontrol edin.

Home Assistant çalıştırılan adımları iz kaydına alır. İz oluşmuşsa otomasyon en azından bir çalıştırma başlatmıştır; nerede durduğunu doğrudan bu kayıt üzerinden belirlemek rastgele ayar değiştirmekten daha güvenlidir.

5. Tetikleyici ayrıntılarını doğrulayın

Durum tetikleyicisi

from ve to değerlerinin gerçek durum dizeleriyle aynı olduğundan emin olun. Görselde “Evde” yazan bir kişi varlığının gerçek durumu home olabilir. Geliştirici Araçları’ndan ham durumu kontrol edin.

Süre şartı

“5 dakika boyunca” gibi for kullanılıyorsa varlığın bu süre boyunca kesintisiz aynı durumda kalması gerekir. Home Assistant yeniden başlarsa süre sayacı etkilenebilir.

Zaman ve güneş

Sistem saat dilimi, konum ve gün doğumu/gün batımı ayarlarını kontrol edin. Test için zamanı değiştirmek yerine kısa süreli ve güvenli ayrı test otomasyonu oluşturmak daha nettir.

Bölge ve kişi

Kişinin bağlı olduğu cihaz takipçisi, GPS izni ve son güncelleme zamanını kontrol edin. Bölge tetikleyicisi için yalnızca person varlığının son durumuna bakmak bazen yetersizdir; kaynak takipçileri ve Companion App günlükleri ayrıca incelenmelidir.

6. Koşulların otomasyonu durdurabileceğini unutmayın

Home Assistant’ta koşul doğruysa yürütme devam eder; yanlışsa otomasyon o noktada durur. Birden fazla koşulda AND/OR grubunun yapısını kontrol edin. Sayısal durum koşulunda sensörün birimiyle birlikte ham değerinin sayı olup olmadığını doğrulayın.

Şablon koşullarını Geliştirici Araçları > Şablon bölümünde örnek durumlarla değerlendirin. Parola, erişim anahtarı veya gizli URL gibi bilgileri izlere yazdırmayın; resmî belgeler YAML içindeki gizli değerlerin yönetici arayüzü ve iz görüntüleyicide görünebileceğini belirtir.

7. Çalışma modunu kontrol edin

Otomasyon modları, yeni tetikleme geldiğinde önceki çalışma hâlâ sürüyorsa ne olacağını belirler:

• single: Önceki çalışma bitmediyse yenisi başlatılmaz.
• restart: Önceki çalışma durdurulur, yenisi başlar.
• queued: Tetiklemeler sıraya alınır.
• parallel: Birden fazla çalışma eşzamanlı yürür.

Gecikme içeren otomasyonda single modu “bazen çalışmıyor” izlenimi verebilir. Ancak kilit veya vana gibi kritik eylemlerde modu düşünmeden parallel yapmak yarış durumları oluşturabilir. Senaryonun güvenli davranışını belirleyerek seçim yapın.

8. Günlükleri ve yapılandırmayı inceleyin

Ayarlar > Sistem > Günlükler bölümünde otomasyonun çalıştığı saate denk gelen entegrasyon veya servis hatalarını arayın. YAML değişikliğinden sonra yeniden başlatmadan önce yapılandırma kontrolünü kullanın. Hata metnini ararken erişim anahtarı, dış URL veya özel konum bilgilerini paylaşmayın.

Çözüm işe yaramazsa sonraki adımlar

• Otomasyonu tetikleyici, tek koşul ve tek bildirim eylemine kadar geçici bir kopyada sadeleştirin; çalışan noktadan adımları birer birer ekleyin.
• İz kaydını dışa aktarırken gizli alanları temizleyin ve Home Assistant sürümünü, entegrasyon adını ve varlık durumlarını ekleyin.
• Companion App konum tetikleyicisinde uygulamanın Konum İzleme günlüklerini kullanın.
• Canlı kilit/vanayı tekrar tekrar denemek yerine bildirim hedefiyle teşhis yapın; sorun çözülünce gerçek eylemi kontrollü biçimde geri ekleyin.

Sık sorulan sorular

“Eylemleri çalıştır” başarılıysa otomasyon tamamen doğru mudur?

Hayır. Bu test eylem dizisini doğrular; gerçek tetikleyici ve koşulların geçtiğini kanıtlamaz.

İz kaydı neden görünmüyor?

Otomasyon hiç tetiklenmemiş, devre dışı veya YAML otomasyonunda benzersiz id eksik olabilir.

Otomasyon modunu parallel yapmak sorunu çözer mi?

Her zaman değil. Eşzamanlı çalışmalar çakışabilir. Gecikme ve tekrar davranışına göre single, restart, queued veya parallel bilinçli seçilmelidir.

İlginizi çekebilir

Home Assistant nedir? Akıllı eve ilk adım ve ilk otomasyon — otomasyon kavramına yeni başlayanlar için temel rehber.

Kaynaklar

• Home Assistant — Testing and troubleshooting automations
• Home Assistant — Automations in YAML
• Home Assistant — Conditions
• Home Assistant — Automation modes