İzleme kurulumu

Ne zaman

• deploy-ve-geri-alma ile yeni uygulama yayına girdikten sonra.
• Kullanıcı "şu servisi de izle", "şunu izlemeden çıkar" dediğinde.
• infra_health turu "açıkça yazılmış monitör/konteyner bulunamadı" anomalisi verdiğinde (ad değişmiş ya da kaynak silinmiş).
• Kullanılmaz: izlenen bir hedefin bozulması (olay-mudahalesi), dağıtım (deploy-ve-geri-alma).

Girdi

• Hedefin adı (kısa, küçük harf-tire; kullanıcının söyleyeceği ad) ve adresi.
• Coolify'daki kaynak adı ve Uptime Kuma'daki monitör adı (bilinmiyorsa sen bulursun).
• Kaldırma isteğinde: hangi ad.
• İzleme listesi nasıl çalışır (adımlardan önce bil):
  • Repodaki agents/juno.md herkes için ŞABLONDUR; içine kişisel servis adı, alan adı YAZILMAZ ve yazılması önerilmez.
  • Kuruluma özel liste veri klasöründeki agents/juno.ek.md dosyasındadır (kadro üst katmanı; kurulumdaki veri klasörünün agents/ alt klasörü). Bu dosyanın frontmatter'ında yalnız iki anahtar geçerlidir: watch: (şablondaki probe: infra_health satırının listesine eklenir) ve schedule: (takvime eklenir). Başka bir anahtar hata verir ve Juno yüklenmez.
  • Her girdi TEK bir mantıksal addır, iki yüzü vardır: site (Uptime Kuma monitörü) ve konteyner (Coolify kaynağı).
    • Düz ad site: aynı ad hem monitör hem kaynak adı olarak aranır.
    • Adlar farklıysa nesne: { name: site, container: "Coolify'daki ad" }, gerekirse monitor: "Uptime Kuma'daki ad".
    • Açıkça yazılan monitor/container bulunamazsa bu da anomalidir.
  • Bu dosyaya sen yazamazsın (memory_write vault'a yazar, veri klasörüne değil). Satırı sen hazırlarsın, kullanıcı ekler.

Adımlar

1. Konteyner yüzü: hedefin Coolify adını bul: yayını sen açtıysan coolify_create_app'te verdiğin name, değilse recall "<ad>" ya da kullanıcı. coolify_status({service: "<Coolify adı>"}) ile kaynağın var olduğunu ve çalıştığını doğrula (argümansız coolify_status() yalnız zaten izlenenleri döker, yeni kaynağı göstermez). Kaynak yoksa izlemeye alma; önce deploy-ve-geri-alma.
2. Site yüzü: uptime_status() ile monitörleri listele; hedefin monitörünü bul. Monitör yoksa Uptime Kuma'da monitör açma aracın yok: kullanıcıdan istenecekler listesine yaz (tür HTTP(s), adres https://<alt>.<alan adı>, önerilen ad = izleme adı). Sertifika süresi için HTTPS monitörü gerekir.
3. Adı seç ve eşle: kullanıcının söyleyeceği tek ad. İki yüzün adı da bununla aynıysa düz ad; farklıysa container:/monitor: ile eşle. Ad tahmini yapma; 1–2. adımda gördüğün adları birebir kullan.
4. Satırı hazırla. Dosyada watch: zaten varsa yalnız yeni madde eklenir; yoksa frontmatter bloğuyla birlikte. Örnek (adlar yer tutucudur; gerçek adları 1–2. adımdan koy):
   Kopyala

   ---
   watch:
     - site
     - { name: api, container: "API Servisi", monitor: "API" }
   ---
   

   Dosyanın gövdesi (frontmatter'ın altı) Juno'ya kuruluma özel not olarak eklenir; alan adı gibi kişisel bilgi oraya yazılabilir. schedule: ve watch: dışında frontmatter anahtarı ekleme.
5. Kullanıcıya gönder: send_message({to: "user", body}) ile hazır satırı, dosyanın yerini (veri klasörü → agents/juno.ek.md; yoksa oluşturulur) ve varsa Uptime Kuma'da açılacak monitörü yaz. Repodaki agents/juno.md'yi düzenlemesini ÖNERME.
6. Kaldırma: aynı yoldan; kullanıcıya silinecek satırı yaz. Coolify'da kaynağı silmek senin işin değil.
7. Doğrula: kullanıcı "ekledim" dedikten sonraki ilk infra_health turunda (en çok 15 dk) hedef bulgularda görünüyor mu bak; ayrıca uptime_status({monitor: "<ad>"}) ve coolify_status({service: "<ad>"}) ile izleme adıyla iki yüzün de çözüldüğünü doğrula. "bulunamadı" anomalisi gelirse adı 1–2. adımdaki listelerle karşılaştır ve düzeltilmiş satırı gönder.
8. Not: vault kişiseldir, oraya yazabilirsin: memory_write({path: "infra/izleme.md", content, mode: "append"}) — ad, Coolify adı, monitör adı, adres, eklenme tarihi. Günlüğe tek satır (journal).
9. Görev bağlıysa update_task ile kanıt (vault notu yolu).

Kontrol listesi

• Konteyner coolify_status'ta, monitör uptime_status'ta görüldü ya da eksik diye kullanıcıya yazıldı.
• Adlar listelerden birebir alındı; farklı olanlar container:/monitor: ile eşlendi.
• Hazırlanan frontmatter'da yalnız watch: (ve gerekirse schedule:) var.
• Repodaki şablon ajan dosyasına kişisel ad yazılması önerilmedi.
• İlk turdan sonra iki yüz de izleme adıyla doğrulandı.
• infra/izleme.md güncellendi.

Çıktı

Kullanıcıya mesaj:

<ad> izlemeye hazır. Veri klasöründeki agents/juno.ek.md dosyasına ekle (yoksa oluştur):

```yaml
---
watch:
  - { name: <ad>, container: "<Coolify adı>" }
---
```

- Konteyner: <Coolify adı> · <çalışıyor>
- Site: <monitör adı | Uptime Kuma'da yok: HTTP(s) monitörü aç, adres https://<adres>, ad <ad>>
Ekleyince söyle; ilk turda iki yüzü de kontrol edeceğim.

Bitti sayılır

• Kullanıcıya doğru satır ve dosya yeri gitti; eksik monitör belirtildi.
• Eklendikten sonra hedef izleme adıyla iki yüzden de çözülüyor; infra/izleme.md güncel.