Näme üçin API soraglaryny ýazmak we yzarlamak möhümdir?

Makalanyň doly teksti

💡 18+. Platformalar, studiýalar (RGS/live), agregatorlar we degişli hyzmatlar üçin tehniki material. Oýnamaga çagyryş ýok. "Pul ýollary" diýmek authorize/settle/credit/withdraw diýmekdir.

1) Näme üçin iGaming-de loglar we söwda etmek?

Pul we abraý. Islendik ýitgi/goşa settlement - göni ýitgiler. Operasiýanyň bir gezek geçirilendigi subut edilmeli.

Düzgünleşdiriji. Hasabat, jedeller, derňewler - magazinesurnalsyz siz "kör".

SLO we hadysalar. Gizlinlik artýarmy? Goýumyň öwrülişigi azalýarmy? Treýsler dar ýeri görkezerler.

Howpsuzlyk we iýmit. Anomal nagyşlar, repleýler, skript hüjümleri - telemetriýada görünýär.

Netije: gözegçilik etmek - "soňky çyzgy" däl-de, pul dizaýnynyň bir bölegi.

2) Nämäni yzarlamaly we logirlemeli

2. 1 Tutuş zynjyr boýunça baglanyşyk

'trace _ id' - edge → domen hyzmatlary → şina → konsumerlerden soralanda biri.

'span _ id' - her hop üçin 'parent _ span _ id'.

Iş açarlary: 'tenant _ id/brand _ id/region', 'player _ id' (lakamy), 'session _ id', 'round _ id', 'bet _ id', 'settlement _ id', 'idempotency _ key'.

2. 2 Loglarda näme ýazmaly (gurluş)

Timstamp ISO-8601 bilen çalşyryldy.

Usul/ýol/status, dowamlylygy (ms), ululygy payload (baýt).

Netije we ýalňyşlyk synpy ('business/4xx/5xx'), kod ('RG _ BLOCK', 'DUPLICATE', 'IDEMPOTENCY _ MISMATCH').

Host/zona/bild wersiýasy, hyzmatyň ady we gurşaw ('prod/eu-west-1').

Tor alamatlary: IP/ASN (agregirlenen), user-agent (kesilen/kadaly).

2. 3 Nirede - gatlaklara görä

Edge/API gateway: autentication, rate limits, geo/bot süzgüçleri.

Domenler (Wallet/Bonus/RGS): buýruklar/wakalar, saga statuslary, gizlinlik DB/kesh.

Teker/nobatlar: lag, retry, DLQ, dedup.

Kacca/PSP: awtorizasiýa, 3-DS, satyjy/rout.

3) Formatlar: diňe gurluşly loglar

Mugt tekst gözleg we alertler üçin peýdasyz. JSON setirlerini ulanyň (bir ýazgy - bir setir).

Mysal (kesilen):

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) Söwda: Standart hökmünde OpenTelemetry

HTTP/gRPC/DB/keş instrumentasiýasy + sagalara mahsus spanlar ('authorize → commit → settle → credit').

Kontekst propagandasy: W3C Trace Context ('traceparent', 'tracestate'), webhuklarda - sözbaşylar.

Bagaj: PII däl, diňe ygtybarly açarlar (brand/region/trace flags).

Sampling:

umumy trafik üçin 1-10%, elmydama pul ýalňyşlygy/gizlinlik üçin 100%> SLO, waka bolan ýagdaýynda dinamiki täzelenme.

5) WORM-audit we üýtgemezlik

Kritiki hereketler üçin (çäkleri üýtgetmek, key-rotation, jekpot-konfigi, el bilen goldaw amallary) - WORM-ammar (write once read many).

Talaplar: üýtgewsizlik, gollar/heşler, garaşsyz elýeterlilik, kanun boýunça retenşen (mysal üçin, 5-7 ýyl).

6) PII we loglaryň howpsuzlygy

Açyk görnüşde PAN, CVV, resminama-ID, e-mail/telefon goýmaň. Gizläň/belläň.

Loglarda oýunçynyň pseudo şahsyýetini (stable hash) ulanyň.

Syr/bellikler hiç haçan girmez (SDK/agent derejesinde süzgüçler).

Maglumatlaryň rezidentligi: fiziki taýdan sebitde (EU/UK/BR...), aýratyn giriş rollary bilen (RBAC/ABAC) magazinesurnallar we söwdalar.

At-rest/in-transit şifrlemek, wagtlaýyn bellikler boýunça giriş, iň az hukuklar ýörelgesi.

7) Platformany saklaýan metrikler we SLO

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

Synp we kod boýunça Error rate.

Queue/consumer lag (teker), retraýlar we "tupanlar"%.

Settle lag (netijeden karza çenli), PSP/geo boýunça deposit success rate.

Webhook lag p99 mowzuklar boýunça.

