טלמטריה ואוסף אירועים

1) מטרה ועקרונות

• זורם אירוע יחיד וצפוי לאנליטיקה, אנטי-הונאה, אר-ג 'י, ציות ואמ-אל.
• איתור מקצה לקצה (משתמש/סשן/בקשה/עקבות) ורבייה.
• מזעור מח "ש וציות לפרטיות.

יום ראשון, תרשים ראשון, פרטיות על ידי עיצוב, אידמפוטנטיות על ידי ברירת מחדל, תצפית על ידי ברירת מחדל, עלות מודעת.

2) טקסונומיה של אירועים

תשלום: "תשלום. הפקדה, תשלום. משיכה, 'תשלום. Chargback '.
משחקים: 'משחק. session_start/stop', המשחק. הימור ',' משחק. תשלום ", בונוס. הוחל ".
מותאם אישית: ”כתב”. רישום, ”פרופיל”. עדכון, קייק. status_changed', 'rg. limit_set'.
חדרי ניתוח: "אפי. מבקש ”, טעות”. יוצא מן הכלל ”, שחרור”. לפרוס ',' תכונה. flag_changed'.
ציות: "aml. alert_opened', סנקציות. מוקרן, 'dsar. מבוקש '.

לכל סוג יש בעל תחום, סכימה, וטריות SLO.

3) מזימות וחוזים

• "event _ time" (UTC), "event _ type", "schema _ version", "event _ id' (UUID/ULID),
• 'trace _ id'/' span _ id',' בקשה _ id', 'משתמש. pseudo_id', 'session _ id',

json
{
"event_id": "01HFY1S93R8X",
"event_time": "2025-11-01T18:45:12. 387Z",
"event_type": "game. bet",
"schema_version": "1. 4. 0",
"user": {"pseudo_id": "p-7a2e", "age_band": "25-34", "country": "EE"},
"session": {"id": "s-2233", "device_id": "d-9af0"},
"game": {"id": "G-BookOfX", "provider": "StudioA", "stake": {"value": 2. 00, "currency": "EUR"}},
"ctx": {"ip": "198. 51. 100. 10", "trace_id": "f4c2...", "request_id": "req-7f91"},
"labels": {"market": "EE", "affiliate": "A-77"}
}

התפתחות מזימות: גרסאות סמנטיות; להתאים לאחור - להוסיף שדות נאול; שבירה - רק בגרסה החדשה ('/v2 ') עם תקופת הקלטה כפולה.

4) כלי נגינה: היכן וכיצד

4. 1 לקוח (Web/Mobile/Desktop)

טלמטריה חוצץ מקומית SDK, הגשת אצווה, מגשים מעריכיים.
אירועים אוטומטיים: ביקורים, קליקים, ראות של בלוקים, איברים חיוניים ברשת (TTFB, LCP, CLS), שגיאות JS.
מזהים: "התקן _ id" (יציב, אבל פרטי), "session _ id' (מעודכן)," משתמש ". pseudo_id'.
הגנה מפני "רעש": dedup by "event _ id', מצערת, דגימת צד לקוח.

4. 2 שרת/גיבוי

עטיפות Logger/Letracer (OpenTelemetry) Act domain event event.
זריקה חובה "trace _ id' מקצה/שער לכל שירותי במורד הזרם.
דפוס יוצא של הוצאה לאור של אירועי תחום.

4. 3 ספקים/צדדים שלישיים

מחברים (PSP/KYC/studios) עם נורמליזציה למעגלים מארחים; מתאם גרסאות.
בדיקת שלמות חתימה/טעינה, רישום היקפי (בלע ביקורת).

5) OpenTelemetry (Otel)

עקבות: כל בקשה מקבלת a trace _ id'; אנו משייכים יומנים/אירועים דרך 'trace _ id'/span _ id'.
יומנים: השתמש ברישומי אוטל/ממירים; השירות של תוויות הסביבה. שם, פריסה. Env '.
מטריצות: RPS/latency/rate-rate by service, מדדים עסקיים (GGR, המרה).
אספן: נקודה בודדת של קבלה/חוצץ/יצוא ל ־ Kafka/HTTP/גרפי. ערימה.

