Genel bakış
PayCal, Phantom Wing adlı yerleşik bir tanılama katmanı içerir. Varsayılan olarak neredeyse tamamen sessizdir: yalnızca ciddi, işlenmeyen hataları yakalar ve açık izniniz olmadan hiçbir şey göndermez.
Bir sorun yaşarsanız ve destek ekibiyle daha fazla bağlam paylaşmak isterseniz, Ayarlar - Hata ayıklama (isteğe bağlı) bölümünden ek tanılamayı etkinleştirebilirsiniz. Her ayar bağımsızdır; yalnızca ilgili olanı açabilirsiniz. Üçü de varsayılan olarak Kapalıdır.
Üç isteğe bağlı kontrol
Her kontrol, Ayarlar sayfasının altındaki Hata ayıklama (isteğe bağlı) panelindedir. Yalnızca sorun gidermek içindir; açıldığında tarayıcıda ek iş yapıldığı için etkileşimler biraz yavaşlayabilir.
| Ayar | Ne sağlar | Kim görür |
|---|---|---|
| Konsol mesajları | Uyarıları, bilgilendirici logları ve performans işaretçilerini tarayıcı geliştirici konsoluna yazar. Kendi tanınız için DevTools’u açın ve [PayCal] ile başlayan mesajları arayın. |
Yalnızca siz: tarayıcı konsolu, asla gönderilmez. |
| Ayrıntılı tanılama | Adım adım dahili olay günlüğünü açar. Phantom Wing operasyon yaşam döngülerini bellekteki bir loga alır; bu yalnızca paylaşmayı seçtiğiniz destek raporuna eklenir. | Destek raporu paylaşmadığınız sürece yalnızca siz. |
| Ağ içgörüleri | API istek sürelerini, yanıt boyutlarını ve batching ya da cache uygulanıp uygulanmadığını loglar. Belirli işlemlerde yavaşlığı tanılamaya yardım eder. | Yalnızca siz: tarayıcı konsolu, asla gönderilmez. |
Phantom Wing varsayılan olarak ne yapar
Üç kontrol kapalı olsa bile Phantom Wing yalnızca ciddi arızaları yakalayan hafif bir temel izleyici çalıştırır:
- Yakalanmamış JavaScript istisnaları (
window.onerror) - İşlenmeyen promise reddetmeleri
- Özellik bazında ele alınan HTTP hataları değil, ağ hatasıyla başarısız olan fetch çağrıları
Bu temel veri tamamen bellekte kalır ve hiçbir yere gönderilmez. Sayfa yüklenirken tarayıcı konsolunda bir saniyelik özet olarak gösterilir, sonra atılır.
// Baseline output when all clear (console, diagnostics off): [PHANTOM WING] All clear - no errors or warnings detected. // Baseline output when issues exist: [PHANTOM WING] Error Summary Total issues: 2 across 2 grouped location(s). WARN 1: FormSubmit timed out after 8000ms ERROR 1: Uncaught TypeError in calendar renderer
Phantom Wing ve telemetri
Phantom Wing, özellik güvenilirliğini toplu ölçmek için hafif bir telemetri kanalı kullanır; örneğin bir işlemin platform genelinde olağan dışı oranda başarısız olup olmadığını algılar.
Telemetri ne gönderir
- Saatlik gruplara ayrılmış anonim olay sayıları, örneğin
pw.performance.metrics: count=1, bucket_hour=2026030914 - Hata kategorisi ve türü; tam hata mesajı veya stack trace asla gönderilmez
- Kullanıcı kimliği, oturum tokenı veya IP adresi yok
Telemetri asla ne göndermez
- Adınız, e-postanız veya hesap ayrıntılarınız
- Kazanç, ödeme dönemi veya finansal veri
- Tam hata mesajları veya stack trace’ler
- URL yolları veya sorgu dizeleri
- Tuş vuruşları veya form alanı değerleri
Hız sınırı ve back-off
Telemetri gönderimleri sunucuda kullanıcı başına dakikada sınırlandırılır. İstemci eşiği aşarsa sunucu sessizce onaylar ve fazlayı atar; hiçbir şey saklanmaz. İstemci de üstel back-off uygular: art arda iki sunucu hatasından sonra telemetriyi otomatik olarak on dakika kapatır.
// Telemetry payload shape (no personal data):
{
"type": "pw.performance.metrics",
"fields": {
"count": 1,
"bucket_hour": 2026030914,
"flush_reason": "timer"
}
}
Veri redaksiyonu
Bir değer belleğe yazılmadan veya telemetriyle gönderilmeden önce Phantom Wing otomatik redaksiyon uygular. Bilinen hassas kalıplara uyan değerler [REDACTED] ile değiştirilir:
- E-posta adresleri
- Bearer tokenları ve authorization header değerleri
- CSRF tokenları
- Kriptografik anahtar veya uzun base64 blob gibi görünen dizeler
Redaksiyon, yakalanan konsol yöntemlerine verilen tüm argümanlara ve kuyruk öncesi tüm telemetri alanlarına uygulanır. Tanılama ayarları açılarak atlatılamaz.
Kapsam korumaları: tanılamanın bastırıldığı sayfalar
Telemetri gönderimi kimlik doğrulama sayfalarında (/auth/) tamamen bastırılır. Ağ içgörüleri açık olsa bile giriş, kayıt veya kurtarma akışlarında telemetri gönderilmez. Bu derinlemesine savunma, kimlik bilgilerine yakın verilerin tanılama kanallarında görünmesini önler.
Sizin kontrolünüz
Üç tanılama ayarı tarayıcı çerezi olarak değil, hesap tercihi olarak saklanır. Cihazlar ve oturumlar arasında hesabınızı izler ve yeni hesaplar dahil her hesapta varsayılan olarak Kapalıdır. Bunları istediğiniz zaman Ayarlar - Hata ayıklama (isteğe bağlı) içinde değiştirebilirsiniz.
Bir ayarı kapatmak sonraki sayfa yüklemesinde etkili olur. Oturumlar arasında tanılama verisi tutulmaz: Phantom Wing’in bellek içi logu sayfadan ayrıldığınızda veya sekmeyi kapattığınızda temizlenir.
Özet
- Üç debug kontrolü de varsayılan olarak Kapalıdır ve sizin tarafınızdan açıkça etkinleştirilmelidir
- Konsol mesajları ve Ağ içgörüleri cihazınızdan asla çıkmaz
- Ayrıntılı tanılama bellekte kalır ve yalnızca destek raporu paylaşmayı seçerseniz paylaşılır
- Telemetri yalnızca anonim, toplu olay sayıları gönderir: kişisel veri yok
- Tüm değerler depolama veya iletimden önce, ayarlardan bağımsız olarak redakte edilir
- Telemetri tüm kimlik doğrulama sayfalarında tamamen bastırılır
- Hız sınırı ve otomatik back-off yanlışlıkla aşırı raporlamayı önler
Phantom Wing, tüm tanılamayı süresiz kapalı bırakabileceğiniz şekilde tasarlanmıştır. İsteğe bağlı kontroller, bir şey ters gittiğinde sizinle destek ekibine ortak bir dil sağlamak içindir; varsayılan olarak veri toplamak için değildir.