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.

  1. 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.

  2. 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.

  3. 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.

02

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.

ETKİLEŞİMLİ ÖRNEK · GERÇEK PROJE VERİSİ DEĞİL

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.

03

İlk adımlar

Kurulumu bir geliştirici yapabilir. Sonrasında uygulamayı normal şekilde kullanıp sonuçları birlikte inceleyebilirsin.

  1. 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. 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. 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. 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.

04

Hangi ekran, ne için?

Her ekran farklı bir soruyu yanıtlar. Kartlara tıklayarak ilgili sayfaya geçebilirsin.

Ç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.

05

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.

06

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. 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. 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. 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. 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.

07

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.
08

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.

Genel bakışa git