Alertler - "SLO-býudjet" boýunça (penjireden ýalňyşlyklar/gizlinlik býudjetinden geçdi → waka).

8) Derňewler we jedeller üçin: iň az toplum

Çapraz baglanyşyk 'trace _ id event_id idempotency_key settlement_id'.

Saga statuslarynyň wagt taýdan suraty.

Haýyşyň/webhukyň goly/heş (non-repudiation üçin).

Konfigurasiýanyň skrinshoty/suraty (bonus/jekpot düzgünleriniň wersiýasy) 'ts' boýunça.

9) Saklamak we bahasy

Gyzgyn (7-14 gün): hadysalary we postmortemleri gözlemek.

Yssy (30-90 gün): azyk analitikasy we frod-patternleri.

Sowuk/arhiw (≥ 1 ýyl): hukuk/kadalaşdyryjy zerurlyklar.

Süzgüçleri we samplingleri ulanyň, agregatlary saklaň, TTL we gysyşy açyň. 'trace _ id', 'tenant _ id', 'event', 'status _ code' indekslerini ulanyň.

10) Çek-listler

Platforma/operator üçin

Hemme ýerde 'trace _ id', 'idempotency _ key', bellikler 'tenant/brand/region' bar.
Gurluşly JSON-logler; HTTP/gRPC/DB/keş/tekerde OpenTelemetry.
WORM-audit girit hereketleri; düzgünleşdiriji boýunça retenşen.
PII/syrlary gizlemek; žurnallar we söwdalar - sebitler boýunça.
SLO-daşbordlar: p95/p99, error-rate, queue-lag, settle-lag, webhook-lag.
SLO-býudjet aladalary; pese gaçanda treýsleriň awto-apsemplingleri.
DR/xaoc-maşklar: goşa eltip bermek, sebitiň ýykylmagy, gapjygyň gijikdirilmegi.
Loglara we söwdalara girmek - RBAC/ABAC, eksport üçin "dört göz".

Üpjün ediji üçin (RGS/live/JP)

'trace _ id' we 'idempotency _ key' -ni ähli jaňlara we webhuklara iberýärin/zyňýaryn.
Loglar - gurluş; ýalňyşlyk kody/synpy ýazylýar.
Webhuklar gol çekildi; 'event _ id' -ni saklaýaryn.
Netijeleriň/settlmentiň yzarlamasy, ölçeýärin 'settle _ lag'.
Gizlemek PII; bellikler/açarlar girelgelere düşmeýär.
Sampling ýerlikli edýär (100% - ýalňyşlyklar we pul anomaliýalary üçin).

11) Anti-pattern (gyzyl baýdaklar)

Gurluşsyz tekst ýazgylary we 'trace _ id'.

Write amallarynda 'idempotency _ key' ýok.

PII/syrlary ýazmak, Bearer-tokenleri ýazmak.

Ähli sebitleriň logleri bir baketde bölünmezden.

Krit hereketleri üçin WORM-iň ýoklugy; "redaktirlenen" barlaglar.

Wakalar outbox/CDC → "ýitirilen" amallardan aýlanyp çap edilýär.

Kör 100% süzgüçsiz söwda (ammardaky weýrançylyk, ses).

SLO/alertleri ýok; derňewler birnäçe sagatlap dowam edýär.

12) Ädimler boýunça ornaşdyrmak (real)

1. Ähli şertnamalarda bir 'trace _ id' we 'idempotency _ key' giriň (REST/gRPC/webhuklar).

2. JSON üçin loglary terjime et; Hökmany meýdanlary goşmak (hyzmat, wersiýa, sebit, wagt stampy, kodlar).

3. "OpenTelemetry" -ni we kontekstiň propagandasyny birikdirmek; pul ýollarynda iň az treýsing.

4. SLO daşbordlaryny we alertlerini sazla; býujetleri kesgitlemek.

5. Möhüm hereketleriň WORM auditini öz içine alyň; retenşeni kesgitlemek.

6. PII/syrlary gizlemegi, magazinesurnallara girişi çäklendirmegi girizmek.

7. Kaos-wakalary we maşklary goşmak, postmortemleri işlemek.

8. Saklamagy optimizirlemek: sampling, TTL, arhiwler.

13) Jemleýji

Logi we traska "bolmak amatly" däl-de, iGaming platformasynyň we üpjün edijisiniň aýrylmaýan borjy. Gurluşly ýazgylar, ahyrky söwdalar, WORM-audit, PII we SLO-gözegçilik goragy hadysalary dolandyrylýan hadysalara, jedelleri bolsa gaýtalanýan ýagdaýlara öwürýär. Şeýle binýatda pul bir gezek hereket edýär, hasabat islendik pursatda gaýtalanýar, topar bolsa ýaryşlaryň iň ýokary derejesinde we goýberilişleriň dowamynda hem çalt we asuda bolýar.