İçeriğe atla
SinaptikLabAI KNOWLEDGE PLATFORM
RehberOrtaGözlemlenebilirlik

LLM gözlemlenebilirliği kurmak

LLM gözlemlenebilirliği, her kullanıcı isteğini uçtan uca tek bir ize bağlayıp iz içindeki her adımı — geri getirme, model çağrısı, araç çağrısı, yeniden deneme — kendi süre, token ve sonuç alanlarıyla kaydetmekle kurulur. Gecikmeyi ortalamayla değil p50 ve p95 ile birlikte raporlayın; ortalama, kullanıcının şikâyet ettiği kuyruğu gizler. Uyarı eşiğini de mutlak bir sayıdan değil kendi taban çizginizden türetin: eşik koymadan önce en az bir hafta taban ölçüm toplayın.

ÖNKOŞULLAR

  • Uygulama koduna dokunma yetkisi — ölçüm, çağrı yerlerine alan eklemeden kurulmaz
  • İstek başına bağıntı kimliği üretebilen bir giriş katmanı veya ara katman
  • Kayıtların ne kadar saklanacağına ve kişisel veri içerip içermeyeceğine dair verilmiş bir karar
  • Uyarıya cevap verecek bir nöbet veya sahiplik düzeni; sahipsiz uyarı kurulmaz

