ChatOps – /observe: הרחבות -v ו- -vv

מסמך זה מפרט את מצב ההרחבה של הפקודה /observe לצורכי תחקור ומהירות תגובה בזמן אמת.

• מתי להשתמש: כשצריך תמונת Observability עמוקה (ברמת מערכת) בזמן אמת, כולל הצלבת מקורות נתונים וזיהוי מגמות/חריגות.

• הרשאות: מנהלים בלבד.

תחביר ופרמטרים

• -v – מצב מפורט (Verbose)

• -vv – מצב מפורט מאוד (Very Verbose)

• פרמטרים אופציונליים:

  • source=db|memory|all – מקור הנתונים לסיכומים (ברירת מחדל: all)

  • window=5m|1h|24h – חלון זמן לסיכומי התראות (ברירת מחדל: 24h)

דוגמאות

/observe -v window=5m source=all
/observe -v source=memory
/observe -vv source=db

פלט לדוגמה – ‎-v

🔍 Observability – verbose
Uptime: 99.87% (source: memory)
Error Rate (5m): curr=0.12% | thr=4.85% (source: memory)
Latency (5m): curr=0.210s | thr=1.740s (source: memory)
Alerts (DB, window=5m): total=2 | critical=1
Alerts (Memory, window=5m): total=3 | critical=1; unique_critical_ids=1
Recent Errors (memory, N≤5):
- [API_002] github_rate_limit_exceeded — 2025-10-23T03:55:12+00:00
- [DB_001] db_connection_timeout — 2025-10-23T03:54:08+00:00
Cooling:
- error_rate_percent: idle
- latency_seconds: active (~120s left)
Sinks:
- telegram: 9/9 ok
- grafana: 8/9 ok

פלט לדוגמה – ‎-vv

🔍 Observability – very verbose
Uptime: 99.87% (source: memory)
Error Rate (5m): curr=0.20% | thr=4.60% (source: memory)
Latency (5m): curr=0.180s | thr=1.520s (source: memory)
Alerts (DB, window=24h): total=12 | critical=3
Alerts (Memory, window=24h): total=10 | critical=3; unique_critical_ids=3
Recent Errors (memory, N≤5):
- [CONN_001] Database connection timeout — 2025-10-23T02:02:31+00:00
- [API_002] GitHub rate limit exceeded — 2025-10-23T01:49:12+00:00
Cooling:
- error_rate_percent: idle
- latency_seconds: idle
Sinks:
- telegram: 5/5 ok
- grafana: 5/5 ok
Recent Alert IDs (DB, N≤10):
- id:58f3e3f8-1a62-4c34-8a90-4fb3a1a6c0a1
- id:1c2d3e4f-5a6b-7c8d-9e0f-123456789abc
- h:3a6f5e...

הערות שימוש

• -vv מוסיף פירוט מזהי התראות אחרונות מה-DB, שימושי לטרייסינג מול מקורות חיצוניים.

• window קובע את חלון החישוב הסטטיסטי להתראות; נתונים תפקודיים (latency/error rate) מוצגים לפי חלון קצר (לרוב 5 דקות).

• במערכות רועשות, מומלץ להתחיל מ־-v ורק בעת הצורך להעמיק ל־-vv.

קישורים רלוונטיים

• Issue הפקודות: #1021

• סקירת Observability כללית: monitoring

• פקודות ChatOps נוספות: chatops/commands