Gözlemlenebilirlik Karar Kaydı Nasıl Yazılır

Bu rehber ne yapar

Gözlemlenebilirlik Karar Kaydı işi üretimde log, metrik ve geri alma izi olmadan tamamlanmış sayılmaz. Buradaki hedef kullanıcı verisini çoğaltmadan işletim kanıtı üretmektir. Bu iş sonunda Turkcell LLM 7B için tarihli bir karar kanıtı oluşur, RTX 4060 Ti 16GB sınıfı donanım not edilir ve ölçüm Türkçe token maliyeti ile ilişkilendirilir. Akış Ollama ile yürür; daha geniş bağlam Kurs O001: Üretim LLM Operasyonları Temeli içinde işlenir.

Yasal uyarı: Bu içerik eğitim amaçlı teknik çalışma notudur; hukuki görüş, mevzuat yorumu, uyum belgesi veya profesyonel danışmanlık değildir. Kişisel veri, sağlık, finans, çocuk/öğrenci verisi, telif veya regüle sektörlerde gerçek uygulamadan önce yetkin hukuk/uyum uzmanıyla yazılı değerlendirme alın.
Operatör notu: Gözlemlenebilirlik Karar Kaydı Nasıl Yazılır: Üretim notunda istem içeriğini değil, olay zamanı, model etiketi, gecikme ve maskeleme sonucunu tutun. Orta seviyede komutun yanında hata modunu da yazın; gelecekteki bakım çoğu zaman bu satırdan başlar. Bu rehberde beklenen kanıt outputs/gozlemlenebilirlik-karar-kaydi.txt dosyasıdır.

Ön koşullar

  • Ubuntu 24.04 LTS ya da eşdeğer geliştirme ortamı.
  • Yerel çalışma zamanı kontrolü: bash --version.
  • Gözlemlenebilirlik Karar Kaydı: Üretim benzeri ama kişisel veri taşımayan küçük bir kontrol girdisi; gerçek log örneğini maskelemeden kopyalamayın.
  • Terminal çıktısı UTF-8 olmalı; Windows tarafında şüphede kalırsanız chcp çıktısını kaydedin.

Adımlar

  1. Kanıt klasörünü aç. Gözlemlenebilirlik Karar Kaydı için çıktıyı gozlemlenebilirlik karar kaydi adıyla ayır; aynı klasöre log ve kısa rapor da girecek.
mkdir -p outputs logs reports
  1. Küçük kanıtı üret. Gözlemlenebilirlik Karar Kaydı için Üretim pratiğinde kanıt, gizli istemin kendisi değil; zaman, model etiketi ve maskelenmiş sonuçtur. Bu komut gerçek veriyi çağırmadan Turkcell LLM 7B etiketini karar dosyasına işler.
mkdir -p outputs
printf '%s\n' 'gozlemlenebilirlik-karar-kaydi | model=turkcell-llm-7b | kontrol=tamam' 'komut=ollama list' 'metric=local_models' | tee outputs/gozlemlenebilirlik-karar-kaydi.txt
ollama list
  1. Özeti kilitle. Gözlemlenebilirlik Karar Kaydı özetini daha sonra değişiklik yakalamak için kullanacaksınız; Türkçe token maliyeti notunu bu hash ile birlikte saklayın.
sha256sum outputs/gozlemlenebilirlik-karar-kaydi.txt
  1. Türkçe kırılmayı ara. Gözlemlenebilirlik Karar Kaydı Nasıl Yazılır için log satırında Türkçe metin taşıyacaksanız önce maskeleme sonucunu okuyun; ham istemi kalıcı kayda yazmayın. Çıktı temizse Ollama tarafındaki sıradaki adıma geçebilirsiniz.

Doğrulama

Tek komutla son durumu doğrula:

test -s outputs/gozlemlenebilirlik-karar-kaydi.txt && sed -n '1,3p' outputs/gozlemlenebilirlik-karar-kaydi.txt

Beklenen çıktı:

gozlemlenebilirlik-karar-kaydi | model=turkcell-llm-7b | kontrol=tamam
kanıt: outputs/gozlemlenebilirlik-karar-kaydi.txt
Türkçe karakter kontrolü: ı ş ç ğ ö ü

Yaygın Hatalar

  • `command not found: ollama` — Ollama kurulu değil ya da kabuk PATH içinde değil. Çözüm: aracı resmi kurulum yoluyla ekleyin, sonra aynı kabukta sürüm komutunu çalıştırın.
  • `redaction missing` — Üretim benzeri log satırı maskelemeden rapora taşınmış. Çözüm: ham istem yerine olay kimliği, gecikme ve model etiketini yazın; örnek veriyi sentetik tutun.
  • `Türkçe karakterler bozuk` — Gözlemlenebilirlik Karar Kaydı Nasıl Yazılır çıktısında Türkçe harfler okunmuyorsa kodlama katmanı karışmıştır. Çözüm: locale çıktısını kontrol edin ve dosyayı UTF-8 olarak tekrar üretin.
  • `outputs/gozlemlenebilirlik-karar-kaydi.txt yok` — Rehberin sonunda beklenen kanıt dosyası oluşmamış. Çözüm: önce çalışma klasörünü oluşturun, sonra karar kanıtı adımını tek başına tekrar çalıştırın.
Veri koruma uyarısı: Bu rehber KVKK uyum kararı vermez. Kişisel veri içeren örnekleri üretimde kullanmadan önce amaç, saklama süresi, erişim yetkisi ve yurtdışı aktarım ihtimalini yetkin hukuk/uyum uzmanıyla doğrulayın. Başlangıç noktası: KVKK ve AI.

İlgili rehberler

İlgili katalog girişleri