Ҷамъоварии телеметрия ва чорабиниҳо

1) Мақсад ва принсипҳо

• Ҷараёни ягонаи пешгӯишаванда барои таҳлил, зидди қаллобӣ, RG, мувофиқат ва ML.
• Пайгирии ниҳоӣ (корбар/сеанс/дархост/пайгирӣ) ва такрористеҳсолкунӣ.
• Ҳадди ақалл кам кардани PII ва риояи дахолатнопазирӣ.

Принципы: схема-аввал, тарроҳии махфият, idempotency-by-default, мушоҳида-бо нобаёнӣ, хароҷот.

2) Таксономияи рӯйдодҳо

Пардохт: 'пардохт. амонат ',' пардохт. бозхонд ',' пардохт. ситонидан '.
Бозӣ: 'бозӣ. session_start/stop', 'бозӣ. Бет ',' бозӣ. пардохти ',' бонус. татбиқ карда мешавад '.
Одат: 'author. login', 'профил. навсозӣ ',' kyc. status_changed', 'rg. limit_set'.
Ҳуҷраҳои амалиётӣ: 'api. дархост ',' хато. истисно ',' озод кардан. ҷойгиркунии ',' хусусият. flag_changed'.
Мувофиқат: 'aml. alert_opened', 'санксияҳо. намоиш дода шуд ',' dsar. дархост карда шуд '.

Ҳар як намуди соҳиби домейн, схема ва SLO тару тоза дорад.

3) Нақшаҳо ва шартномаҳо

• 'event _ time' (UTC), 'event _ type', 'schema _ version', 'event _ id' (UUID/ULID),
• 'trace _ id '/' span _ id', 'request _ 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 Мизоҷ (Веб/Мобилӣ/Мизи корӣ)

Телеметрияи маҳаллии SDK, пешниҳоди партия, бозомӯзии экспоненсиалӣ.
Чорабиниҳои худкор: боздидҳо, кликҳо, намоёни блокҳо, веб-виталҳо (TTFB, LCP, CLS), хатогиҳои JS.
Идентификаторҳо: 'дастгоҳ _ id' (устувор, аммо хусусӣ), 'session _ id' (навсозӣ), 'корбар. pseudo_id'.
Муҳофизат аз "садо": тарҳ аз ҷониби 'event _ id', дротлинг, интихоби намуна аз ҷониби муштариён.

4. 2 Сервер/пуштибонӣ

Парпечҳои Logger/tracer (Open

Партофтани ҳатмии 'trace _ id' аз канор/дарвоза ба ҳама хадамоти поёноб.
Намунаи Outbox барои нашри транзаксионии рӯйдодҳои домейн.

4. 3 Таъминкунандагон/шахсони сеюм

Пайвасткунакҳо (PSP/KYC/студияҳо) бо муқаррарӣ ба схемаҳои мизбон; адаптерҳои версия.
Тафтиши якпорчагии имзо/сарборӣ, сабти периметрӣ (аудити воридшуда).

5) Telemetry Open (OT bel)

Нишонаҳо: ҳар як дархост 'trace _ id' мегирад; мо гузоришҳо/рӯйдодҳоро тавассути 'trace _ id '/' span _ id' мепайвандад.
Гузоришҳо: OTel Logs/табдилдиҳандаро истифода баред; хидмати тамғакоғазҳои муҳити зист. ном ',' ҷойгиркунӣ. env '.
Нишондиҳандаҳо: RPS/ниҳонӣ/хатогӣ аз рӯи хидмат, ченакҳои корӣ (GGR, табдилдиҳӣ).
Коллектор: нуқтаи ягонаи қабул/буфер/содирот ба Кафка/HTTP/графикӣ. стек.

6) Идентификаторҳо ва коррелятсия

'event _ id' - беҳамтоӣ ва аблаҳӣ.
'усер. pseudo_id' - тахаллуси устувор (харитасозии алоҳида ва маҳдуд).
'session _ id', 'request _ id', 'trace _ id', 'дастгоҳ _ id' барои таҳлили ниҳоӣ талаб карда мешавад.
Мувофиқати ID дар дарвозаи API ва сатҳи SDK.

7) Интихоб ва назорати ҳаҷм

