Telemetri ve Etkinlik Koleksiyonu

1) Amaç ve prensipler

• Analitik, dolandırıcılıkla mücadele, RG, uyumluluk ve ML için tek ve öngörülebilir olay akışı.
• Uçtan uca izleme (kullanıcı/oturum/istek/izleme) ve tekrarlanabilirlik.
• PII minimizasyonu ve gizlilik uyumluluğu.

Принципы: şema-first, privacy-by-design, idempotency-by-default, observability-by-default, cost-aware.

2) Olayların taksonomisi

Ödeme: 'Ödeme. depozito ',' ödeme. para çekme ',' ödeme. Ters ibraz.
Oyun: 'oyun. session_start/stop', 'oyun. bet ',' oyunu. Ödeme ',' bonus. uygulandı '.
Özel: 'auth. login', 'profile. Güncelleme ',' kyc. status_changed','rg. limit_set'.
Ameliyathaneler: 'api. İstek ', hata. exception ',' release. dağıtın ', özelliği. flag_changed'.
Uyum: 'aml. alert_opened', 'yaptırımlar. Ekranlı ',' dsar. Talep edildi.

Her türün bir etki alanı sahibi, bir şeması ve bir tazelik SLO'su vardır.

3) Planlar ve sözleşmeler

• 'event _ time' (UTC), 'event _ type', 'schema _ version', 'event _ id' (UUID/ULID),
• 'trace _ id'/' span _ id', 'request _ id', 'user. 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"}
}

Şemaların evrimi: semantik versiyonlar; Geriye dönük uyumlu - yok edilebilir alanlar ekleyin; kırılma - sadece yeni versiyonda ('/v2 ') çift kayıt süresi ile.

4) Enstrümantasyon: nerede ve nasıl

4. 1 İstemci (Web/Mobil/Masaüstü)

Yerel tampon telemetri SDK, toplu gönderim, üstel geri ödemeler.
Otomatik olaylar: ziyaretler, tıklamalar, blokların görünürlüğü, web hayati (TTFB, LCP, CLS), JS hataları.
Tanımlayıcılar: 'device _ id' (kararlı, ancak özel), 'session _ id' (güncellendi), 'user. pseudo_id'.
"Gürültü'ye karşı koruma: 'event _ id'ile dedup, kısma, istemci tarafı örnekleme.

4. 2 Sunucu/arka uç

Logger/tracer wrappers (OpenTelemetry) - etki alanı olayı yayar.
Kenar/ağ geçidinden tüm alt hizmetlere zorunlu 'trace _ id' atma.
Etki alanı olaylarının işlemsel olarak yayınlanması için giden kutusu deseni.

4. 3 Sağlayıcılar/Üçüncü Taraflar

Konektörler (PSP/KYC/studios), ana devrelere normalleştirme ile; versiyon adaptörleri.
İmza/yük bütünlüğü kontrolü, çevre günlüğü (alma denetimi).

5) OpenTelemetry (OTel)

İzler: her istek bir 'trace _ id' alır; Günlükleri/olayları 'trace _ id'/' span _ id' aracılığıyla ilişkilendiriyoruz.
Günlükler: OTel Günlükleri/dönüştürücüleri kullanın; Çevre etiketleri hizmeti. Name ',' dağıtım. env '.
Metrikler: Hizmete göre RPS/gecikme/hata oranı, iş metrikleri (GGR, dönüşüm).
Toplayıcı: Kafka/HTTP/grafiğe tek bir makbuz/tampon/dışa aktarma noktası. yığın.

6) Tanımlayıcılar ve korelasyon

'event _ id' - benzersizlik ve idempotans.
'kullanıcısı. pseudo_id' - kararlı aliasing (ayrı ve sınırlı eşleme).
Uçtan uca analiz için 'session _ id', 'request _ id', 'trace _ id', 'device _ id' gereklidir.
API ağ geçidi ve SDK düzeyinde kimlik tutarlılığı.

