İçeriğe geç

ISP, Datacenter ve Gaming'de her log kaydı bir bağlantıdır, tek bir istek değil: kayıt bağlantı kapandığında yazılır. Düz HTTP'de tek bir keep-alive bağlantı birden çok istek taşıyabilir; request alanı yalnızca ilkini gösterir. Hâlâ açık olan bir bağlantı kapanana kadar listede görünmez.

Her kayıt, hizmet tipinden bağımsız olarak aynı sabit anahtar kümesiyle döner; değeri olmayan anahtar null'dır, hiç eksik gelmez. ISP ailesine özel anahtarlar Mobile/Residential kayıtlarında her zaman null, statusCode ise ISP ailesinde her zaman null'dır. Liste en yeni kayıttan eskiye sıralıdır.

Üç tuzak

Alanlar

✓ bu tipte dolu gelir, null bu tipte her zaman boştur. ✓ olan bir alan da o bağlantı için değer kaydedilmediyse null olabilir.

AlanISP ailesiMobile / ResidentialAnlamı
id✓✓Kaydın kimliği. ISP ailesinde requestId ile aynıdır (ULID); 17.09.2026 öncesi kayıtlarda kararlı, türetilmiş bir kimliktir.
timestamp✓✓ISO-8601, UTC. ISP ailesinde bağlantının KAPANDIĞI an, saniye çözünürlüğünde. Liste en yeniden eskiye sıralıdır.
level✓✓connect, disconnect, error, quota ya da auth. ISP ailesinde result'tan türetilir (sonuç kodları tablosu).
message✓✓İnsan okunur özet, ör. HTTP CONNECT → example.com:443. ISP ailesinde bağlantı bilgisi olmayan başarısız kayıtlarda okunur açıklama ve sonuç kodudur (ör. This command/protocol is not supported (#103)). Biçimi değişebilir; ayrıştırmayın, ilgili alanları okuyun.
method✓✓Komut ya da HTTP metodu: CONNECT, GET, POST … ISP ailesinde command ile aynıdır (UDP ASSOCIATE dahil). Bağlantı o aşamaya gelmeden reddedildiyse null.
ip✓✓Hedef, host:port biçiminde (ana bilgisayar adı yoksa IP). Hedef belirlenmeden reddedilen bağlantıda null.
sourceIp✓✓İstemcinizin IP'si; proxy'ye bağlanan makine.
bytesIn✓✓İNDİRİLEN bayt (hedeften size).
bytesOut✓✓YÜKLENEN bayt (sizden hedefe).
durationMs✓✓Bağlantının açık kaldığı süre, ms. Gecikme DEĞİLDİR.
statusCodenull✓HTTP durum kodu. Yalnızca Mobile/Residential.
headersnull✓İsteğin HTTP başlıkları (JSON metni). Yalnızca Mobile/Residential.
requestId✓nullBağlantının benzersiz kimliği (26 karakterlik ULID). Destek talebinde bunu iletin. 17.09.2026 öncesi kayıtlarda null.
result✓nullSonuç kodu (aşağıdaki tablo). 17.09.2026 öncesi kayıtlarda null.
resultCategory✓nullsuccess, client, policy, upstream ya da unknown. result null ise ok'tan türetilir: success ya da unknown.
ok✓nullBağlantı başarılı mı (true / false).
errorCode✓nullresult'un 5 haneli metin hâli, ör. 00104 (başarıda 00000). result null ise null.
service✓nullGerçekte konuşulan protokol: http ya da socks (SOCKS5). auto protokolde aynı port ikisini de kabul eder. Bağlantı o aşamaya gelmeden reddedildiyse null.
proxyType✓nullEski ad; service ile aynı değer.
command✓nullCONNECT, GET, POST … ya da UDP ASSOCIATE (SOCKS5 üzerinden UDP; auto protokolde desteklenir). Bağlantı o aşamaya gelmeden reddedildiyse null.
request✓nullBağlantıdaki İLK istek satırı. Keep-alive bağlantıda yalnızca ilki yazılır. İstek okunmadan reddedildiyse null.
targetHost✓nullHedef ana bilgisayar adı (doğrudan IP'ye bağlanıldıysa IP). Hedef belirlenmeden reddedildiyse null.
targetIp✓nullHedefin çözümlenen IP'si. Hedefe bağlanılmadıysa null.
targetPort✓nullHedef port. Hedef belirlenmeden reddedildiyse null.
targetInfo✓nullEski biçim: targetIp:targetPort.
clientPort✓nullİstemcinizin kaynak portu.
gateIp✓nullBağlandığınız proxy (giriş) adresi; genellikle proxy listesindeki host. Çıkış IP'niz DEĞİLDİR.
gatePort✓nullBağlandığınız proxy portu.
egressIp✓nullTrafiğinizin internete çıktığı GERÇEK IP; hedef sitenin gördüğü adres. Her bağlantıda kaydedilmez, yoksa null (17.09.2026 öncesi kayıtlarda her zaman null).
extIp✓nullEski ad; egressIp ile aynı değer.
latencyMs✓nullHedefe bağlanma gecikmesi, ms. Ölçülmediyse null; 0 değildir.
totalBytes✓nullbytesIn + bytesOut.
slot✓nullSiparişin port slot numarası. 17.09.2026 öncesi kayıtlarda null.

Sonuç kodları

Yalnızca ISP, Datacenter ve Gaming. Açıklamalar müşterilerinize gösterebileceğiniz metinlerdir. Yeni kodlar eklenebilir; bilinmeyen kodu hata olarak ele alın.

resulterrorCodeHTTPKategorilevelAnlamı
000000200successconnectBağlantı başarılı
10000100407clientauthKullanıcı adı veya şifre hatalı
10100101403clientauthIP adresiniz bu sipariş için yetkili değil
10200102400clienterrorİstek formatı hatalı
10300103—clienterrorBu komut/protokol desteklenmiyor
10400104403policyerrorHedef adrese girmeye izniniz yok
10500105403policyquotaKota doldu
10600106429policyquotaBağlantı limiti doldu
10700107403policyerrorHedef port engellendi
20000200502upstreamerrorHedef sunucuya ulaşılamadı
20100201—clientdisconnectBağlantı istemci tarafından kapatıldı (hizmet hatası değildir)
———unknownerrorTanınmayan kod; hata olarak ele alın

Sonuç kategorileri

resultCategoryAnlamı
successBağlantı kuruldu.
clientİstemci tarafı kaynaklı: kimlik bilgisi ya da IP yetkisi, istek biçimi, desteklenmeyen komut ya da bağlantının istemci tarafından kapatılması.
policyKullanım politikası ya da hesap limiti: engelli hedef, kota, eşzamanlı bağlantı, kapalı port.
upstreamHedefe bağlanılamadı; tekrar deneyin.
unknownTanınmayan kod (ya da 17.09.2026 öncesine ait, başarısız bir kayıt).

Filtreleme

ok, result, category, request_id, client_ip, egress_ip, target_host, service,udp, slot, port ve min_latency_ms yalnızca bu tiplerde geçerlidir. status_group burada 400 döner.

status_group (2xx, 4xx, 5xx) yalnızca bu tiplerde geçerlidir. ip burada hedef ya da istemci adresinin içinde aranır. ISP ailesine özel bir parametre göndermek 400 invalid_request döner; details.field parametreyi söyler.

Bilinmeyen bir parametre ya da başlangıcı bitişinden sonra olan bir tarih aralığı da 400 döner. Tüm parametrelerLoglar uç noktasında.

Eksik liste

meta.partial her yanıtta döner. true ise liste eksik olabilir: ISP ailesinde eski kayıtlar o an okunamamıştır, Mobile/Residential'da yalnızca en son kayıtlar dönmüştür. Biraz sonra yeniden deneyin. Log deposuna geçici olarak ulaşılamazsa 503 service_unavailable döner.

17.09.2026 öncesi kayıtlar

Eski log sistemindeki kayıtlar nasıl döner

ISP, Datacenter ve Gaming log sistemi 17.09.2026'da yenilendi. Daha eski kayıtlar da listede döner (yeni kayıtlardan sonra), ancak o sistemde olmayan alanlar null'dır:requestId, result, errorCode, egressIp, extIp, latencyMs ve slot. Bu kayıtlarda levelyalnızca connect ya da error, resultCategory yalnızca success ya da unknown olur; id kararlı, türetilmiş bir kimliktir.

Yalnızca yeni sistemdeki alanlara dayanan filtreler (ok, result, category, request_id, egress_ip, target_host,udp, slot, port, min_latency_ms) ve ip parametresindeki parça aramalar yalnızca 17.09.2026 ve sonrasındaki kayıtları döndürür. Log zaman çizelgesi ve hizmet detayındaki kullanım sayaçları da yalnızca yeni sistemi kapsar.

Eski kayıtlar o an okunamazsa yanıt yine döner ama meta.partial true olur. Aynı durumda kullanım geçmişinde meta.available false gelir.

Geriye uyumsuz değişiklikler
  • extIp artık gerçek çıkış IP'sidir (egressIp ile aynı). Eskiden bağlandığınız proxy adresini taşıyordu; o adres artık gateIp + gatePort'ta.
  • parentInfo kaldırıldı.
  • ISP kayıtlarında id artık requestId'dir (ULID).
  • timestamp artık bağlantının KAPANDIĞI andır ve saniye çözünürlüğündedir.
  • level artık auth, quota ve disconnect değerlerini de alır.
  • Her kayıt aynı sabit anahtar kümesiyle döner. Yeni anahtarlar eklendi: requestId, result, gateIp, egressIp, latencyMs ve diğerleri.
  • proxyType artık yalnızca http ya da socks olur (service ile aynı); tanınmayan değer null döner.
  • ISP ailesinde kullanım uçlarının source değeri artık logs'tur.
  • Mobile/Residential loglarında bytesIn ve bytesOut yer değiştirmiş dönüyordu. Artık her tipte bytesIn indirilen, bytesOut yüklenen bayttır (geçmiş kayıtlar dahil).

Destek talebinde requestId verin

Bir bağlantıyla ilgili yardım istediğinizde o kaydın requestId değerini iletin; destek ekibi tam o bağlantıyı bununla bulur. Aynı bağlantıyı request_id parametresiyle kendiniz de sorgulayabilirsiniz. Bu, hata yanıtlarındaki request_id değildir: o sizin API isteğinizi, bu bir proxy bağlantısını tanımlar.

ÖncekiKullanım verisiSonrakiHatalar