Sentry
======

הפעלה (משתני סביבה)
--------------------
- ``SENTRY_DSN= https://xxx@o1234.ingest.sentry.io/5678``
- ``SENTRY_TRACES_SAMPLE_RATE=0.1`` (אופציונלי)
- ``SENTRY_PROFILES_SAMPLE_RATE=0.1`` (אופציונלי)

התראות ל־Telegram וללוח Observability
-------------------------------------
ברירת מחדל: Sentry מציג Issues בממשק ושולח מיילים, אבל **לא** מזרים את זה אוטומטית למערכת ההתראות הפנימית שלנו (Telegram + Observability).

כדי לקבל התראות Sentry גם אצלנו יש שתי אפשרויות:

- Polling (מומלץ): הבוט מושך Issues אחרונים מ-API של Sentry וממיר אותם ל-``internal_alerts`` עם ``alert_type=sentry_issue``.
- Webhook (אופציונלי): שירות ה-Web שמריץ את ``services/webserver.py`` מקבל ``POST`` ל-``/webhooks/sentry`` וממיר את ה-payload ל-``internal_alerts``.

איפה להגדיר משתנים
~~~~~~~~~~~~~~~~~~
- Polling: **בבוט** (תהליך ``main.py``).
- Webhook: **בשירות ה-Web** שמאזין ל-``/webhooks/sentry``.

מה צריך כדי שזה יופיע בלוח Observability
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- ``ALERTS_DB_ENABLED=true`` (וגם חיבור MongoDB תקין: ``MONGODB_URL`` + ``DATABASE_NAME``)
- ברגע שמגיע ``internal_alert`` מסוג ``sentry_issue`` הוא יישמר ב-``alerts_log`` ויופיע בלוח.

מה צריך כדי שזה יישלח לטלגרם
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- ``ALERT_TELEGRAM_BOT_TOKEN`` + ``ALERT_TELEGRAM_CHAT_ID``
- ודאו ש-``ALERT_TELEGRAM_MIN_SEVERITY`` לא גבוה מדי (לרוב ``warning``/``error``).

Polling – משתנים רלוונטיים
~~~~~~~~~~~~~~~~~~~~~~~~~~
הפעלה בסיסית:

- ``SENTRY_AUTH_TOKEN`` + ``SENTRY_ORG`` (ואופציונלי ``SENTRY_PROJECT`` לסינון)
- ``SENTRY_POLL_ENABLED=true``

שליטה על התזמון/רעש:

- ``SENTRY_POLL_INTERVAL_SECS``: כל כמה שניות לעשות Poll
- ``SENTRY_POLL_FIRST_SECS``: דיליי לפני הריצה הראשונה אחרי עלייה
- ``SENTRY_POLL_DEDUP_SECONDS``: חלון דה-דופליקציה לכל Issue
- ``SENTRY_POLL_SEED_SILENT=true``: מומלץ כדי לא “להציף” על Issues קיימים בעת עלייה

Webhook – אבטחה ודה-דופליקציה
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
אם מגדירים ``SENTRY_WEBHOOK_SECRET`` השירות יאמת את הבקשה באחת מהדרכים:

- ``Authorization: Bearer <secret>``
- או פרמטר ``?token=<secret>``
- או חתימת HMAC (כותרות כמו ``X-Sentry-Hook-Signature``/``X-Sentry-Hook-Timestamp`` כאשר קיימות)

כדי לצמצם הצפה יש ``SENTRY_WEBHOOK_DEDUP_WINDOW_SECONDS`` (ברירת מחדל 300).

עקרונות
--------
- Redaction מופעל אוטומטית.
- חברו ``error_code`` לקיבוץ חכם של שגיאות.