GEREKEN ARAÇLAR

  • İz kaydı (tracing) toplayıcısı ve iz saklama alanı
  • Zaman serisi ölçüm deposu
  • Pano ve uyarı aracı
  • Sağlayıcı kullanım alanlarını okuyan bir istemci sarmalayıcı
  • Örnekleme yapabilen bir günlük hattı
  1. 01

    İzin sınırlarını çiz

    Bir kullanıcı isteğinin başladığı ve bittiği noktayı tanımla; aradaki her geri getirme, model ve araç çağrısını aynı izin alt adımı olarak bağla.

    Gözlemlenebilirlik kurulumlarının çoğu, model çağrısını ölçüp orada duruyor. Oysa kullanıcının yaşadığı gecikmenin büyük kısmı çoğu zaman model çağrısının dışında: geri getirme, araç çağrıları, sıraya girme, yeniden denemeler. Model çağrısını tek başına ölçmek, doğru sayıyı yanlış soruya cevap olarak vermektir.

    1. 1İstek girişi

      Bağıntı kimliği burada üretilir ve bütün alt adımlara taşınır.

    2. 2Geri getirme

      Sorgu, dönen aday sayısı ve süre; boş dönüş ayrı bir sonuç durumu olarak işaretlenir.

    3. 3Model çağrısı

      Her çağrı ayrı adım; yeniden denemeler tek adıma sıkıştırılmaz.

    4. 4Araç çağrıları

      Dış sistem çağrıları kendi süreleri ve hata sınıflarıyla kaydedilir.

    5. 5Yanıt çıkışı

      İz burada kapanır; toplam süre kullanıcının gördüğü süreyle aynı olmalıdır.

  2. 02

    İz şemasını önceden sabitle

    Her adımda kaydedilecek alanları baştan yaz: adım türü, süre, girdi ve çıktı token sayısı, model künyesi, sonuç durumu ve hata sınıfı.

    Şema sonradan yazıldığında, elinizdeki geçmiş kayıtların yarısında alanlar eksik olur ve karşılaştırma yapılamaz. Alan listesini baştan sabitlemenin asıl faydası tutarlılık: aynı soruyu iki farklı serviste aynı sorguyla sorabilmek.

    AlanTipNeden gerekli
    adim_turumetinGeri getirme, model, araç ayrımı olmadan kırılım yapılamaz
    sure_mssayıBileşen bazlı gecikme analizinin temel birimi
    girdi_tokensayıBağlam şişmesini ayrı izlemenin tek yolu
    cikti_tokensayıÜretim süresiyle doğrudan ilişkilidir
    model_kunyesimetinSürüm kaydığında farkı ölçümde görmeyi sağlar
    sonuc_durumumetinBaşarı, boş dönüş, kaçış, hata ayrı ayrı sayılmalı
    hata_sinifimetinZaman aşımı, oran sınırı, şema hatası ayrı ele alınır
    deneme_nosayıYeniden denemeler gizlendiğinde maliyet ve gecikme yanlış okunur
    Bu alanlar dolmadan pano kurmak, boş eksenlere grafik çizmektir.
    json
    {
      "iz_kimligi": "<bagintilandirma-kimligi>",
      "adim_kimligi": "3",
      "adim_turu": "model_cagrisi",
      "sure_ms": 0,
      "ilk_token_ms": 0,
      "girdi_token": 0,
      "cikti_token": 0,
      "model_kunyesi": "<cozulmus-model-kimligi>",
      "sonuc_durumu": "basarili",
      "hata_sinifi": null,
      "deneme_no": 1
    }
  3. 03

    Token kullanımını çağrı düzeyinde ayır

    Girdi ve çıktı tokenlarını her model çağrısında ayrı alanlara yaz; tek alanda toplanırsa bağlam şişmesi ile uzun yanıt birbirinden ayrılamaz.

    Girdi ve çıktı tokenları aynı şey değil, hem maliyet hem gecikme tarafında farklı davranıyorlar. Girdi tokenları tek bir ön işleme geçişinde toplu değerlendirilir; bu yüzden uzun bağlamın bedeli ağırlıkla ilk token süresine biner, üretim süresine token başına eklenmez. Çıktı tokenları ise tek tek üretilir; her ek token doğrudan toplam süreye yazılır. Tek bir toplam alan tuttuğunuzda, gecikme artışının bağlamdan mı yanıt uzunluğundan mı geldiğini ayırt edemezsiniz.

    • Girdi tokenı: sistem istemi, geri getirilen bağlam, konuşma geçmişi ve araç şemaları dâhil.
    • Çıktı tokenı: üretilen yanıt; akıl yürütme çıktısı ayrı raporlanıyorsa ayrı alanda tutun.
    • Önbellekten okunan girdi: sağlayıcı böyle bir alan veriyorsa ayrı yazın, yoksa alanı hiç açmayın.
    • Deneme başına tekrar: yeniden denenen çağrının tokenları da gerçekten harcanmıştır.

    Doğrulama adımı: bir günlük kayıttaki çağrı düzeyinde token toplamını, sağlayıcının kendi kullanım raporuyla karşılaştırın. Aradaki fark, kaydı atlanan çağrıların — genellikle yeniden denemelerin ve arka plan işlerinin — payıdır.

  4. 04

    Gecikmeyi bileşenlere böl

    Toplam süreyi geri getirme, ilk token bekleme ve üretim süresi olarak ayır; her birini p50 ve p95 olarak birlikte raporla.

    Ortalama gecikme, kullanıcıyı rahatsız eden şeyi göstermez. Şikâyetler kuyruktan gelir: yüz istekten beşinde yaşanan uzun bekleme, ortalamayı çok az oynatır ama algıyı belirler. Bu yüzden her bileşen için p50 ve p95 birlikte raporlanmalı; ikisi arasındaki açıklık, sistemin ne kadar kararsız olduğunu anlatır.

    BelirtiMuhtemel nedenBakılacak alan
    İlk token geç geliyorBağlam büyümüş veya sıraya girilmişgirdi_token ve ilk_token_ms
    Toplam süre uzun, ilk token hızlıYanıt uzuyorcikti_token
    p95 şişmiş, p50 normalYeniden denemeler veya oran sınırıdeneme_no ve hata_sinifi
    Gecikme model dışındaGeri getirme veya araç çağrısı yavaşadim_turu kırılımı
    Süre dalgalıBağlam uzunluğu istekten isteğe çok değişiyorgirdi_token dağılımı

    Akış (streaming) kullanıyorsanız kullanıcının algıladığı gecikme ilk token süresine yaklaşır, ama toplam süre hâlâ kaynak tüketimini belirler. İkisini birlikte raporlayın; yalnızca ilk token süresine bakmak, arka planda uzayan üretimleri gizler.

  5. 05

    Kalite sinyallerini kayda al

    Şema doğrulama hatası, kaçış cevabı oranı, boş geri getirme, kesilen yanıt ve kullanıcı geri bildirimini ölçülebilir alanlar olarak kaydet.

    "Kalite ölçülemez" yaygın bir kabul ama yanlış: doğrudan ölçülemeyen şey cevabın doğruluğu, yoksa kalitenin bozulduğunu haber veren birkaç sinyal üretim kaydından bedava çıkıyor. Bu sinyaller kaliteyi tanımlamaz, ama kötüleştiğinde neredeyse her zaman birlikte hareket ederler.

    • Şema doğrulama hatası: yapılandırılmış çıktı beklerken gelen bozuk yanıtların oranı.
    • Kaçış cevabı oranı: modelin "bu konuda bilgim yok" benzeri bir çıkışa düştüğü istekler.
    • Boş geri getirme: arama hiç aday döndürmediğinde; uydurma riskinin en güçlü habercisi.
    • Kesilen yanıt: azami çıktı sınırına çarpıp yarıda kalan üretimler.
    • Araç çağrısı hatası: şemaya uymayan veya var olmayan aracı çağırma denemeleri.
    • Kullanıcı geri bildirimi: açıkça verilen olumsuz işaret ve yeniden sorma davranışı.
  6. 06

    Girdi kaymasını izle

    Gelen isteklerin uzunluk, dil ve konu dağılımını haftalık karşılaştır; model değişmeden girdi değişince de çıktı kalitesi düşer.

    Kalite düşüşünde ilk bakılan yer model olur, oysa sık karşılaşılan senaryo şu: model de istem de aynı, değişen şey kullanıcıların ne sorduğu. Yeni bir ürün duyurulur, bir kampanya başlar, bir bölge açılır — girdi dağılımı kayar ve sistem daha önce hiç görmediği soru tipleriyle karşılaşır.

    • İstek uzunluğu dağılımı: kısa sorular uzun sorulara dönüştüyse bağlam bütçesi de değişmiştir.
    • Dil dağılımı: tek dilde kurulmuş bir hattın çok dilli trafik alması sessiz bir kalite kaybıdır.
    • Konu dağılımı: kabaca etiketleme yeterli; kesin sınıflandırma şart değil.
    • Yeni terim oranı: daha önce hiç görülmemiş kelimelerin payı.
    • Oturum başına istek sayısı: artması çoğu zaman ilk cevabın yetersiz kaldığını gösterir.

    Karşılaştırmayı sabit pencerelerle yapın: aynı gün sayısı, aynı saat aralığı. Hafta içi ile hafta sonunu karşılaştırmak, gerçek olmayan bir kayma üretir ve ilk uyarı kurulumlarının en sık hatası budur.

  7. 07

    Uyarı eşiklerini taban çizgisinden türet

    Eşik koymadan önce en az bir hafta taban ölçüm topla; nöbetçinin yapabileceği bir eylemi işaret etmeyen uyarıyı hiç kurma.

    Mutlak eşikler kitaptan alınır ve sizin sisteminizde ya sürekli çalar ya hiç çalmaz. Doğrusu, kendi dağılımınızı ölçüp eşiği onun üstüne koymak. Taban ölçüm süresi, sistemin bütün doğal dalgalanmasını görecek kadar uzun olmalı: en azından bir tam hafta, mevsimsel iş yükü varsa daha fazlası.

    UyarıEşik nasıl seçilirİlk eylem
    Hata oranıTaban dönemin en kötü gününün üstüHata sınıfı kırılımına bak
    p95 gecikmeTaban p95'in belirgin üstünde ve süre şartına bağlıBileşen kırılımını aç
    Boş geri getirme oranıTaban ortalamasının üstü, tek seferlik sıçramayı eleSorguları ve dizin sağlığını kontrol et
    Şema hatası oranıSıfıra yakın bir taban varsa küçük bir artış bile anlamlıİstem veya model sürümü değişti mi bak
    Token artışıİstek başına ortalamanın taban üstüBağlam kurgusunu ve geçmiş penceresini incele
    Üçüncü sütun boş bırakılabilen bir uyarı, kurulmaması gereken uyarıdır.
  8. 08

    Örnekleme ve saklama politikasını yaz

    Başarılı izlerden örnek al, hatalı ve yavaş izlerin tamamını sakla; saklama süresini kişisel veri kararınla aynı belgeye yaz.

    Her izi sonsuza kadar saklamak ne gerekli ne mümkün. Ama örnekleme kararı baştan verilirse, tam da incelemek isteyeceğiniz nadir hatalar örneklemenin dışında kalır. Çözüm, kararı izin sonunda vermek: sonucu hatalı veya süresi eşiğin üstünde olan izler tamamıyla saklanır, geri kalanından oran belirlenerek örnek alınır.

    1. 01Hatalı ve yavaş izleri istisnasız sakla; incelemenin tamamı buradan çıkar.
    2. 02Başarılı izlerden sabit oranda örnek al; oran dağılımı bozmayacak kadar büyük olsun.
    3. 03Sayısal ölçümleri örneklemeden geçirme; toplu ölçüm izden bağımsız toplanmalı.
    4. 04Metin alanları için ayrı ve daha kısa bir saklama süresi tanımla.
    5. 05Silme işini takvime değil hattın kendisine bağla.

    Doğrulama adımı: saklama süresi dolmuş bir dönemi sorgulayın. Kayıtlar hâlâ duruyorsa politika yazılı ama uygulanmıyordur; bu, denetimde kâğıt üstündeki politikadan daha kötü bir durumdur.

