Rule Library
Bu sayfa geliştirilmektedir.
Ekran görüntüleri ve ayrıntılı yapılandırma seçenekleri yakında eklenecektir.
Rule Library, otomasyon kurallarının oluşturulduğu ve yönetildiği ekrandır. Her kural; bir veri kaynağı sorgusuna, bir koşul ifadesine ve bir aksiyona bağlıdır.
Ön Koşul
Kural tanımlamak için önce Port modülünde veri kaynağı, ardından Compass modülünde sorgu oluşturulmuş olmalıdır. Tetikleyici bölümünde bu Compass kaydını seçersiniz.
Kural Bileşenleri
| Bileşen | Açıklama |
|---|---|
| Tetikleyici (Trigger) | Hangi veri kaynağı veya Compass sorgusu izlenecek |
| Koşul (Condition) | Hangi değer veya durum geçişinde kural devreye girecek |
| Aksiyon (Action) | Tetiklendiğinde ne yapılacak (Alert Center kaydı, webhook, e-posta) |
| Öncelik (Priority) | Kritik / Yüksek / Orta / Düşük |
| Durum (Status) | Aktif / Pasif — kuralı devre dışı bırakmadan askıya alır |
Kural Oluşturma
- Sol menüden Automation → Rule Library sayfasına girin.
- Add New Rule butonuna tıklayın.
- Tetikleyici bölümünde veri kaynağı ve ilgili Compass sorgusunu seçin.
- Koşul bölümünde eşik değerini veya durum ifadesini tanımlayın (örn.
value > 95). - Aksiyon bölümünde tetiklendiğinde ne yapılacağını belirleyin.
- Öncelik ve açıklama girin; Kaydet butonuna tıklayın.
Koşul Sözdizimi
Koşullar JavaScript benzeri ifadelerle yazılır (Goja motoru):
| Örnek | Anlamı |
|---|---|
value > 95 |
Değer 95'i geçtiğinde |
value < 10 \|\| value > 90 |
Değer aralık dışına çıktığında |
value >= threshold && status !== 'maintenance' |
Bakımda değilken eşik aşıldığında |
status === 'stopped' |
Durum "durduruldu" olduğunda |
Aksiyon Yapılandırması
Alert Center Kaydı (Varsayılan)
Aksiyon olarak Alert Center seçildiğinde, kural tetiklendiğinde Alert Center'da otomatik bir kayıt oluşur. Kayıt; kural adı, öncelik, tetiklenme zamanı ve o anki değeri içerir.
Webhook
- Aksiyon bölümünde Webhook seçin.
- Hedef URL'yi girin (örn.
https://hooks.example.com/alert). - İsteğe bağlı: HTTP başlıkları ve payload şablonu ekleyin.
- Pirivision, kural tetiklendiğinde bu URL'ye POST isteği gönderir.
Payload
Gönderilen JSON gövdesi kural adı, tetiklenme zamanı, değer ve önceliği içerir.
E-posta Bildirimi
- Aksiyon bölümünde E-posta seçin.
- Alıcı e-posta adreslerini girin (virgülle ayırın).
- Konu satırını özelleştirin.
- Kural tetiklendiğinde tanımlı adreslere bildirim maili gider.
SMTP Ayarı
E-posta aksiyonu için Docker Compose ortamında SMTP yapılandırmasının tamamlanmış olması gerekir.
Kural Yönetimi
| İşlem | Açıklama |
|---|---|
| Düzenle | Kuralın herhangi bir bileşenini güncelle |
| Aktif / Pasif | Toggle ile kuralı geçici olarak durdur |
| Sil | Kuralı kalıcı olarak kaldır |
| Test Et | Mevcut veriyle koşulu manuel tetikle ve sonucu gör |
Sonraki Adım
→ Alert Center — Uyarı Yönetimi → Automation Genel Bakış → Horizon — İzleme Paneli → Atlas — Gelişmiş Dashboard
Sık Yapılan Hatalar
| Hata | Neden Olur | Çözüm |
|---|---|---|
| Kural hiç tetiklenmiyor | Compass sorgusu boş veri döndürüyor | Compass'ta sorguyu test edin; veri var mı kontrol edin |
| Kural sürekli tetikleniyor | Koşul her veri güncellemesinde doğru | Koşula zaman aralığı veya debounce süresi ekleyin |
| Webhook başarısız | Hedef URL erişilemiyor | URL'nin Docker ağından erişilebilir olduğunu doğrulayın |
| E-posta gelmiyor | SMTP yapılandırması eksik | dev/.env içindeki SMTP değişkenlerini kontrol edin |