API isteklerini günlüğe kaydetmek ve izlemek neden önemlidir?

Tam makale

💡 18+. Platformlar, stüdyolar (RGS/canlı), toplayıcılar ve ilgili hizmetler için teknik malzeme. Oynamak için bir çağrı değil. "Para yolları'ile yetkilendirmek/yerleşmek/kredi/içinde demek istiyoruz.

1) Neden iGaming'de günlükler ve izleme bile

Para ve itibar. Anlaşmanın herhangi bir kaybı/iki katı doğrudan kayıptır. Operasyonun bir kez yapıldığına dair kanıta ihtiyacımız var.

Düzenleyici. Raporlama, anlaşmazlıklar, soruşturmalar - dergiler olmadan "körsünüz".

SLO'lar ve olaylar. Gecikme artıyor mu? Depozito dönüşümü düşüyor mu? Yollar bir darboğaz gösterecek.

Güvenlik ve dolandırıcılık. Anormal modeller, tekrarlar, komut dosyası saldırıları telemetride görülebilir.

Sonuç: Gözlemlenebilirlik, "son dokunuş'değil, para tasarımının bir parçasıdır.

2) Tam olarak neyin izlenmesi ve günlüğe kaydedilmesi

2. 1 Zincir çapında korelasyon

'trace _ id' - edge'den gelen her istek için bir tane> domain servisleri> bus> tüketiciler.

'span _ id' - her atlama için, 'parent _ span _ id'ile.

İş anahtarları: 'tenant _ id/brand _ id/region', 'player _ id' (alias), 'session _ id', 'round _ id', 'bet _ id', 'settlement _ id', 'idempotency _ key'.

2. 2 Günlüklere ne yazılacağı (yapı)

Zaman damgası saat dilimiyle ISO-8601.

Yöntem/yol/durum, süre (ms), yük boyutu (bayt).

Sonuç ve hata sınıfı ('business/4xx/5xx'), kod ('RG _ BLOCK', 'DUPLICATE', 'IDEMPOTENCY _ MISMATCH').

Ana bilgisayar/bölge/yapı sürümü, hizmet adı ve çevre ('prod/eu-west-1').

Ağ özellikleri: IP/ASN (toplu), kullanıcı aracısı (kesilmiş/normalleştirilmiş).

2. 3 Nerede - katmanlara göre

Kenar/API ağ geçidi: kimlik doğrulama, hız sınırları, geo/bot filtreleri.

Etki Alanları (Cüzdan/Bonus/RGS): komutlar/olaylar, saga durumları, veritabanı/önbellek gecikmesi.

Veri yolu/kuyruklar: gecikme, yeniden deneme, DLQ, deadup.

Kacca/PSP: yetkiler, 3-DS, satıcı/rota.

3) Formatlar: yalnızca yapılandırılmış günlükler

Ücretsiz metin, arama ve uyarılar için işe yaramaz. JSON dizelerini kullanın (bir giriş - bir dize).

Örnek (kesilmiş):

Json
{
"ts ":" 2025-10-23T16: 21:05. 481Z," "env ":" prod", "service ":" wallet", "version":" 1. 14. 3", "level ":" INFO", "event":" bet. Settle ","  " "  " " "bölge": "AB", " " ","  "," statü ":" kredili ","  "," para birimi ":" EUR "
}

4) İzleme: Standart olarak OpenTelemetry

HTTP/gRPC/DB/cache instrumentation + saga'lar üzerinde özel açılımlar ('yetkilendirmek> taahhüt etmek> yerleşmek> kredi').

Bağlam yayılımı: W3C Trace Context ('traceparent', 'tracestate'), webhooks - başlıklarda.

Bagaj: Sadece marka/bölge/iz bayrakları, PII değil.

Örnekleme:

Toplam trafik için varsayılan %1-10, parasal hata/gecikme> SLO için her zaman %100, olay üzerinde dinamik upsampling.

5) WORM denetimi ve değişmezliği

Kritik eylemler için (sınırların değiştirilmesi, anahtar döndürme, jackpot yapılandırmaları, manuel destek işlemleri) - WORM depolama (bir kez yazma çok okuma).

Gereksinimler: değişmezlik, imzalar/karmalar, bağımsız uyum erişimi, yasalarla elde tutma (örneğin, 5-7 yıl).

6) PII ve günlük güvenliği

PAN, CVV, document-ID, e-posta/telefon açık metin olarak oturum açmayın. Maske/tokenize.

Günlüklerde, oyuncunun sözde tanımlayıcısını (kararlı karma) kullanın.

Sırlar/belirteçler asla günlüğe girmez (SDK/ajan seviyesindeki filtreler).

Veri ikametgahı: Bölgede fiziksel olarak dergiler ve izler (AB/İngiltere/BR...), ayrı erişim rolleri (RBAC/ABAC).

Dinlenme/transit sırasında şifreleme, geçici belirteçlerle erişim, minimum haklar ilkesi.

7) Platformu tutan metrikler ve SLO'lar

Anahtar bitiş noktalarına göre gecikme süresi p95/p99: 'bahisler. ',' bahislerini yetkilendirir. Settle ',' cüzdan. Kredi ',' kasiyer. depozito '.