SIK DÜŞÜLEN TUZAKLAR

  • Yalnızca ortalamaya bakmak

    Ortalama gecikme, yüz istekten beşinde yaşanan uzun beklemeyi görünmez kılar. Kullanıcı şikâyetleri kuyruktan gelir; panoda kuyruk yoksa şikâyetle ölçüm birbirini tutmaz.

  • Yeniden denemeleri tek çağrı saymak

    Sarmalayıcı içinde sessizce yapılan tekrarlar hem token tüketir hem gecikmeye eklenir. Tek adım olarak kaydedildiklerinde sistem olduğundan ucuz ve hızlı görünür.

  • Ham istem ve yanıtı sınırsız saklamak

    Kullanıcı istemleri kişisel veri içerebilir. Sınırsız saklama hem depolama maliyeti hem yükümlülük üretir ve sonradan daraltmak, kurulumu baştan yapmaktan zordur.

  • Uyarıyı mutlak bir sayıya bağlamak

    Başka bir sistemin eşiği sizinkinde ya sürekli çalar ya hiç çalmaz. İki hafta içinde susturulan kural, izlenmeyen göstergeye dönüşür.

  • Ajan turlarını tek adım olarak kaydetmek

    Üç turda biten görevle on turda biten görev ölçümde aynı görünür. Asıl sorun olan tur sayısı hiç raporlanmaz ve döngü maliyeti fark edilmez.

