Yönetim Kurulu'nun Göğüs Trafik, Kanarya Çeviri ve Gelişmiş Çeviri
Type: Learn
Languages: Python (stdlib, toy canary-progression simulator)
Prerequisites: Phase 17 · 13 (Observability), Phase 17 · 21 (A/B Testing)
Time: ~60 minutes
Öğrenme Hedefleri
- Gölge modunu (sıfır etki karşılaştırması), kanary (canal trafik ilerleyici) ve A/B (sağlık doğrulanmış karşılaştırma) ayırt edin.
- LLM'ye özel beş kanarya ölçüsünü (kenaklık, maliyet/ talep, hata/ reddedilme, çıkış uzunluğu dağılım, kullanıcı yanıtları) listeleyin.
- LLM belirlenme yetkisi (% 15'e kadar) neden bir dağıtımda "sağlık" anlamına gelen şeyi değiştirdiğini açıklayın.
- Sekünteler (politik dönüşü) değil saatler (değişiklik) alan bir geri dönüş yolu tasarlayın.
Sorun
Yeni bir model gönderiyorsunuz. Offline değerlendirmeler %3 doğruluk artışını gösterir. Üretimde geri çevirirsiniz. 24 saat içinde, maliyet %40 arttı, kullanıcı parmakları%8 arttı, üç müşteri biletinin "acayip cevaplar" raporunu. Geri dönersiniz. Yeniden dağıtmak 3 saat alır. Hafta sonu mahvoldu.
Bu durumun her parçası önlenebilirdi. Gölge modunda herhangi bir kullanıcı bunu görmeden önce maliyet artışının %40'ını yakalamış olacaktı. Canary, parmak parmakları aşağı hareket ederken %10'da durmuş olacaktı. Politika bayrağı geri çekilmesi 30 saniye sürmüş olacaktı. Disiplin "offline değerlendirmeler iyi görünüyor" ve "gerçek kullanıcılar mutlu" arasındaki boşluğu dolduruyor.
Anlaşım
Gölge modusu
İsteğe giren isteği üretim ile aynı şekilde alır; çıkışlar kayıtlıdır, kullanıcılara geri verilmez. Kullanıcı etkisi sıfır.
- Üretim içeriği (ürünme karşı fark).
- Token sayıları (maliyet delta).
- Gecikme.
- İtiraz ve hata.
Yaptıkları: maliyet uçuşları, uzunluk gerilemeleri, açıkça reddedilen değişiklikler, sert hatalar. Yaptıkları: kalite delta kullanıcıları algılar. Gölge bir duman testi, kalite testi değil.
Kanaryaların dağıtımı
Gelişen trafik geçişleri. Tipik ilerleme: 1% → 10% → 25% → 50% → 75% → 100%.
- Latency percentiles P50, P95, P99.
- Cost per request karışık $. ihlal: başlangıç seviyesinden %20'lik.
- Error / refusal rate5xx artı açık bir reddedilme.
- Output length distribution ortalama + P99.
- User-feedback rate- Başparmak aşağı / bilet kayıtları.
Devrimsizlik yeni bir değişimdir.
Aynı girişler aynı çıkışları üretmez.
- GPU FP ilişkisizliği (yürüyüş noktası azaltma sırası partiye göre değişir).
- Satır boyutları değişimi (128 vs. 16 satır)
- Örnekleme (temperatür > 0).
Ölçülmüş: aynı değerleme setlerinde çalıştırılan %15'e kadar doğruluk değişikliği. "Stabil" bir dağıtımda ölçümler beklenen değişiklik içinde, başlangıç çizgisine benzer değildir.
Masraf değişken
%20 daha iyi bir model her çağrıda 3 kat daha pahalı olabilir. Masraf / talep beş kapıdan biridir. Birim ekonomisini kıran "en iyi" bir model göndermek bir geri dönüş durumudur.
Rollback silah.
- Politika bayrağı (önümlü bayrağı sistemi): yapılandırmalarda dönüş yüzdesi; saniyeler alır.
- Model sıkıştırılması (registri sindirme): sıkıştırılmış model otomatik olarak yükseltilmez.
- Geri dönüş = bayrak + öncekiye sabitlenmiş bir dizgest ayarlayın.
Eğer yığın yeniden dağıtılmak için geri dönüş gerektiriyorsa, fırlatmadan önce düzeltin.
Araçlama
Argo Rollouts- Ne ?Flagger Kubernetes ilerici teslimat kontrolörleri. Istio/Linkerd ağırlıksız yönlendirme ile entegre.
Istio weighted routing hizmet ağı seviyesindeki trafik bölümü.
KServe / Seldon Core İçerilen kanaryalı servisi.
Feature flags LançDarkly, Flagsmith, Unleash.
Metrikler kadansı
Kanarlı kapılar trafik hacmine bağlı olarak her 5-15 dakikada bir kontrol eder. %1 trafiğin 10 req/min ile penceresi başına 50-150 veri noktası verir gecikme için yeterli ama kullanıcı geri bildirimleri için gürültülü. %10 ~ 10 kat daha fazla verir.
A/B adımı seçeneğe bağlıdır.
Yeni model belirgin bir şekilde farklı ise (farklı davranış, farklı maliyet eğri, farklı ton), kanary geçtikten sonra %50'de A/B testini yapın.
Hatırlamalısın numaralar
- Kanarya ilerleme: 1% → 10% → 25% → 50% → 75% → 100%.
- Determinizm sınırlaması: Aynı girişlerde %15'e kadar devamlı değişim.
- Beş kanarya ölçüsü: gecikme, maliyet, hata/reddedilme, çıkış uzunluğu, kullanıcı geri bildirimi.
- Masraf kapısı: >20%'den fazla baseline karşı bir ihlal.
- Sekünteler, saatler değil.
Kullan
code/main.pyİndirilen geri dönüşlerle bir kanarya yayımını simüle eder. Yayınlama durakları ve hangi kapı tetiklendiği raporları.
Gönder
Bu ders bize çok yararlı .outputs/skill-rollout-runbook.md. Başvuru modeli, başlangıç çizgisi ve risk toleransı göz önüne alındığında, shadow→canary→100% planı tasarlıyor.
Egzersizler
- Çık .
code/main.py- %25 maliyet geri dönüşü enjekte edin. - Yeni modeliniz %3 doğruluk kazancı offline ama maliyet / talep %18'dir.
- 60 saniyeden kısa bir geri dönüş yapın.
- - Değerlendirme eksikliği %7'e ulaştı.
- Gölge modunda, kanaryalardan önce maliyet artışı %40'a ulaşır.
Anahtar Terimler
| Term | What people say | What it actually means |
|---|---|---|
| Shadow mode | "duplicate to new" | Zero-impact send-to-candidate for logging |
| Canary | "progressive traffic" | Gradual user-exposed rollout with gates |
| Gates | "rollout checks" | Metric thresholds that block progression |
| Non-determinism | "LLM variance" | Irreducible run-to-run differences |
| Policy flag | "flag flip rollback" | Config-level rollback, seconds not hours |
| Model pin | "registry digest" | Immutable reference to a model version |
| Argo Rollouts | "K8s progressive" | Kubernetes-native canary/rollback controller |
| KServe | "inference K8s" | Model serving with canary primitives |
| Istio weighted | "mesh split" | Service-mesh traffic splitter |
Daha Fazla Okumak
- TianPan — Releasing AI Features Without Breaking Production
- MarkTechPost — Safely Deploying ML Models
- APXML — Advanced LLM Deployment Patterns
- Argo Rollouts docs
- Flagger docs
This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.
Browse the complete course catalog or open this lesson on GitHub.