6) זיהוי והתאמה

'event _ id' - ייחודיות ואידישות.
"אוזר. pseudo_id' - שינוי יציב (מיפוי בנפרד ומוגבל).
'sess _ id',' בקשה _ id', 'trace _ id',' מכשיר _ id' דרושים לניתוח מקצה לקצה.
עקביות זיהוי בשער API ורמת SDK.

7) דגימה ובקרת נפח

כללים: לכל אירוע, לכל שוק, דינמי (אדפטיבי) על ידי עומס.
אירועים שנתפסו בצורה מדויקת: תשלום/ציות/תקריות - לא נדגמו.
אירועים אנליטיים: 10-50% עם משקולות מתקנות בתיקי תצוגה מותרים.
חיסרון בצד השרת: תקף עבור מדדים בתדר גבוה.

8) פרטיות וציות

מזעור PII: Tokenize PAN/IBAN/MAIL; IP = geo codes/ASN בעת בליעה.
Regionalization: שלח לנקודות בליעה אזוריות (EEA/UK/BR).
DSAR/RTBF: תמיכה בהסתרת הקרנה סלקטיבית; יומן העברות משפטי.
מדיניות שימור: תזמון אחר סוג (אנליטיקה קצרה יותר, רגולטורית ארוכה יותר); אחיזה משפטית.

9) תחבורה וחציצה

▪ לקוח קצה: HTTPS (HTTP/2/3), ”פוסט/טלמטריה/אצווה” (עד 100 אירועים).
Edge # Tire: Kafka/Redpanda מחולק על ידי user. pseudo_id'/'tenant_id'.
פורמטים: JSON, Avro/Protobuf (באוטובוס), Parquet (באגם).
אמינות: רטריי עם ג 'יטר, די-אל-קיו, בידוד כדורי רעל.

json
{
"sdk": {"name":"igsdk-js","version":"2. 7. 1"},
"sent_at": "2025-11-01T18:45:12. 500Z",
"events": [ {... }, {... } ]
}

10) אמינות ואידמפוטנטיות

הלקוח יצר ”event _ id' + server by '(event_id, source)”.
Outbox על שירותים, בדיוק-פעם-סמנטיקה בחוטים (state + dedupe).
סדר בתוך מפתח: מחולק על ידי ”משתמש/הפעלה”.
בקרת זמן: NTP/PTP, סחיפה מותרת (לדוגמה, 200 ms), "קבל _ at' בשרת.

11) איכות טלמטריה (TQ) ו ־ SLO

שלמות: ב-99. 5% מאירועי סוג קריטי לכל T.
עיכוב משלוח p95 לסילבר 15 דקות.
תקינות: תוכניות תקפות 99. 9%, ירידה בקצב <0. 1%.
כיסוי עקבות: אחוז הבקשות עם "trace _ id' id mind 98%.
עלות/GB: תקציב היעד עבור בליעה/אחסון לפי תחום.

12) יכולת תצפית ולוחות מחוונים

• לאג אינג (p50/p95) על ידי מקור ואזור.
• שלמות על ידי סוג אירוע ושוק.
• שגיאות אימות של/גדול מדי-Paylads מזימות.
• מפת גרסת SDK ואחוז של לקוחות מורשת.
• קורלציה של איברים חיוניים ברשת ↔ המרה/כשלים.

13) דרישות SDK ללקוח

טביעת רגל קלה, חוצץ לא מקוון, אתחול דחוי.
הגדרות: דגימה, גודל אצווה מקסימלי, גיל תור מקסימלי, אופנת פרטיות (לא PII).
הגנה: חתימת חבילה/נגד חבלה, עיוות מפתח.
עדכון: תכונה-דגלים כדי לבטל אירועים רועשים.

14) שכבת קצה והגנה

הגבלת קצב, WAF, אימות סכימה, דחיסה (gzip/br).
דלי טוקן לכל לקוח; אנטי-שידור חוזר ("בקשה _ id', TTL).
הסרת IP ו UA = נורמליזציה/העשרה מחוץ למטען ”גולמי”.

15) אינטגרציה עם צינור הנתונים