7) Örnekleme ve ses kontrolü

Kurallar: olay tipi başına, pazar başına, yüke göre dinamik (uyarlanabilir).
Doğru şekilde yakalanan olaylar: ödeme/uyumluluk/olaylar - örneklenmedi.
Analitik olaylar: Vitrinlerde düzeltici ağırlıklar ile %10-50 izin verilir.
Sunucu tarafı altörnekleme: Yüksek frekanslı metrikler için geçerlidir.

8) Gizlilik ve uyumluluk

PII'yi en aza indirin: PAN/IBAN/e-postayı tokenize edin; IP - coğrafi kodlar/ASN alırken.
Bölgeselleştirme: Bölgesel en büyük uç noktalara gönderin (EEA/UK/BR).
DSAR/RTBF: seçici projeksiyon gizleme desteği; yasal işlem kaydı.
Saklama politikaları: türe göre zamanlama (analitik daha kısa, düzenleyici daha uzun); Yasal bekletme.

9) Taşıma ve tamponlama

Kenar istemcisi: HTTPS (HTTP/2/3), 'POST/telemetri/toplu iş' (100 etkinliğe kadar).
Kenar - Lastik: Kafka/Redpanda 'kullanıcı tarafından bölümlenmiş. pseudo_id'/'tenant_id'.
Formatlar: JSON (yutmak), Avro/Protobuf (otobüste), Parke (gölde).
Güvenilirlik: jitter, DLQ, zehir hapı izolasyonu ile retrai.

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

10) Güvenilirlik ve idempotency

İstemci tarafından oluşturulan 'event _ id' + sunucu dedesi tarafından '(event_id, kaynak)'.
Hizmetlerde giden kutusu, iş parçacıklarında Tam-Bir kez-semantik (anahtarlı durum + tekilleştirme).
Anahtar içinde sipariş: 'Kullanıcı/oturum'ile bölümlenmiş.
Zaman kontrolü: NTP/PTP, izin verilen sürüklenme (örneğin, ≤ 200 ms), sunucuda 'received _ at'.

11) Telemetri Kalitesi (TQ) ve SLO

Bütünlük: ≥ 99. T başına kritik tip olayların %5'i

Tazelik: Gümüş ≤ 15 dk p95 teslim gecikme.
Doğruluk: 99 ≥ geçerli şemalar. %9, düşme oranı <0. 1%.
İzleme kapsamı: 'Trace _ id' içeren isteklerin yüzdesi %98 ≥.
Maliyet/GB: Alana göre alım/depolama için hedef bütçe.

12) Gözlemlenebilirlik ve gösterge panoları

• Kaynak ve bölgeye göre lag ingest (p50/p95).
• Etkinlik türüne ve pazara göre bütünlük.
• / oversize-payloads şemalarının doğrulama hataları.
• SDK sürüm haritası ve eski istemcilerin yüzdesi.
• Web-vitallerin dönüşüm/başarısızlık ↔ korelasyonu.

13) İstemci SDK Gereksinimleri

Hafif ayak izi, çevrimdışı arabellek, ertelenmiş başlatma.
Ayarlar: örnekleme, maksimum parti boyutu, maksimum kuyruk yaşı, gizlilik modası (no-PII).
Koruma: paket imzası/kurcalama önleyici, anahtar gizleme.
Güncelleme: gürültülü olayları devre dışı bırakmak için özellik bayrakları.

14) Kenar katmanı ve koruma

Hız sınırı, WAF, şema doğrulama, sıkıştırma (gzip/br).
İstemci başına jeton kovası; Anti-replay ('request _ id', TTL).
IP ve UA kaldırma - "ham" yük dışında normalleştirme/zenginleştirme.

15) Veri boru hattı ile entegrasyon

Bronz: Geri dönüşümsüz ham yük eklendi (adli tıp için).
Gümüş: veri tekilleştirme/zenginleştirme ile normalleştirilmiş tablolar.
Altın: BI/AML/RG/ürün için vitrinler.
Olaylar ve raporlar arasındaki linaj; Dönüşümlerin versiyonları.

