Son kullanıcı (tarayıcılar ve mobil uygulamalar)
Kullanıcılarınızın tarayıcı ve mobil uygulamalarının ölçtükleri burada: sayfa yüklemeleri ve uygulama açılışları, Web Vitals, session'lar, hatalar ve crash'ler, backend'e yapılan çağrılar. Her biri başlattığı backend trace'ine bağlıdır. Menü: APM → Son kullanıcı.
Başlamadan
- Bir tarayıcı ve uygulama anahtarı oluşturun: Yönetim → Entegrasyonlar › Entegrasyon ekle › Tarayıcı ve uygulama anahtarı (ayrıntı).
- Uygulamanızı rehberiyle bağlayın:
| Uygulama | Rehber |
|---|---|
| Build adımı olmayan her site | HTML / JavaScript |
| React (Vite, Next.js, Create React App) | React.js |
| React Native, Expo | React Native |
| Flutter | Flutter |
| Native Android (Kotlin, Java) | Android |
| Native iOS (Swift) | iOS |
Genel bakış
Uygulama ve Platform sayfayı daraltır. Herhangi bir tablodaki değere (bir tarayıcı, sürüm, ülke) tıklamak da tüm sayfayı ona daraltır.
- Crash'siz session'lar: crash olmayan session oranı. Kullanıcı oranı yalnız kodunuz kullanıcıyı belirtiyorsa görünür, yoksa
–. - Sayfa yüklemesi (p75) ve Uygulama açılışı (p75), soğuk ve ılık açılışlarla (Android
start.typegönderir). - Web Vitals: LCP, INP, CLS, FCP ve TTFB'nin 75. yüzdeliği ve bandı.
- Adım adım sayfa yüklemesi (DNS'ten load'a kadar, HTML loader'ından) ve Sayfanın yüklediği dosyalar (en yavaş dosyalar).
- Cihaz ve sürüme göre: cihaz türü uygulamanın söylediğidir; yoksa user agent'tan, o da yoksa ekrandan (kısa kenar 600 dp ve üstü: tablet) bulunur.
Sayfalar
Sayfalar sekmesi sayfaları route'a göre gruplar: adresteki id'ler ve uzun sayılar {id} olur, /orders/123 ile /orders/456 tek sayfadır. Sayfa başına yüklenme süresi (p50, p75, p95), Web Vitals, hatalar ve uzun görevler (sayfayı 50 ms ve üstü kilitleyen iş) görünür.
Sayfa detayında iki tablo en çok işe yarar: LCP öğeleri en büyük boyamanın hangi öğe olduğunu (ör. main > img.hero), INP hedefleri yavaş etkileşimlerin hangi öğede olduğunu söyler. En sık karşılaşılan durum: LCP'yi bozan şey sıkıştırılmamış bir hero görseli çıkıyor.
Hata ve crash grupları
Bir hatanın altındaki Bu hatayı aç grubunu açar: her cihazda aynı hata ya da crash; sayısı, session'ları, ilk ve son zamanı, sürüm, cihaz, tarayıcı ve ülkeye göre dağılımı. Örnekler en yeni olaylardır, her biri session'ı ve trace'iyle.
Sürümün sembol dosyaları Spitfire'daysa Sizin kodunuz stack'i geri çevrilmiş gösterir: küçültülmüş JavaScript (app.min.js:1:4211) kaynak dosya, satır ve fonksiyon olur; R8 ile küçültülmüş Android stack'i (a.b.a(SourceFile:2)) sınıf ve metot olur. Gönderildiği gibi ham hâlidir. Rozet kaç frame'in eşleştiğini söyler. Dosyaların okunması Starter ve üstü ister; ham stack her planda görünür.
Sembol dosyaları
Sembol dosyaları sekmesi uygulama ve sürüm başına şu dosyaları tutar:
| Dosya | Nereden |
|---|---|
JavaScript source map'leri (*.map, sürüm 3) |
bundler'ın çıktı klasörü (Vite: build.sourcemap: true; webpack: devtool: 'source-map') |
Android mapping.txt (R8 / ProGuard) |
release derlemeden sonra app/build/outputs/mapping/release/mapping.txt |
Uygulama sürümü başına en çok 50 MB; aynı adlı yeni dosya eskisinin yerine geçer. Uygulama ve sürüm, uygulamanın gönderdiğiyle aynı olmalı (service.name, service.version). iOS dSYM dosyaları okunmaz.
Sekmeden elle (yöneticiler) ya da her derlemeden sonra CI'dan bir yöneticinin API token'ıyla (kullanıcı menüsü → API token'ları) yükleyin. Her klasörden çalışır; DIST'i bundler'ın çıktı klasörü, MAPPING'i mapping dosyası yapın (biri olmayabilir):
SPITFIRE_URL='https://<spitfire>'
APP='<service-name>'
VERSION='<service-version>'
DIST="$HOME/build/<service-name>/dist"
MAPPING="$HOME/build/<service-name>/app/build/outputs/mapping/release/mapping.txt"
printf 'Spitfire API token: '; read -rs SPITFIRE_TOKEN; echo
{ find "$DIST" -type f -name '*.map' 2>/dev/null; [ -f "$MAPPING" ] && echo "$MAPPING"; } | while IFS= read -r f; do
curl -fsS -o /dev/null -X POST "$SPITFIRE_URL/api/v1/apm/eum/symbols" -H "Authorization: Bearer $SPITFIRE_TOKEN" \
-F "app=$APP" -F "version=$VERSION" -F "file=@$f" && echo "uploaded: $f" || echo "NOT uploaded: $f"
done
curl -fsS "$SPITFIRE_URL/api/v1/apm/eum/symbols?app=$APP&version=$VERSION" -H "Authorization: Bearer $SPITFIRE_TOKEN" | grep -q '"name"' \
&& echo "OK: $APP $VERSION sembol dosyaları Spitfire'da" || echo "$APP $VERSION için sembol dosyası yok: DIST, MAPPING ve token'ı kontrol edin"OK: … ile bitmeli. .map dosyalarını sitenizden sunmayın: buraya yükleyin, kaynağınız açık olmasın istiyorsanız derleme çıktısından silin.
Session'lar
Session'lar sekmesi session'ları en yeniden listeler; Hatalı olanlar / Crash olanlar ve ülke, cihaz, sürüm seçimleriyle daraltın. Başlangıç zamanına tıklayınca zaman çizelgesi açılır: görüntülemeler, tıklamalar, istekler, hatalar sırayla. Bir adımdaki Trace'i aç tarayıcı span'inden backend'in veritabanı çağrılarına kadar tüm waterfall'u gösterir.
Bir session bir tarayıcı sekmesidir ya da uygulamanın bir çalışmasıdır; Android onu arka planda 30 dakika ya da 4 saat sonra yeniler.
Ülke ve şehir
Dünya haritası ülkeleri session sayısına göre renklendirir; harita sınırları Spitfire'ın içinde gelir, hiçbir harita servisi çağrılmaz. Bir ülkeye tıklayınca bölge ve şehirleri görünür.
Spitfire ülkeyi veri gelirken gönderenin adresinden bulur, sonra adresi atar. Bunun için bir konum veritabanı dosyası (.mmdb) gerekir ve Spitfire bu dosyayla gelmez; dosya yoksa sayfa çalışır, ülke göstermez. DB-IP'nin ücretsiz IP to City Lite veritabanı çalışır (lisansı CC BY 4.0; gereken "IP Geolocation by DB-IP" yazısını Ülkeler ve şehirler sekmesi gösterir). ~/spitfire klasöründeki Docker kurulumu için:
- Bu ayın dosyasını kurulumun
geoipklasörüne indirin:
mkdir -p ~/spitfire/deploy/docker/geoip && curl -fsSL "https://download.db-ip.com/free/dbip-city-lite-$(date +%Y-%m).mmdb.gz" | gunzip > ~/spitfire/deploy/docker/geoip/dbip-city-lite.mmdb- Spitfire'a yerini söyleyin:
grep -q '^SPITFIRE_GEOIP_DB=' ~/spitfire/deploy/docker/.env || echo 'SPITFIRE_GEOIP_DB=/var/lib/spitfire/geoip/dbip-city-lite.mmdb' >> ~/spitfire/deploy/docker/.env- Controller'ı yeniden başlatın:
docker compose --project-directory ~/spitfire/deploy/docker up -d controller- Okunduğunu kontrol edin:
docker compose --project-directory ~/spitfire/deploy/docker logs controller | grep -q 'geoip: End users places addresses' && echo OKOK yazmalı. Bundan sonra gelen veri ülkeyi gösterir; önceki veri ülkesiz kalır. Biz ayda bir adım 1 ve 3'ü tekrarlamayı öneriyoruz. MaxMind GeoLite2 City dosyası da aynı şekilde çalışır (MaxMind hesabı gerekir). Kubernetes'te dosyayı controller'a mount edin ve SPITFIRE_GEOIP_DB değerini yoluna ayarlayın.
İstekler
Uygulamaların yaptığı en yeni çağrılar: adres (query string'i atılmış), durum, süre, yanıt veren backend servisi ve çalıştığı host. Uygulama başka bir adresi çağırdıysa (load balancer, gateway) üzerinden onu adlandırır. trace'lenmemiş: backend kendi trace'iyle yanıt vermedi; ya OTel'i yok ya da çağrı traceparent taşımadı.
Backend trace'inden
Tarayıcının ya da uygulamanın başlattığı bir trace, waterfall'unun üstünde Başladığı yer: satırını gösterir: uygulama, sayfa, cihaz, ülke ve kullanıcının session'ına bağlantı.
Ne saklanır, ne saklanmaz
- Gönderenin IP adresi ülke için kullanılır, saklanmaz.
- Cihaz kimlikleri ve
user.,enduser.ya dageo.ile başlayan her şey silinir. Yalnız kodunuzun bilerek koyduğuenduser.id/user.idkalır (HTML:SpitfireRUM.setUser). - Loader adresleri query string'siz gönderir.
- Tarayıcı anahtarından gelen metrikler atılır; span'ler ve loglar APM verisi kadar saklanır.
Sık karşılaşılan sorunlar
| Belirti | Çözüm |
|---|---|
| Sayfa altı rehberi gösteriyor | Aralıkta veri yok: rehberin Doğrulama adımlarına bakın, aralığı genişletin |
| Ülke yok | Ülke ve şehir; adım 4 OK yazmalı |
Ülke adım 1 404 ile duruyor |
Ay başında yeni dosya henüz çıkmamış olabilir: $(date +%Y-%m) yerine geçen ayı yazın, örn. 2026-10 |
Crash'siz kullanıcı – |
Uygulamanız kullanıcılarını belirtmiyor; varsayılan budur |
| İstekler trace'lenmemiş gösteriyor | Backend'de OTel olmalı ve çağrı traceparent taşımalı (rehberin propagate ayarı ve backend'in CORS'u) |
| Stack geri çevrilmiyor | Sürümün sembol dosyalarını yükleyin; uygulama ve sürüm, uygulamanın gönderdiğiyle aynı olmalı |
| iOS crash'leri yok | iOS paketi crash toplamaz; yakalanan hataları Otel.error ile bildirin |