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ı
- 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İstek girişi
Bağıntı kimliği burada üretilir ve bütün alt adımlara taşınır.
- 2Geri getirme
Sorgu, dönen aday sayısı ve süre; boş dönüş ayrı bir sonuç durumu olarak işaretlenir.
- 3Model çağrısı
Her çağrı ayrı adım; yeniden denemeler tek adıma sıkıştırılmaz.
- 4Araç çağrıları
Dış sistem çağrıları kendi süreleri ve hata sınıflarıyla kaydedilir.
- 5Yanıt çıkışı
İz burada kapanır; toplam süre kullanıcının gördüğü süreyle aynı olmalıdır.
- 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.
Alan Tip Neden gerekli adim_turu metin Geri getirme, model, araç ayrımı olmadan kırılım yapılamaz sure_ms sayı Bileşen bazlı gecikme analizinin temel birimi girdi_token sayı Bağlam şişmesini ayrı izlemenin tek yolu cikti_token sayı Üretim süresiyle doğrudan ilişkilidir model_kunyesi metin Sürüm kaydığında farkı ölçümde görmeyi sağlar sonuc_durumu metin Başarı, boş dönüş, kaçış, hata ayrı ayrı sayılmalı hata_sinifi metin Zaman aşımı, oran sınırı, şema hatası ayrı ele alınır deneme_no sayı 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 } - 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.
- 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.
Belirti Muhtemel neden Bakılacak alan İlk token geç geliyor Bağlam büyümüş veya sıraya girilmiş girdi_token ve ilk_token_ms Toplam süre uzun, ilk token hızlı Yanıt uzuyor cikti_token p95 şişmiş, p50 normal Yeniden denemeler veya oran sınırı deneme_no ve hata_sinifi Gecikme model dışında Geri 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şiyor girdi_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.
- 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ışı.
- 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.
- 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 gecikme Taban 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ı ele Sorguları 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. - 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.
- 01Hatalı ve yavaş izleri istisnasız sakla; incelemenin tamamı buradan çıkar.
- 02Başarılı izlerden sabit oranda örnek al; oran dağılımı bozmayacak kadar büyük olsun.
- 03Sayısal ölçümleri örneklemeden geçirme; toplu ölçüm izden bağımsız toplanmalı.
- 04Metin alanları için ayrı ve daha kısa bir saklama süresi tanımla.
- 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
- 01Dağıtık iz kaydı ve ölçüm toplama dokümantasyonları — Gözlemlenebilirlik araç sağlayıcıları · Dokümantasyon
- 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.
