Niyə API sorğularını qeyd etmək və izləmək vacibdir

Məqalənin tam mətni

💡 18+. Platformalar, studiyalar (RGS/live), aqreqatorlar və əlaqəli xidmətlər üçün texniki material. Oyuna çağırış deyil. «Pul yolları» dedikdə authorize/settle/credit/withdraw nəzərdə tutulur.

1) Niyə iGaming-də Logs və Trace

Pul və nüfuz. Hər hansı bir itki/dubl - birbaşa itkilər. Əməliyyatın bir dəfə keçdiyini sübut etmək lazımdır.

Tənzimləyici. Hesabat, mübahisələr, araşdırmalar - jurnal olmadan siz «kor» olursunuz.

SLO və hadisələr. Gizlilik artır? Depozit dönüşüm düşür? Treys dar bir yer göstərəcək.

Təhlükəsizlik və frod. Anormal nümunələr, repleylər, ekran hücumları - telemetriyada görünür.

Nəticə: müşahidə «son toxunuş» deyil, pul dizaynının bir hissəsidir.

2) Tam olaraq izləmək və loqo etmək nədir

2. 1 Bütün zəncir üzrə korrelyasiya

'trace _ id' - edge → domen xidmətləri → şina → konsumerlərdən sorğu üçün biri.

'span _ id' - hər bir hop üçün 'parent _ span _ id'.

Biznes açarları: 'tenant _ id/brand _ id/region', 'player _ id' (təxəllüs), 'session _ id', 'round _ id', 'bet _ id', 'settlement _ id', 'idempotency _ key'.

2. 2 Log yazmaq üçün nə (struktur)

Taymstamp ISO-8601 taymzon ilə.

üsul/yol/status, müddəti (ms), ölçüsü payload (bayt).

Nəticə və səhv sinfi ('business/4xx/5xx'), kod ('RG _ BLOCK', 'DUPLICATE', 'IDEMPOTENCY _ MISMATCH').

Host/zona/sayt versiyası, xidmət adı və mühit ('prod/eu-west-1').

Şəbəkə əlamətləri: IP/ASN (yığılmış), user-agent (kəsilmiş/normallaşdırılmış).

2. 3 Harada - qatlara görə

Edge/API gateway: autentication, rate limits, geo/bot filters.

Domenlər (Wallet/Bonus/RGS): komandalar/hadisələr, saqların statusları, gizli DB/cache.

Şin/növbələr: lag, retry, DLQ, dedup.

Kacca/PSP: authorization, 3-DS, merchant/rout.

3) Formatlar: yalnız strukturlaşdırılmış log

Pulsuz mətn axtarmaq və alertlər üçün faydasızdır. JSON sətirlərindən istifadə edin (bir giriş - bir sətir).

Nümunə (kəsilmiş):

json
{
"ts":"2025-10-23T16:21:05. 481Z",  "env":"prod",  "service":"wallet",  "version":"1. 14. 3",  "level":"INFO",  "event":"bet. settle",  "trace_id":"tr_a1b2c3",  "span_id":"sp_01",  "tenant_id":"brand-7",  "region":"EU",  "bet_id":"b_001",  "round_id":"r_8c12",  "idempotency_key":"settle_r_8c12_1",  "latency_ms":124,  "status":"credited",  "win_minor":1460,  "currency":"EUR"
}

4) Trace: Standart kimi OpenTelemetry

HTTP/gRPC/DB/cache instrumentasiyası + dastanlara xüsusi spanlar ('authorize → commit → settle → credit').

Kontekstin təbliğatı: W3C Trace Context ('traceparent', 'tracestate'), vebhuklarda - başlıqlarla.

Baqaj (baggage): yalnız PII deyil, təhlükəsiz açarlar (brand/region/trace flags).

Sampling:

default 1-10% ümumi trafik üçün, həmişə 100% pul xətası/gecikmə üçün> SLO, hadisə zamanı dinamik tətbiq.

5) WORM-audit və dəyişməzlik

Kritik hərəkətlər üçün (limitlərin dəyişdirilməsi, key-rotasiya, cekpot-konfiqlər, əl dəstəyi əməliyyatları) - WORM-saxlama (write once read many).

Tələblər: dəyişməzlik, imzalar/hash, müstəqil uyğunluq, qanuna uyğun olaraq (məsələn, 5-7 il).

6) PII və log təhlükəsizliyi

PAN, CVV, sənəd-ID, e-mail/telefon ünvanını açıq şəkildə qeyd etməyin. Maskalayın/tokenalayın.

Log-da oyunçunun psevdo identifikatorunu (stable hash) istifadə edin.

Sirlər/tokenlər heç vaxt log daxil deyil (SDK/agent səviyyəsində filtrlər).

Məlumatların rezidentliyi: bölgədə fiziki olaraq (EU/UK/BR...), fərdi giriş rolları ilə (RBAC/ABAC) jurnallar və treyslər.

Şifrələmə at-rest/in-transit, giriş - müvəqqəti tokenlər, minimal hüquqlar prinsipi.

7) Platforma saxlayan metriklər və SLO

