Uyarılar

​

Konseptler

• Uyarı — kural. Ne kontrol edileceğini (tetikleyici), ne sıklıkta (değerlendirme aralığı), ne zaman kırılmış sayılacağını (bileşik mantık), ne kadar acil olduğunu (önem) ve kime/nereye bildirileceğini (kanallar) belirtir.
• Olay — bir uyarı tetiklendiğinde ne olur. Bir uyarının aynı anda en fazla bir açık olayı vardır. Tekrarlanan ihlaller aynı olayın kanıtını günceller. Olaylar bir operatör tarafından çözülür; kural tetiklemeyi durdurduğunda otomatik çözümleme planlanmıştır ancak şu anda etkinleştirilmemiştir.
• Kanal — bir bildirimin gittiği yer: e-posta, Slack, genel webhook veya panoda. Her uyarı herhangi bir kombinasyon ekleyebilir.

​

Tetikleme türleri

​

1. metric_threshold

{
  "metric": "p95_latency_ms",
  "filter": { "environment": "production" },
  "window_secs": 900,
  "op": ">",
  "value": 5000
}

​

2. custom_sql

• satırlar modu (no op/value): sorgu en az bir satır döndürür döndürmez uyarı tetiklenir.
• değer modu: sorgu bir sütunu metric_value olarak takma ad oluşturmalıdır; işlemci ilk satırın metric_valuesini op kullanarak valuea karşılaştırır.

{
  "sql": "SELECT count() AS metric_value FROM agenteye.events WHERE event_type = 'error' AND ts >= now() - INTERVAL 1 HOUR",
  "op": ">",
  "value": 100
}

​

3. evaluation_score

{
  "score_key": "hallucination",
  "op": ">",
  "value": 0.6,
  "window_secs": 3600,
  "min_count": 5,
  "environment": "production"
}

​

4. eval_compound

{
  "combinator": { "at_least": 2 },
  "conditions": [
    { "score_key": "hallucination", "op": ">", "value": 0.8 },
    { "score_key": "helpfulness",   "op": "<", "value": 0.6 },
    { "score_key": "tone",          "op": "<", "value": 0.5 }
  ],
  "window_secs": 3600,
  "min_count": 5,
  "environment": "production"
}

• combinator: "any", "all" veya { "at_least": N }.
• conditions[]: her { score_key, op, value }, diğer tetikleyicilerle aynı operatörleri kullanarak (>, >=, <, <=, ==).
• window_secs: her koşula uygulanan paylaşılan geri izleme (varsayılan 3600).
• min_count: o koşul ihlal edilmeden önce koşul başına minimum değerlendirme sayısı; pencerede çok az örneği olan bir koşul “ihlal edilmedi” olarak sayılır (varsayılan 1).
• environment: isteğe bağlı; her koşulu bir ortama kısıtlar.

​

5. per_event

{
  "event_type": "error",
  "lookback_secs": 60,
  "environment": "production",
  "tool_name": "bash",
  "agent_id": "caa",
  "error_type": "TimeoutError",
  "message_contains": "vertex-ai timed out"
}

​

Bileşik mantık (N içinden M)

• eval_window: kaç son değerlendirmeye bakılacağı (varsayılan 1)
• min_breaches: uyarı tetiklenmeden önce kaç tanesinin ihlal edilmesi gerektiği (varsayılan 1)

​

Değerlendirme aralığı

​

Kanallar

​

E-posta

1. Kanala özgü recipients[] geçersiz kılması (boş olmadığında).
2. alerts.email_default_recipients ayarı (e-posta dizelerinin bir dizisi).

​

Slack

• Varsayılan URL: alerts.slack_default_webhook (/settings içinde ayarlanır).
• Uyarı başına geçersiz kılma: kanalın webhook_setting_keysini başka herhangi bir URL türü ayar anahtarına ayarlayın, örneğin alerts.slack_oncall, alerts.slack_costs.

​

Genel webhook

