התראות

​

מושגים

• התראה — הכלל. הוא אומר מה לבדוק (ההדלקה), כמה לעתים קרובות (מרווח ההערכה), מתי להתייחס אליו כשבור (לוגיקה מרוכבת), כמה דחוף (חומרה), ומי/איפה להודיע (ערוצים).
• תקרית — מה קורה כאשר התראה משתלחת. התראה אחת יכולה להיות בעלת תקרית פתוחה אחת בלבד בכל פעם. הפרות חוזרות מעדכנות את ראיות אותה תקרית. תקריות נפתרות על ידי מפעיל; רזולוציה אוטומטית כאשר הכלל מפסיק לשלוח אותות מתוכננת אך לא מופעלת כרגע.
• ערוץ — היכן הודעה מגיעה: דוא”ל, Slack, webhook כללי, או בתוך הלוח. כל התראה יכולה לצרף כל שילוב.

​

סוגי הדלקה

​

1. metric_threshold

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

​

2. custom_sql

• מצב שורות (ללא op/value): ההתראה משתלחת ברגע שהשאילתה מחזירה לפחות שורה אחת.
• מצב ערך: השאילתה חייבת לכנות עמודה אחת כ-metric_value; המשלח משווה את ה-metric_value של השורה הראשונה מול value באמצעות op.

{
  "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", או { "at_least": N }.
• conditions[]: כל { score_key, op, value }, תוך שימוש באותם מפעילים כמו ההדלקות האחרות (>, >=, <, <=, ==).
• window_secs: ההחזר אחורה המשותף החל על כל תנאי (ברירת מחדל 3600).
• min_count: מספר הערכות מינימום לכל תנאי לפני שתנאי זה יכול להיות הפרה; תנאי בעל דגימות מעטות מדי בחלון נחשב “לא הופר” (ברירת מחדל 1).
• environment: אופציונלי; מגביל כל תנאי לסביבה אחת.

​

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"
}

​

לוגיקה מרוכבת (M of N)

• eval_window: כמה הערכות אחרונות להסתכל על (ברירת מחדל 1)
• min_breaches: כמה מהן חייבות להיות הפרה לפני שההתראה משתלחת (ברירת מחדל 1)

​

מרווח הערכה

​

ערוצים

​

דוא”ל

1. החזקה ערוץ-ספציפית recipients[] (כאשר לא ריק).
2. הגדרת alerts.email_default_recipients (מערך של מחרוזות דוא”ל).

​

Slack

• URL ברירת מחדל: alerts.slack_default_webhook (קבע בַ/settings).
• עקיפה לכל התראה: קבע את webhook_setting_key של הערוץ לכל מפתח הגדרה מסוג URL אחר, למשל alerts.slack_oncall, alerts.slack_costs.

​

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": { … } }
}

​

בתוך הלוח

​

מחזור חיים של תקרית

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

• משדר — המשלח פשוט פתח את התקרית או גילה הפרה נוספת. הודעת הדלקה היא מחוברת בדיוק פעם אחת (מהודקת על ידי חותמת הזמן notified_firing_at על התקרית).
• מודה — מפעיל לחץ על ack בַ/incidents/:id. התקרית עדיין נחשבת פתוחה; הפרות עתידיות יעדכנו את ראיות שלה ללא הודעה חוזרת.
• פתור — מפעיל לחץ על resolve. רזולוציה אוטומטית כאשר הכלל מפסיק לשלוח אותות מתוכננת אך לא מופעלת כרגע, כך שתקרית פתוחה נשארת פתוחה עד שמפעיל פותר אותה.

​

הרשאות נדרשות

• alerts:read: הצג כללי התראות.
• alerts:write: צור, ערוך, מחק כללי התראות, והפעל הודעת בדיקה.
• incidents:read: הצג תקריות.
• incidents:write: פתח תקריות ידניות (ad-hoc) שאינן קשורות להתראה.
• incidents:ack: הודא, הקצה, הערות, ופתור תקריות.

הורשת alerts:ack מורשת. מפתחות ומפעילים שהוענקו לטוקן alerts:ack הישן שלהם ממשיכים לעבוד: זה מכובד כ-incidents:ack (והרמז incidents:read), כך שיום-קרוביות קיימות שומרות על גישתם ללא הדלקה מחדש של פרטים. בעיה מענקים חדשים עם המשפחה incidents:*.

בורר נמען דוא”ל. בורר הנמענים של עורך ההתראות רושם את חברי הארגון שלך כך שתוכל לבחור אותם לפי שם. הוא טוען לכל מפעיל המחזיק alerts:read או alerts:write; צפיית ספרית הצוות שלך למטרה זו לא דורשת users:read, והבורר מחזיר רק כתובות דוא”ל של חברים, לעולם לא רשומות משתמש מלאות.

​

תצורה

• alerts.email_default_recipients (email_list): מערך JSON של מחרוזות דוא”ל — הנמענים ברירת המחדל לערוצי דוא”ל.
• alerts.slack_default_webhook (url): URL webhook נכנס ברירת המחדל של Slack.
• alerts.webhook_default_url (url): generic-webhook URL ברירת המחדל.
• alerts.webhook_signing_secret (secret): מפתח HMAC-SHA256. תמיד החזר כ-"" בתגובת GET; הקלד ערך חדש לסיבוב.
• alerts.enabled_channels (channel_set): קבוצת ערוצים חיצוני רחב-ארגוני שמשודרות כאשר התראה משתלחת; ברירות לכל שלוש (email, slack, webhook). הסרת סוג כאן משעות את הערוץ בכללי לכל התראה ללא עריכת כל כלל. ערוץ בתוך הלוח תמיד מועבר ואינו מושפע מהגדרה זו.

​

אמת התראה חדשה

1. שמור אותו כמופעל עם לפחות ערוץ הודעות אחד.
2. בחר בדיקה בעמוד פרטי ההתראה וקבל את הודעת הבדיקה הסינתטית בכל יעד מוגדר.
3. לאחר ההפרה הראשונה בעולם האמת, קבל את הופעת התקרית תחת Incidents וערכו הנמדד תואם את שאילתת הלוח המקביל.

​

פתרון בעיות