KONTROL LİSTESİ

  • Bir kullanıcı isteği tek bir iz kimliğiyle uçtan uca izlenebiliyor
  • İz şeması yazılı ve her adım aynı alan kümesini dolduruyor
  • Girdi ve çıktı tokenları ayrı alanlarda tutuluyor
  • Gecikme p50 ve p95 olarak, bileşen kırılımıyla raporlanıyor
  • Şema hatası, kaçış oranı ve boş geri getirme panoda görünüyor
  • Girdi dağılımı için taban çizgisi alınmış ve düzenli karşılaştırılıyor
  • Her uyarının bir sahibi ve yazılı bir ilk eylem adımı var
  • Saklama süresi ve kişisel veri kararı tek belgede yazılı ve hattın içinde uygulanıyor

Maddelerin tamamı işaretlenmeden kurulum üretime alınmamalı.

Sık sorulan sorular

LLM uygulaması için normal uygulama izleme aracı yeterli mi?

Temel olarak kullanılabilir ama tek başına yetmez. Klasik izleme süre ve hata kaydeder; LLM hattında ayrıca girdi ve çıktı token sayısı, model künyesi, kaçış oranı ve boş geri getirme gibi alanlar gerekir. Bunlar mevcut iz şemasına alan olarak eklenebilir.

Gecikmeyi ortalamayla mı yüzdelikle mi raporlamalıyım?

Yüzdelikle, üstelik tek başına değil: p50 ve p95 birlikte raporlanmalı. İkisi arasındaki açıklık sistemin kararsızlığını gösterir; ortalama ise iki farklı dağılımı aynı sayıya indirger.

İstem ve yanıt metinlerini kayıtta saklamalı mıyım?

Varsayılan olarak hayır. Sayısal alanlar ölçüm için yeterli; metin ancak hata incelemesi için gerekliyse, kısa saklama süresi ve erişim sınırıyla tutulmalı. Kullanıcı istemleri kişisel veri içerebilir.

Model değişmediği hâlde kalite düştüyse nereye bakarım?

Önce girdi dağılımına: istek uzunluğu, dil ve konu kırılımı taban çizgisinden ayrıldı mı? Sonra geri getirmeye: boş dönüş oranı arttıysa sorun arama hattındadır. Model çağrısı listede üçüncü sırada gelir.

Kaynaklar

  1. 01Dağıtık iz kaydı ve ölçüm toplama dokümantasyonları — Gözlemlenebilirlik araç sağlayıcıları · Dokümantasyon
  2. 02Sinaptik Research — üretim gözlemlenebilirliği uygulama notları — Sinaptik Lab · Teknik rapor

BUILD

Bu rehberi kurumunuzda uygulayalım mı?

Aynı mimariyi kendi verinizle kurmak için discovery oturumundan üretime kadar birlikte ilerliyoruz.