Қоидаҳо: навъи як ҳодиса, ҳар бозор, динамикӣ (мутобиқшавӣ) аз рӯи сарборӣ.
Ҳодисаҳои дақиқ сабтшуда: пардохт/мувофиқат/ҳодисаҳо - интихоб карда нашудаанд.
Ҳодисаҳои таҳлилӣ: 10-50% бо вазни ислоҳӣ дар ҳолатҳои экран иҷозат дода мешавад.
Пастшавии канори сервер: Барои ченакҳои басомади баланд эътибор дорад.

8) Махфият ва риояи он

Кам кардани PII: Tokenize PAN/IBAN/email; IP → рамзҳои гео/ASN ҳангоми ворид кардан.
Минтақасозӣ: Ба нуқтаҳои ниҳоии минтақавӣ фиристед (EEA/UK/BR).
DSAR/RTBF: дастгирии пинҳон кардани проексияи интихобӣ; сабти муомилоти ҳуқуқӣ.
Сиёсати нигоҳдорӣ: вақт аз рӯи намуд (таҳлил кӯтоҳтар, дарозтар танзим); Нигоҳдории ҳуқуқӣ.

9) Нақлиёт ва буферкунӣ

→ Мизоҷи Edge: HTTPS (HTTP/2/3), 'POST/telemetry/back' (то 100 ҳодиса).
Edge → шина: Кафка/Редпанда аз ҷониби 'user тақсим карда шудааст. pseudo_id'/'tenant_id'.
Форматҳо: JSON (inest), Avro/Protobuf (дар автобус), Parquet (дар кӯл).
Эътимоднокӣ: ретрай бо ҷиттер, DLQ, ҷудокунии заҳр-ҳаб.

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

10) Эътимоднокӣ ва аблаҳӣ

'Event _ id' + бобои сервер аз ҷониби '(event_id, манбаъ).
Outbox оид ба хидматҳо, Маҳз-Як-семантика дар риштаҳо (ҳолати калидӣ + dedupe).
Фармоиш дар доираи калид: аз ҷониби 'корбар/сеанс' тақсим карда шудааст.
Назорати вақт: NTP/PTP, гузаришро иҷозат дод (масалан, ≤ 200 мс), 'қабул _ at' дар сервер.

11) Сифати телеметрия (TQ) ва SLO

Пуррагӣ: ≥ 99. 5% рӯйдодҳои навъи интиқодӣ барои як Т.
Тару тоза: таъхири расонидани p95 ба нуқра ≤ 15 дақиқа.
Дурустӣ: нақшаҳои дуруст ≥ 99. 9%, сатҳи тарки <0. 1%.
Фарогирии пайгирӣ: Фоизи дархостҳо бо 'trace _ id' ≥ 98%.
Арзиш/ГБ: буҷети мақсаднок барои ворид/нигоҳдорӣ аз рӯи домен.

12) Мушоҳидакорӣ ва панели панелҳо

• Lag indest (p50/p95) аз рӯи манбаъ ва минтақа.
• Пуррагӣ аз рӯи намуди ҳодиса ва бозор.
• Хатогиҳои тасдиқкунии схемаҳои/калонҳаҷм.
• Харитаи версияи SDK ва фоизи мизоҷони кӯҳна.
• Таносуби веб-виталҳо ↔ табдили/нокомӣ.

13) Талаботи муштарии SDK

Изофаи рӯшноӣ, буфери офлайнӣ, оғозёбии таъхиршуда.
Танзимот: интихоб, андозаи максималии партия, синни максималии навбат, мӯд махфият (no-PII).
Муҳофизат: имзои бастаҳо/анти-тампер, obfuscation калид.
Навсозӣ: хусусиятҳои парчамҳо барои хомӯш кардани рӯйдодҳои ғалоғула.

14) Қабати канорӣ ва муҳофизат

Меъёри меъёр, WAF, тасдиқи схема, фишурдасозӣ (gzip/br).
Сатил токен барои як муштарӣ; зидди такрорӣ ('request _ id', TTL).
Бартараф кардани IP ва UA → нормализатсия/ғанисозӣ берун аз сарбории "хом".

15) Ҳамгироӣ бо лӯлаи маълумот

Биринҷӣ: бори бебозгашт иловашуда (барои криминалистика).
Нуқра: ҷадвалҳои муқарраршуда бо такрорӣ/ғанисозӣ.
Тилло: парвандаҳои намоишӣ барои BI/AML/RG/маҳсулот.
Робита байни рӯйдодҳо ва гузоришҳо; версияҳои дигаргунсозӣ.