ברונזה: בלתי הפיך תוספת מטען גולמי (לזיהוי פלילי).
שולחנות מנורמלים עם שכפול/העשרה.
זהב: תצוגת תיקים עבור BI/AML/RG/מוצר.
לינאז 'בין אירועים ודיווחים; גרסאות של שינויים.

16) ניתוח איכות לקוח

יחס לקוחות שקט (אין אירועים בשעות N).
אנומליות של ”הסערה” (שכפול המוני/פרץ).
שיתוף של ”SDKs מורשת” על ידי גרסה ופלטפורמה.

17) תהליכים ו ־ RACI

R: Data Platform (Inslevent/bus/validators), App Teams (SDK).
א ': ראש מחלקת נתונים/ארכיטקטורה.
C: Complication/DPO (PII/reservation), SRE (SLO/rences).
אני: BI/שיווק/סיכון/מוצר.

18) מימוש מפת דרכים

1. תרשימי Taxonomy v1 + JSON עבור 6-8 סוגים.

2. SDK (Web/Android/iOS) web/iOS dismaging; קצה '/טלמטריה/אצווה '.

3. שכבת קפקא + ברונזה; מאשרים בסיסיים ודידאפ.

4. לוח מחוונים בלע לג/שלמות, התראות לרדת/תוקף.

• Otel אספן, התאמת עקבות; נורמליזציה כסופה וכללי די-קיו.
• נקודות קצה אזוריות (EEA/UK), פרטיות-אופנה, הליכי DSAR/RTBF.
• מפת גרסת SDK, עדכונים אוטומטיים על ידי טבעות.

• בדיוק-פעם בזרמים, קשרים חנות תכונה, הזנות אנטי הונאה באינטרנט.
• חוק-כקוד לתוכניות ואימות, ניתוח השפעה.
• אופטימיזציה ערכית: דגימה אדפטיבית, סדר זי/קיבוצים באגם.

19) רשימת איכות לפני השחרור

[ ] שדות סכמה דרושים וסוגים נכונים מלאים.

[ ] 'trace _ id'/' quest _ id '/' session _ id' נוכחים.

[ ] SDK תומך בצרור, שוב, דגימה.

[ ] אדג 'נותן תוקף למזימה ומגביל את גודל המטען.

[ ] מסנני פרטיות ואסימונים של שדות רגישים מופעלים.

[ ] הגדרות SLO/התראות ולוחות מחוונים.

[ תיעוד ] לתחומים (אירוע לדוגמה, בעלים, SLA).

20) טעויות תכופות וכיצד להימנע מהן

אירועים גולמיים ללא מזימות: רישום כניסה ואימות מודיע.
אין אידמפוטנטיות: דרוש "event _ id' ולאחסן חלונות שכפול.
מפות נפרדות, שדות מסכות.
אין איתור: מסלול "trace _ id' דרך gateway ac.services access.
כרכים לא מנוהלים - השתמש בדגימה/טרקוטינג ומכסות תקציב.
נקודת סוף גלובלית ללא אזורים - להשתמש regionalization ותושבות נתונים.

21) גלוסרי (קצר)

OpenTelemetry הוא תקן פתוח לשבילים/מדדים/לוגים.
הוצאה לאור של אירועי תחום.
DLQ - תור של הודעות ”שבורות”.
דגימה - בחירה של חלק מהאירועים לצמצום נפח.
התמחות במידע - אחסון נתונים בתחום השיפוט הרצוי.

22) השורה התחתונה

טלמטריה מתוכננת היטב היא על סידורים, לא רק ”שליחת יומנים”: מזימות מחמירות, זהויות מוסכמות, פרטיות ברירת מחדל, תחבורה אמינה, תצפית וחיסכון בעלויות. בעקבות מאמר זה, אתה מקבל זרם קבוע של אירועים המוכנים לאנליטיקה, ציות ולמידת מכונה בעזרת SLOs צפויים.