קטלוג אירועים קנוניים
עיקרון
שמרו על שמות אירועים ב-snake_case; הימנעו מ-PII. השתמשו ב-resource ו-attributes.
GitHub
github_rate_limit_check— בדיקת Rate Limit.github_upload_start— התחלת תהליך העלאה.github_upload_saved_error— שגיאה בשמירת קובץ שהועלה.github_upload_direct_error— שגיאה בהעלאה ישירה.github_import_repo_error— שגיאה בייבוא ריפו.github_sync— סנכרון קבצים מוצלח.
{"event":"github_upload_saved_error","severity":"error","request_id":"a3f2c891","repo":"owner/repo","error":"Rate limit exceeded"}
DB
db_get_latest_version_error— שגיאה בשליפת גרסה אחרונה.db_save_code_snippet_error— שגיאה בשמירת קטע קוד.db_delete_file_error— שגיאה במחיקה.
{"event":"db_get_latest_version_error","severity":"error","request_id":"a3f2c891","error":"not found"}
Alerts
alert_received— התקבלה התראה מה-Alertmanager.alerts_parse_error— כשל בפענוח ההתראה.
Repo Analyzer
repo_analysis_start/repo_analysis_parsed/repo_analysis_donerepo_analysis_error— כשל בניתוח ריפו.
Business
business_metric— אירוע ביזנס כללי (למשלfile_saved/search/github_sync).
הערה
עדיף לציין מזהי משאבים עקביים (resource:{type,id}) ולשמור על msg_he קצר וברור.