16) Таҳлили сифати муштариён

Таносуби мизоҷони ором (ягон ҳодиса дар соатҳои N).
Аномалияҳои "тӯфон" (такрори оммавӣ/таркиш).
Ҳиссаи "SDK-ҳои кӯҳна" аз рӯи версия ва платформа.

17) Равандҳо ва RACI

R: Платформаи маълумот (inest/bus/validators), App Teams (асбоби SDK).
A: Сардори маълумот/меъморӣ.
C: Мувофиқат/DPO (PII/нигоҳдорӣ), SRE (SLO/ҳодисаҳо).
I: BI/Маркетинг/Хавф/Маҳсулот.

18) Харитаи роҳсозӣ

1. Чорабиниҳои таксономия v1 + схемаҳои JSON барои 6-8 намуд.

2. SDK (Web/Android/IOS) с партияи интихобӣ; Edge '/telemetry/партия '.

3. Кафка + қабати биринҷӣ; валидаторҳои асосӣ ва тарҳ.

4. Панели панели ақибмонӣ/пуррагӣ, огоҳиҳо дар бораи тарки/валидатор.

• OTEel Коллектор, таносуби пайгирӣ; Нормализатсияи нуқра ва қоидаҳои DQ.
• Нуқтаҳои ниҳоӣ (EEA/UK), махфият-мӯд, тартиботи DSAR/RTBF.
• Харитаи версияи SDK, навсозиҳои худкор бо ҳалқаҳо.

• Маҳз - Як маротиба дар ҷараёнҳо, Пайвастҳои Feature Store, каналҳои зидди қаллобӣ онлайн.
• Кодекси қоидаҳо барои схемаҳо ва тасдиқкунандагон, таҳлили таъсир.
• Оптимизатсияи арзиш: интихоби мутобиқшавӣ, Z-фармоиш/кластер дар кӯл.

19) Рӯйхати сифат пеш аз озод шудан

• Майдонҳои схемаи зарурӣ ва намудҳои дуруст пур карда мешаванд.
• 'trace _ id '/' request _ id '/' session _ id' мавҷуд аст.
• SDK партия, такрорӣ, интихобро дастгирӣ мекунад.
• Edge схемаро тасдиқ мекунад ва андозаи сарбориро маҳдуд мекунад.
• Филтрҳои махфият ва токенизатсияи майдонҳои ҳассос фаъол мебошанд.
• SLO/огоҳиҳо ва панелҳои танзимшуда.
• Ҳуҷҷатгузорӣ барои доменҳо (мисоли ҳодиса, соҳиб, SLA).

20) Хатогиҳои зуд-зуд ва чӣ гуна аз онҳо канорагирӣ кардан

Чорабиниҳои хом бидуни нақша: ба феҳрист ва санҷиши CI дохил шавед.
Idempotency нест: 'event _ id' -ро талаб кунед ва тирезаҳои дефликатсияро нигоҳ доред.
Омехтаи PII ва таҳлил: харитасозии алоҳида, майдонҳои ниқоб.
Пайгирӣ нест: масири 'trace _ id' тавассути дарвоза → хидматҳо → чорабиниҳо.
Ҳаҷми идорашаванда - Квотаҳои интихоб/тротлинг ва буҷетро истифода баред.
Нуқтаи глобалӣ бидуни минтақаҳо - истифодаи минтақаҳо ва иқоматгоҳ.

21) Луғат (мухтасар)

Open-Telemetry (OT bel) стандарти кушода барои роҳҳо/ченакҳо/гузоришҳо мебошад.
Outbox - нашри транзаксионии чорабиниҳои домейн.
DLQ - навбати паёмҳои "шикаста".
Интихоб - интихоби як қисми чорабиниҳо барои кам кардани ҳаҷм.
Резидентураи маълумот - нигоҳ доштани маълумот дар қаламрави дилхоҳ.

22) Сатри поён

Телеметрияи хуб тарҳрезишуда на танҳо "фиристодани гузоришҳо" аст: нақшаҳои қатъӣ, идентификаторҳои мувофиқашуда, махфияти пешфарз, нақлиёти боэътимод, мушоҳида ва сарфаи хароҷот. Бо пайгирии ин мақола, шумо ҷараёни устувори рӯйдодҳоро барои таҳлил, мувофиқат ва омӯзиши мошин бо SLO-ҳои пешгӯишаванда омода мекунед.