{
  "schema_version": 1,
  "event": "alert.firing",
  "incident": { "id": "uuid", "url": "https://…/incidents/uuid", "opened_at": "2026-…" },
  "alert":    { "id": "uuid", "name": "errors > 50/hr", "severity": "critical" },
  "breach":   { "value": 73.0, "summary": "ErrorCount > 50 (observed 73.000)", "evidence": { … } }
}

​

Panodaki

​

Olay yaşam döngüsü

firing  ──ack──▶  acknowledged
   │                    │
   └────────────────────┴───── operator resolve ───▶  resolved

• firing — işlemci az önce olayı açtı veya başka bir ihlal algıladı. Tetikleme bildirimi tam olarak bir kez yayılır (olayın notified_firing_at zaman damgasına göre geçit oluşturulmuş).
• acknowledged — bir operatör /incidents/:id üzerinde ack düğmesine bastı. Olay hala açık olarak kabul edilir; sonraki ihlaller kanıtını yeniden bildirmeden günceller.
• resolved — bir operatör resolve düğmesine bastı. Kural tetiklemeyi durdurduğunda otomatik çözümleme planlanmıştır ancak şu anda etkinleştirilmemiştir, bu nedenle açık bir olay bir operatör bunu çözene kadar açık kalır.

​

Gerekli İzinler

• alerts:read: uyarı kurallarını görüntüle.
• alerts:write: uyarı kuralları oluştur, düzenle, sil ve test bildirimi tetikle.
• incidents:read: olayları görüntüle.
• incidents:write: uyarıya bağlı olmayan manuel (ad-hoc) olaylar açılır.
• incidents:ack: olayları onayla, ata, yorum yap ve çözümle.

Eski alerts:ack. Eski alerts:ack token’ına sahip anahtarlar ve operatörler çalışmaya devam eder: incidents:ack olarak onurlandırılır (ve incidents:read ima eder), böylece mevcut on-callerlar kimlik bilgileri yeniden yayınlamadan erişimlerini korurlar. Yeni hibeler incidents:* ailesiyle verin.

E-posta alıcı seçici. Uyarı editörünün alıcı seçici kuruluşunuzun üyelerini listeler böylece onları ada göre seçebilirsiniz. alerts:read veya alerts:write tutan herhangi bir operatör için yükler; bu amaç için takımınızın dizinini görüntülemek herhangi bir users:read gerektirmez ve seçici yalnızca üye e-posta adreslerini döndürür, asla tam kullanıcı kayıtlarını döndürmez.

​

Yapılandırma

• alerts.email_default_recipients (email_list): e-posta dizeleri JSON dizisi — e-posta kanalları için varsayılan alıcılar.
• alerts.slack_default_webhook (url): varsayılan Slack gelen-webhook URL’si.
• alerts.webhook_default_url (url): varsayılan genel-webhook URL’si.
• alerts.webhook_signing_secret (secret): HMAC-SHA256 anahtarı. GET yanıtında her zaman "" olarak döndürülür; döndürmek için yeni bir değer yazın.
• alerts.enabled_channels (channel_set): uyarı tetiklendiğinde gönderilenin kuruluş çapında harici kanal türleri kümesi; üçü de varsayılan (email, slack, webhook). Bir türü buradan çıkarmak, her kuralı düzenlemeden tüm uyarılar için bu kanalı global olarak bastırır. Panodaki kanal her zaman teslim edilir ve bu ayardan etkilenmez.

​

Yeni bir uyarıyı doğrula

1. Bunu en az bir bildirim kanalı ile etkinleştirilmiş olarak kaydedin.
2. Uyarı ayrıntı sayfasından test seçin ve her yapılandırılmış hedefin sentetik bildirimi almasını doğrulayın.
3. İlk gerçek ihlaldan sonra, olayın Incidents altında görünmesini ve ölçülen değerinin karşılık gelen pano sorgusuyla eşleşmesini doğrulayın.

​

Sorun Giderme