Kullanım kılavuzu
Apiheron’u tanı, gördüğün verileri anlamlandır ve nereden başlayacağını öğren. Teknik bilgi şart değil.
UYGULAMANIN PERDE ARKASI
Ekrana gelen verinin ne kadarı gerçekten işe yarıyor?
Bir ürün listesi açtığını düşün. Uygulama, sunucudan bilgi ister; buna API isteği denir. Apiheron bu alışverişi gözlemler: ne kadar bekledin, ne kadar veri geldi ve uygulamanın kodu hangi bilgileri okudu? Böylece geliştiricin nerede gereksiz yük veya gecikme olabileceğini görür.
- 01
Sen uygulamayı kullanırsın
Bağlantı kurulduktan sonra sayfaları açar, filtreleri dener, detaylara girersin. Tarayıcıdaki küçük izleme aracı (SDK) bu kullanımı kaydeder.
- 02
Apiheron gözlemleri birleştirir
İsteklerin süresini, yanıt boyutunu ve okunan alanları karşılaştırır. İncelenmesi gereken durumları “bulgu” olarak gösterir.
- 03
Ekibin iyileştirir ve tekrar dener
Bulgudaki kanıtı geliştiricin inceler. Kodu düzelttikten sonra aynı işlemleri tekrar yapıp yeni ölçümleri karşılaştırırsınız.
Görerek öğren
Sunucu 10 bilgi gönderiyor. Aşağıdaki iki görünüme tıkla; uygulamanın okuduğu bilgiler ve Apiheron’un yorumu değişsin.
Sunucudan gelen 10 bilgi
- Ad
- Fiyat
- Stok
- Açıklama
- Kategori
- Tedarikçi
- Ağırlık
- Barkod
- Oluşturulma
- Güncellenme
✓ İşaretli: kod tarafından okundu. Boş kutu: bu örnekte okunmadı.
Ürün listesi
Seramik kupa
250 TL
10 bilginin 2 tanesi okundu
Liste yalnızca ad ve fiyatı okudu. Diğer 8 bilgi bu kullanımda okunmadı: daha küçük bir yanıt yeterli olabilir.
Akılda tut: “okunmadı”, “sil” demek değildir. Gerçek bulguların istek ve oturum sayısına bak; karar vermeden önce farklı ekranları ve işlemleri dene. Kodun bir alanı okuması, o alanın ekranda gösterildiği anlamına da gelmez.
İlk adımlar
Kurulumu bir geliştirici yapabilir. Sonrasında uygulamayı normal şekilde kullanıp sonuçları birlikte inceleyebilirsin.
- 1
Uygulamayı bağla
Yönetici, Projeler’den bir proje oluşturur ve uygulamanın açıldığı adresi izinli origin olarak ekler. Geliştirici proje sayfasındaki kurulum kodunu ekler; axios kullanılıyorsa onun bağlantısını da yapar.
- 2
Gerçek bir işlem yap
Kılavuzu değil, izlenen uygulamanı aç. Bir listeye gir, ara, filtrele ve bir kaydın detayını aç. Yalnızca ziyaret ettiğin akışlar hakkında veri birikir.
- 3
Doğru proje ve aralığı seç
Soldan projenin adını seç. Veri ekranlarında üst çubuktaki range alanından zaman aralığını ayarla. Genel bakış ile başla, ardından Bulgular’dan bir endpoint’in ayrıntısına gir.
- 4
Düzelt, aynı işlemi tekrar dene
Geliştiricin değişiklik yaptıktan sonra aynı akışı yeniden dene. Yeni denemeyi kapsayan bir zaman aralığında süreye, boyuta ve bulgulara bak; eski ölçümleri karıştırmamaya dikkat et.
Görüntüleyici verileri okuyabilir. Geliştirici bulgular üzerinde işlem yapabilir. Proje, üye ve entegrasyon ayarları için yönetici veya sahip rolü gerekir.
Hangi ekran, ne için?
Her ekran farklı bir soruyu yanıtlar. Kartlara tıklayarak ilgili sayfaya geçebilirsin.
Genel durum nasıl?
Genel bakış
İstek sayısı, süreler, hatalar ve zaman içindeki trafik. İncelemeye başlamak için ilk durak.
Önce neye bakalım?
Bulgular
Olası sorunlar önem ve türüne göre gruplanır. Bir endpoint’e tıkla, neden işaretlendiğini incele.
Hangi veri adresi sorunlu?
Endpoint’ler
Aynı işi yapan istekler bir arada. Detayda Alanlar, Dönüşümler ve İstekler bölümleriyle kanıta in.
Tek bir istekte ne olmuş?
İstekler
Her çağrının adresi, durumu, süresi ve varsa hangi sayfadan geldiği. Belirli bir denemeyi araştırmak için.
Veri nasıl bağlanır?
Projeler
Kurulum kodu, bağlantı durumu, izinli adresler ve veri gönderme anahtarları burada.
Sonucu nasıl işe dönüştürürüz?
Entegrasyonlar
İsteğe bağlı AI önerileri ve Papyro görev kartları. Bağlandıktan sonra endpoint’in Aksiyonlar bölümünden kullanılır.
Çalışma alanında Organizasyon ekip alanını, Üyeler erişim rollerini yönetir. Denetim kaydı yetkili kişilere kimin hangi değişikliği yaptığını gösterir. Hesap menüsünden dil, tema ve kişisel ayarlarına ulaşırsın.
Bulguyu aksiyona çevir
Bulgu, incelenmesi gereken bir işarettir. Önce örneği ve gözlem sayısını oku, sonra geliştiricinle karar ver.
Over-fetch: fazla veri taşınıyor olabilir
Bir listede yalnızca adlar gerekirken yüzlerce kayıt veya okunmayan alan geliyor.
Sonraki adım: Alanlar ve Dönüşümler bölümünde neyin okunduğuna, neyin filtrelendiğine bak.
Aynı iş tekrarlanıyor olabilir
Aynı istek kısa aralıklarla tekrarlanıyor (duplicate request) ya da aynı veri farklı cache (önbellek) anahtarlarıyla tutuluyor.
Sonraki adım: İsteklerin zamanını ve kaynağını incele; development (geliştirme) ortamına özgü tekrarları ayır.
Waterfall: istekler birbirini bekliyor olabilir
Arka arkaya başlayan istekler ekranın hazır olmasını geciktirebilir. Zamanlama tek başına bağımlılığı kanıtlamaz.
Sonraki adım: Geliştiricin çağrıların gerçekten sırayla çalışması gerekip gerekmediğini kontrol etsin.
Yanıtta hassas bir alan olabilir
password veya api_key gibi bir credential (kimlik bilgisi) alan adı görülmüş olabilir. Bu, alanın değerinin incelendiği anlamına gelmez.
Sonraki adım: Geliştiricin bu bilginin tarayıcıya gönderilmesinin gerekli olup olmadığını kontrol etsin.
Önem ve sayıları nasıl okumalı?
Yüksek önemlilerle başla; Orta grubunu ardından incele. “Yalnızca dev” bulguları development ortamına özgüdür ve ana bulgu sayısına girmez. Bir geliştirici bulguyu gerekçesiyle susturabilir veya yanlış pozitif olarak işaretleyebilir; Susturulan bölümünden bulup endpoint sayfasında geri alabilir.
Bir bulgu = bir endpoint + bir sorun türü. Aynı durum 20 kez tekrarlansa da tek bulgu sayılır; tekrar sayısı ayrıca gösterilir. “Bulgu yok” yalnızca eldeki gözlemlerde bir kuralın tetiklenmediğini söyler.
Bir değişikliği baştan sona inceleyin
Apiheron’u kanıt toplamak, bulguyu incelemek ve değişiklik sonrasında sonucu kontrol etmek için kullanın.
1. Bulguyu seçin
Yüksek öncelikli bulgulardan başlayın. İş atamadan önce ilgili endpoint’i açıp kaydedilen kanıtı inceleyin.
Bulguları aç2. Kanıtı inceleyin
Endpoint’in Fields bölümünde gözlemlenen okumaları, ilgili sayfa, senaryo ve call site’ları görün. Eksik veya bilinmeyen tracking, bir field’ın kullanılmadığını kanıtlamaz.
Endpoint’leri aç3. Papyro kartı açın
Entegrasyon bağlıysa endpoint’in İşlemler bölümünden Papyro kartı açın. İş atama ve teslim durumunu Papyro’da takip edin; Apiheron notları teknik incelemeyi destekler.
Bulguları aç4. Düzeltmeyi doğrulayın
Aynı endpoint içinde Düzeltmeyi doğrula bölümünü açın. Baseline ve current release’i aynı etkileşimlerle karşılaştırın. Yeterli kayıt yoksa eksik olan bilgi açıklanır. Yeni yüksek öncelikli bulgular ve regression’lar genel bakışta kısa bir özet olarak görünür.
Endpoint seç
Gelişmiş inceleme ve proje ayarları
Karmaşık sorunlarda Requests ekranından gelişmiş session incelemesini açın. Senaryo kaydı isteğe bağlıdır: işe bir ad verin, etkileşimleri kaydedin ve değişiklikten sonra tekrarlayın. SDK’daki release etiketi build’i tanımlar.
Session inceleİzlenen uygulamanın browser console’unda isteğe bağlı örnek (SDK bağlı olmalıdır): ilk satırı çalıştırın, işlemleri yapın, ardından ikinci satırla kaydı bitirin.
window.apiheron.startScenario("checkout");
window.apiheron.endScenario();Projection ve API/MCP kontrolleri gelişmiş proje ayarlarındadır. API/MCP varsayılan olarak kapalıdır; yalnızca ana Admin açabilir. Bu araçlar isteğe bağlıdır; günlük akış için gerekli değildir.
Küçük sözlük
Bu kelimelerle karşılaştığında buraya dönebilirsin. Ekranlardaki ? simgeleri de ilgili ölçümü açıklar.
- API
- Uygulamanın sunucudan bilgi istemek veya bir işlem yaptırmak için kullandığı iletişim yolu. Restorandaki sipariş hattı gibi.
- Endpoint
- Bu iletişimde belirli bir işin adresi. Örneğin /api/products ürünleri getirebilir; aynı adrese yapılan çağrılar birlikte incelenir.
- İstek ve yanıt
- “Ürünleri getir” bir istek, geri gelen ürün bilgileri yanıttır. Sayfayı tekrar açmak yeni bir istek oluşturabilir.
- Alan
- Yanıttaki bir bilgi parçası: ürün adı, fiyat veya stok gibi. Apiheron kodun bunları okuyup okumadığını izler.
- Oturum
- SDK’nın gözlemleri bir arada tuttuğu tarayıcı kullanım grubu. Bulgudaki oturum sayısı, gözlemin kaç ayrı kullanımda görüldüğünü anlamana yardım eder; kişi sayısı değildir.
- Süre · p50 · p95
- Süre, tarayıcıdaki isteğin başlayıp yanıtın inmesine kadar geçen zamandır. 1.000 ms = 1 saniye. p50’de isteklerin yarısı, p95’te %95’i gösterilen sürede bitmiştir.
- Yanıt boyutu
- Gelen JSON verisinin sıkıştırılmamış büyüklüğü. Büyük bir payload (veri yükü) daha fazla veri demektir; ağda compression (sıkıştırma) ile daha küçük taşınmış olabilir.
- Error rate (hata oranı)
- Hatalı durum koduyla dönen isteklerin toplam içindeki payı. Süresi dolmuş giriş veya bulunamayan kayıt da neden olabilir; ayrıntıdaki durum koduna bak.
Aklına takılanlar
Kısa yanıtı görmek için bir soruyu aç.
Hiç veri görünmüyor. Nereden başlamalıyım?
Doğru projenin seçili olduğunu kontrol et ve veri ekranında zaman aralığını genişlet. İzlenen uygulamada birkaç işlem yap. Hâlâ boşsa Projeler’den proje detayına girip Bağlantı durumu ve Sorun giderme bölümünü geliştiricinle kontrol et; script, anahtar, izinli adres ve axios bağlantısı olası nedenlerdir.
Apiheron hangi bilgileri kaydeder?
Yanıt değerleri yerine alan adları ve yolları, kayıt sayıları, okuma bilgisi, süre ve boyut gibi ölçümleri toplar. İstek adresi ve sorgu parametreleri gibi bilgiler de kayıtlarda bulunabilir. Veriler bağlı olduğun Apiheron sunucusunda saklanır. İsteğe bağlı AI veya Papyro aksiyonlarında ilgili özet bu hizmetlere gönderilir.
Sorunları kendiliğinden düzeltir mi?
Hayır. Apiheron ölçer ve işaretler; kodu geliştiricin değiştirir. AI bağlantısı varsa öneri isteyebilir, Papyro bağlantısı varsa görev kartı açabilirsin. Bu aksiyonlar için geliştirici veya daha yüksek rol gerekir.
“Okunmayan” alanları kaldırmalı mıyız?
Yalnızca bu gözleme bakarak kaldırmayın. Alan farklı bir sayfada, filtrede veya kullanıcı işleminde okunabilir. Önce yeterli akışı dene, istek ve oturum sayısını kontrol et; ardından geliştiricin kullanım yerlerini doğrulasın.
Bazı ayarları neden değiştiremiyorum?
Yetkiler organizasyondaki rolüne bağlıdır. Görüntüleyici yalnızca okur; geliştirici bulgularla çalışır; yönetici proje, üye ve entegrasyonları yönetir. Rol değişikliği için yöneticine başvur.
İlk tur: bir ekran, bir bulgu, bir kontrol.
Genel bakışı aç, bir bulguyu seç ve arkasındaki gözlemi incele.