Latency p95/p99: 'bets. authorize`, `bets. settle`, `wallet. credit`, `cashier. deposit`.

Sinif və kod üzrə Error rate.

Queue/consumer lag (şin),% retras və «fırtına».

Settle lag (nəticədən kreditə qədər), deposit success rate PSP/geo.

Webhook lag p99 mövzularda.

Alertlər - «SLO-büdcə» üzrə (pəncərə → hadisə üçün səhv/gizli büdcəni üstələdi).

8) Araşdırma və mübahisələr üçün: minimal dəsti

Cross-link 'trace _ id event_id idempotency_key settlement_id'.

Saqaların zaman statuslarının görüntüsü.

İmza/hash sorğu/webhook (qeyri-repudiation üçün).

Ekran görüntüsü/konfiqurasiya görüntüsü (bonus/cekpot qaydalarının versiyası) 'ts' tərəfindən.

9) Saxlama və dəyəri

İsti (7-14 gün): hadisələrin və postmortemlərin axtarışı.

İsti (30-90 gün): qida analitikası və qida nümunələri.

Soyuq/arxiv (≥ 1 il): hüquqi/tənzimləyici ehtiyaclar.

Filtrlər və sampling tətbiq edin, aqreqatları saxlayın, TTL və sıxışdırma daxil edin. 'trace _ id', 'tenant _ id', 'event', 'status _ code' üzrə indeksləşdirmədən istifadə edin.

10) Çek vərəqləri

Platforma/operator üçün

Hər yerdə 'trace _ id', 'idempotency _ key', tags 'tenant/brand/region' var.
Strukturlaşdırılmış JSON-log; OpenTelemetry HTTP/gRPC/DB/cache/veri yolu.
WORM-audit krit hərəkətləri; tənzimləyiciyə görə retenshen.
PII/sirlərin maskalanması; jurnallar və treyslər - regionlar üzrə.
SLO dashboard: p95/p99, error-rate, queue-lag, settle-lag, webhook-lag.
SLO büdcəsinə görə alertlər; deqradasiya zamanı avto-apsempling treys.
DR/xaoc-təlimlər: ikiqat çatdırılma, bölgənin düşməsi, cüzdan gecikməsi.
Giriş və ticarət - RBAC/ABAC, ixrac üçün «dörd göz».

Provayder üçün (RGS/live/JP)

Göndərirəm/atıram 'trace _ id' və 'idempotency _ key' bütün çağırışlara və vebhuklara.
Loqi - strukturlaşdırılmış; kod/sinif səhv qeyd olunur.
Webhucks imzalanmışdır; 'event _ id' və deduplication saxlayıram.
Tracking nəticələr/düzəliş, ölçmək 'settle _ lag'.
PII maskalanması; tokenlər/açarlar qeydlərə düşmür.
Samplingi ağlabatan edir (100% - səhvlər və pul anomaliyaları üçün).

11) Anti-nümunələr (qırmızı bayraqlar)

Struktursuz mətn qeydləri və 'trace _ id'.

Write əməliyyatlarının qeydlərində 'idempotency _ key' yoxdur.

PII/sirlərin loqosu, Bearer tokenlərinin yazılması.

Bütün bölgələri bir baketdə demarkasiyasız saxlayın.

Girit hərəkətləri üçün WORM yoxdur; «redaktə edilə bilən» auditlər.

Hadisələr outbox/CDC → «itirilmiş» əməliyyatlar keçərək dərc olunur.

Kor 100% süzgəcsiz treysinq (saxlama, səs-küy).

Heç bir SLO/alert dashboard; araşdırmalar saatlarla davam edir.

12) Addım-addım tətbiqi (real)

1. Bütün müqavilələrdə vahid 'trace _ id' və 'idempotency _ key' daxil edin (REST/gRPC/vebhuk).

2. Log 'ları JSON-a çevir; məcburi sahələr əlavə edin (xidmət, versiya, region, timstamp, kodlar).

3. OpenTelemetry və kontekstin təbliğatını birləşdirin; pul yollarında minimum treysinq.

4. SLO-daşbordları və alertləri konfiqurasiya edin; büdcələri müəyyənləşdirmək.

5. Kritik hərəkətlərin WORM auditini daxil edin; retenshen müəyyən.

6. PII/sirlərin maskalanmasını, jurnallara çıxışın fərqləndirilməsini daxil edin.

7. Xaos və təlimlər əlavə edin, postmortemləri işləyin.

8. Saxlama optimallaşdırın: sampling, TTL, arxivlər.

13) Yekun

Qeydlər və izləmə «olmaq üçün əlverişli» deyil, platforma və iGaming provayderinin silinməz vəzifəsidir. Strukturlaşdırılmış qeydlər, keçidli treyslər, WORM auditi, PII və SLO-müşahidə qorunması hadisələri idarə olunan hadisələrə, mübahisələri isə təkrarlanan hallara çevirir. Belə bir təməl üzərində pul bir dəfə hərəkət edir, hesabat hər an səsləndirilir və komanda sürətli və sakit qalır - hətta turnirlərin zirvəsində və buraxılışlar zamanı.