16) Müşteri Kalite Analitiği

Sessiz müşteri oranı (N saat içinde etkinlik yok).
"Fırtına" anomalileri (kitle yinelenen/patlama).
Sürüm ve platforma göre'eski SDK'ların "paylaşımı.

17) Süreçler ve RACI

R: Veri Platformu (alım/veri yolu/doğrulayıcılar), Uygulama Ekipleri (SDK enstrümantasyonu).
A: Veri/Mimari Başkanı.
C: Uyumluluk/DPO (PII/tutma), SRE (SLO/olaylar).
I: BI/Pazarlama/Risk/Ürün.

18) Uygulama Yol Haritası

1. 6-8 tip için olay taksonomisi v1 + JSON şemaları.

2. SDK (Web/Android/iOS) с toplu и örneklemesi; Kenar'/telemetri/toplu iş '.

3. Kafka + Bronz tabaka; temel doğrulayıcılar ve dedup.

4. Pano lag/completeness, drop/validator için uyarılar alır.

• OTel Toplayıcı, iz korelasyonu; Gümüş normalleştirme ve DQ kuralları.
• Bölgesel uç noktalar (AÇA/İngiltere), gizlilik-moda, DSAR/RTBF prosedürleri.
• SDK sürüm haritası, halkalar tarafından otomatik sunum güncellemeleri.

• Tam olarak - Akışlarda bir kez, Feature Store bağlantıları, dolandırıcılıkla mücadele çevrimiçi yayınları.
• Şemalar ve doğrulayıcılar için Kural-Kod, etki analizi.
• Değer optimizasyonu: adaptif örnekleme, gölde Z sırası/kümeleme.

19) Piyasaya sürülmeden önce kalite kontrol listesi

• Gerekli şema alanları ve doğru türler doldurulur.
• 'trace _ id'/' request _ id'/' session _ id' mevcuttur.
• SDK toplu, yeniden deneme, örneklemeyi destekler.
• Kenar şemayı doğrular ve yük boyutunu sınırlar.
• Gizlilik filtreleri ve hassas alanların tokenizasyonu etkinleştirilmiştir.
• Yapılandırılmış SLO/uyarılar ve panolar.
• Etki alanları için belgeler (örnek olay, sahip, SLA).

20) Sık yapılan hatalar ve bunlardan nasıl kaçınılacağı

Şemaları olmayan ham olaylar: kayıt defteri ve CI doğrulaması girin.
Hiçbir idempotency: 'event _ id've mağaza veri tekilleştirme pencereleri gerektirir.
PII ve analitik karışımı: ayrı eşlemeler, maske alanları.
İzleme yok: ağ geçidi üzerinden 'trace _ id' rotası - hizmetler - olaylar.
Yönetilmeyen hacimler - Örnekleme/trottling ve bütçe kotaları kullanın.
Bölgeler olmadan global uç nokta - bölgeselleştirme ve veri ikameti kullanın.

21) Sözlük (kısa)

OpenTelemetry (OTel), yollar/metrikler/günlükler için açık bir standarttır.
Giden kutusu - etki alanı olaylarının işlemsel olarak yayınlanması.
DLQ - "kırık" mesajların kuyruğu.
Örnekleme - hacim azaltma için olayların bir kısmının seçimi.
Veri İkameti - verileri istenen yargı alanında depolamak.

22) Alt satır

İyi tasarlanmış telemetri, sadece "günlük gönderme'değil, düzenlemelerle ilgilidir: katı şemalar, üzerinde anlaşmaya varılan tanımlayıcılar, varsayılan gizlilik, güvenilir ulaşım, gözlemlenebilirlik ve maliyet tasarrufu. Bu makaleyi takip ederek, öngörülebilir SLO'larla analitik, uyumluluk ve makine öğrenimi için hazır olan sürekli bir etkinlik akışı elde edersiniz.