Sınıf ve koda göre hata oranı.

Kuyruk/tüketici gecikmesi (lastik), geri çekilmelerin ve "fırtınaların" yüzdesi.

Yerleşme gecikmesi (sonuçtan krediye), PSP/geo tarafından mevduat başarı oranı.

Webhook lag p99 konuya göre.

Uyarılar - "SLO bütçesine" göre (pencere için hata/gecikme bütçesini aştı) olay).

8) Soruşturma ve Uyuşmazlıklar İçin: Asgari Alım

Çapraz referans 'trace _ id .

Sagas durumlarının zaman anlık görüntüsü.

İsteğin/webhook'un imzası/hash'i (reddetmemek için).

Yapılandırmanın ekran görüntüsü/anlık görüntüsü (bonus/jackpot kurallarının sürümü)'t'tarafından.

9) Depolama ve maliyet

Sıcak (7-14 gün): olayları ve post-mortemleri arayın.

Sıcak (30-90 gün): ürün analizi ve dolandırıcılık modelleri.

Soğuk/arşiv (≥ 1 yıl): yasal/düzenleyici ihtiyaçlar.

Filtreler ve örnekleme uygulayın, üniteleri saklayın, TTL'yi açın ve sıkıştırın. Dizinlemeyi 'trace _ id', 'tenant _ id','olay ',' status _ code 'için kullanın.

10) Kontrol listeleri

Platform/operatör için

Her yerde 'trace _ id', 'idempotency _ key', etiketler 'kiracı/marka/bölge' vardır.
Yapılandırılmış JSON günlükleri; HTTP/gRPC/DB/cache/bus üzerinde OpenTelemetry.
Girit eylemlerinin WORM denetimi; Düzenleme ile elde tutma.
PII/gizli maskeleme; Dergiler ve yollar - bölgeye göre.
SLO gösterge panoları: p95/p99, hata oranı, kuyruk gecikmesi, yerleşme gecikmesi, webhook gecikmesi.
SLO bütçesiyle ilgili uyarılar; Bozulma altında otomatik örnekleme izleri.
DR/xaoc egzersizleri: çift teslimat, bölge düşüşü, cüzdan gecikmesi.
Günlüklere ve izlere erişim - RBAC/ABAC, ihracat için "dört göz".

Sağlayıcı için (RGS/canlı/JP)

Tüm aramalara ve webhook'lara 'trace _ id've' idempotency _ key 'gönder/tarat.
Günlükler - yapılandırılmış; hata kodu/sınıfı işlenir.
Webhooks imzaladı; 'Event _ id've veri tekilleştirmeyi saklıyorum.
Sonucu/anlaşmayı izleyin, 'settle _ lag' değerini ölçün.
PII maskeleme; Belirteçler/anahtarlar kaydedilmez.
Örneklemeyi makul buluyorum (hatalar ve parasal anomaliler için %100).

11) Anti-desenler (kırmızı bayraklar)

Yapısı ve 'trace _ id' olmayan metin günlükleri.

Yazma işlemlerinin günlüklerinde 'idempotency _ key' yokluğu.

PII/sırları günlüğe kaydetme, Bearer belirteçleri yazma.

Ayrım yapmadan tüm bölgelerin günlükleri bir kovada.

Girit faaliyetleri için WORM eksikliği; "düzenlenebilir" denetimler.

Olaylar giden kutusu/CDC - "kayıp" işlemleri atlayarak gönderilir.

Filtresiz kör %100 izleme (depolama harabiyeti, gürültü).

Hiçbir panoları SLO/uyarı; Araştırmalar saatlerce sürüyor.

12) Adımlarla uygulama (gerçekçi)

1. Tüm sözleşmelere tek bir 'trace _ id've' idempotency _ key 'girin (REST/gRPC/webhooks).

2. Günlükleri JSON'a çevirin; Gerekli alanları ekleyin (hizmet, sürüm, bölge, zaman damgası, kodlar).

3. OpenTelemetry ve bağlam yayılımını bağlayın; Para yolları için minimum izleme.

4. SLO panolarını ve uyarılarını yapılandırın; bütçeleri tanımlayın.

5. Kritik eylemlerin WORM denetimini etkinleştirmek; elde tutmayı belirler.

6. PII/gizli maskeleme, günlük erişim kısıtlamasını tanıtın.

7. Kaos vakaları ve egzersizleri ekleyin, post-mortemleri uygulayın.

8. Depolamayı optimize edin: örnekleme, TTL, arşivler.

13) Alt satır

Günlükler ve izleme "sahip olmak için uygun'değil, platformun ve iGaming sağlayıcısının geri alınamaz bir yükümlülüğüdür. Yapılandırılmış günlükler, uçtan uca yollar, WORM denetimi, PII koruması ve SLO gözlemlenebilirliği olayları yönetilebilir olaylara ve anlaşmazlıkları tekrarlanabilir durumlara dönüştürür. Böyle bir vakıfta, para bir kez hareket eder, raporlama herhangi bir zamanda yeniden üretilir ve takım hızlı ve sakin kalır - turnuvaların zirvesinde ve sürümler sırasında bile.