Azure CLI ile Hosted AI Ajanlarını Canlı Takip
AI Ajanlarıyla Gerçek Zamanlı Takip: Dert Bitti Mi?
Düşün, yeni bir yapay zekâ ajanı yazdın. Kodunu yükledin, Azure’da konteyner ‘çalışıyor’ diyorsun… Umuyorsun yanı. Her şey tıkırında mı? Belki… Ama sabah kalkıp canlıya bakınca sistem yerinde yoksa (olmaz demeyin!), insan öylece kalıyor. Geçmişte bu gibi günler — samimi söylüyorum — işkenceydi ya! Portal oradan aç, panelden log kovala, üç ayrı API’yle debelen… Yetmiyor, her defasında başka bir hata ekrana fırlıyor, “Bu sefer nerede patladı?” diye kara kara düşünüyordum.
Şahsen, Dürüst olmak gerekirse, Şimdi işe Azure Developer CLI (bilen bilir; hızlısından azd) yepyeni oyuncaklarla geldi! AI ajanlarının hem durumunu hem de canlı loglarını direkt terminal ekranında görebiliyorsun (ki bu çoğu kişinin gözünden kaçıyor). Kolay mı kolay dursa da acaba gerçek hayatta bu işler hakikaten değişti mi? Bir bakalım dedim.
Yeni Komutlarla Tanışın: azd ai agent show & azd ai agent monitör
CLI ile Pratikte Canlı İzleme
Azure Developer CLI ile tanışan biri olarak, “terminalden yönetmek” gerçekten hayat kurtarıyor mu sorusunun yanıtını ilk elden deneyimleme şansım öldü. Yanı, eskiden portalda oradan oraya atlayıp kaybolduğumuz hata takibi seansları yerine, şimdi tek satırlık komutlarla canlıya dokunabiliyorsun. Kod satırını terminale bırakıyorsun, işinin başında tek camda her şeyin akışını izliyorsun.
Gerçi geçmişte, örneğin 2022’nın Şubat’ında bir müşteri projesinde Black Friday yoğunluğunda AI öneri servisimiz sebepsiz yere düşüyordu (bizzat test ettim). Hatanın kökenini yakalamak için gece üçte kalkıp otuz sekiz farklı log dosyasını elle karşılaştırmıştım. Şimdi o günleri düşününce; bir azd ai agent show --name my-agent --version 1 komutuyla ekranıma neredeyse tüm detay dökülüyor. Zaman ciddi anlamda elimde kalıyor.
“Hatanın kaynağına gitmek için üç ayrı Azure sayfası arasında mekik dokuduğum günleri hatırlıyorum… Artık şaka gibi basit!”
Ajan Durumu Hep Yanınızda mı?
Sözümü saklamıyorum; bu yeni azure.ai.agents uzantısıyla elimizde iki bomba komut var şimdi:
azd ai agent show: Hangi ajan hangi kutuda koşuyor, sağlık durumu nasıl—hepsi satır satır karşında.azd ai agent monitor: Terminale canlı log aktarıyor—baya akıyor yanı, hiç kaçırmadan izliyorsun.
Açıkçası, Peki hayat kurtarıyor mu gerçekten? Sıcak bir örnekle netleşsin istiyorum (kendi tecrübem): Geçen ay bizde yapay zekâ öneri motoru yayına alındı. Testte şahaneydi ama production’a geçtiğinde tık diye sustu! Uğraştık portalda health check’lerle vs., sonuç koca bir sıfır bilgi maalesef. Bugünkü gibi tek hamlede azd ai agent show --name my-agent --version 1 ile anahtarı çevirir gibi sağlık ve hata mesajını çekebilsek o gün saatler gitmezdi… Şimdi tek komuta bakıyorsun: hop veriler burada!
Canlı Log Takibi İle Anında Teşhis Şansı
Bazen sadece statüsü bilmek yetmiyor tabiî—kök neden arıyorsan iş biraz daha heyecanlı! Burada da azd ai agent monitor --name my-agent --version 1 -f, bildiğin Linux’taki tail – f olayının Azure versiyonu devreye giriyor.
Senaryo şöyle olsun; prod’da anı bir sıkıntı çıktı, gözlerin monitörde… Sistemin attığı her satırı aynı anda okuyabiliyorsun artık. Eskiden merkezî log ekranlarında filtreyle uğraşmak tam angaryaydı (hani bir ayar tutmazdı ya), yanlış kişi gelsin diye dua ederdik neredeyse.
Çözüm neymiş?
Biri çıkmış terminalde akar logla gelmiş bitirmiş işi!
Gerçekten.
Sadece sistem loglarını görmek istiyorsan mesela,
azd ai agent monitor --type system‘u dene;uygulamadan mı altyapıdan mı kaynaklı hızlıca ayıklarsın.
Ben seviyorum valla.
Azure Developer CLI ile AI ajanlarını durum ve canlı log üzerinden terminalden izleyerek hata ayıklamayı hızlandırmayı özetler.
| Özellik | Klasik Portal/Log Takibi | Azure CLI (azd) ile Canlı İzleme |
|---|---|---|
| Ajan durumu | Portalda panel panel gezinme | azd ai agent show ile tek komutta sağlık bilgisi |
| Canlı log takibi | Çoklu API/log kaynağı kontrolü | azd ai agent monitör ile terminalde anlık akış |
| Hata teşhisi | Hangi hatanın nereden geldiği zor bulunur | Komutla hata mesajlarına hızlı erişim, zaman kazancı |
Not: Komut örnekleri yazıda; pratikte “show” durum, “monitör” işe canlı log için kullanılıyor.
Bütün Kontrol Tek Pencerede: Avantajları & Limitleri
Neden Seviyoruz?
- Zaman kazandırıyor – Tüm bilgiler tek yerde buluşunca hız fena artıyor.
- Daha az kişiyle soruna dalabiliyorsun – Teknik adamlar ek kurcalama derdin yok.
- Kontekst kayması olmuyor – Oradan oraya zıplayacağımıza termalde takılmak yetiyor.
- Anlık teşhis bambaşka avantaj – Canary deployment’larda mesela güven çok yükseliyor.
Canlı Takibin Proje İçindeki Yeri
Geçen yıl, bir dağıtık AI mikroservis projesinde ekip olarak test sunucusunda rastgele beliren CPU spike’ları yüzünden delirmek üzereydik. O dönem azd ai agent monitor ile canlı logları açtığımda, API çağrı zincirinin tam olarak nerede kırıldığını, saniye bazında yakalama şansım öldü. O zamandan beri, canlı takip komutları en kritik müşteri sunumumdan önce bile ilk elimde açtığım ekranlardan biri.
Peki ya Yeter mi?
Açık net konuşayım—her derde deva sandığım olmadı henüz:
Şöyle ki:
- Mimarı büyüdükçe tekil ajanın sağladığı bilgi bazen sığ kalabilir;
- Ciddi güvenlik işleri varsa SIEM entegrasyonu hâlâ lazım oluyor (paranoya iyidir!);
- Ağ segmentasyonlardan dolayı bazı uç senaryolarda logların düşmesi riski var olacak ister istemez (maalesef bunun çözümü yok);
- Logle boğulduğun yoğunlukta anlamlı parçayı seçmek için yine uzman refleksi şart…
Hani otomatikleştik ama yine de kafa lazım!
İşin garibi, Eğer “benzer karın ağrısı yaşadım” diyorsan bunu da beğenirsin:
Azure’da Modernizasyonun Yeni Çağı yazım burada; özellikle takımca sorun avlamak isteyenlere birebir!
artık terminalden ayrılmaz öldü desem abartmış olmam galiba.
Kısaca Kullanım Senaryosu – Adım Adım Deneyimimden Özetler
Kurulumdan İlk İzlemeye: Pratik Akış
Çoğu kişi, CLI komutlarını görünce korkuyor açıkçası. Ama işin aslı çok basit:
Ben ilk defa azd ai agent init ve azd ai agent up ile demo ortamını kurduğumda, toplamda 10 dakikada her şey ayağa kalkmıştı. Portal ile uğraşsaydım bu süre 40 dakikayı buluyordu.
Lokalde başlat, kodunu yükle ve hemen monitöring’e geç. O kadar pratik ki, yeni başlayan bir ekip üyesi bile 1-2 denemede süreci öğrenebiliyor.
- Ajanını Başlat:
Tamamen sıralamada şaşırsan bile çalıştıracağın kod belli:azd ai agent init azd ai agent up - Konteyner Sağlığını Ölç:
Bak burası önemli 👇# Ajana dair özet dökümler anında listeleniyor! azd ai agent show --name stok-agent --version v2 - Anlık Log Akışını Aç:
Tüm süreç boyunca hangisinde patlak verecek merakı biter.
Detay istersen hepsine ulaşabilirsin:# Full kayıtlar için: azd ai agent monitor --name stok-agent --version v2 -f # Sadece sistem eventleri istersen: azd ai agent monitor --name stok-agent --version v2 --type system - f - Sorunu yakaladın mı hemen çöz —
hatta arada kod/güncelleme geçip tekrar aynı işlemi döndür:
Vallahi ilk rollout sonrası müşteri ortamında kök nedeni dakikalar içinde bulmuştuk.
Gerçek Senaryo: Stok Yöneticisi ve Ajan Testi
2023’te bir tekstil ERP projesinde, stokları gerçek zamanlı güncelleyen AI ajanımız vardı. Bir sabah sunucu saat kayması yüzünden loglarda patinaj başladı. azd ai agent monitor ile canlı logda, zaman damgası uyuşmazlığını ilk 3 dakikada yakaladım, ekibin önünde sayfalarca JSON dosyası açmaya gerek bile kalmadı. Böyle hızlı teşhis, özellikle zaman kısıtlı projelerde altın değerinde.
Azure AI Agent CLI: Sıkça Sorulan Sorular
Azure CLI ile Azure Portal arasında ne fark var?
Azure Portal tamamen web tabanlı, görsel bir yönetim ekranı sağlıyor. Bazı kritik sorunlarda, portalda gezinmek yavaş ya da kafa karıştırıcı olabiliyor. Azure CLI ile işe her şeyi komutla, çok daha hızlı ve doğrudan yapabiliyorsun. Bir nevi “ellerini kirletmek” isteyen geliştirici için birebir. Logları ve hata mesajlarını anlık almak için birebir; grafiksel ayar yapmak istersen portal hâlâ avantajlı.
CLI logları gerçek zamanlı gösteriyor mu?
Evet, azd ai agent monitor - f parametresi ile Linux’ta tail – f benzeri tam anlamıyla canlı log alabilirsin. Hatta log türünü seçmek için ekstra parametreler de var: uygulama, sistem, performans gibi.
Her ajan için ayrı ayrı mı komut çalıştırmalı?
Eğer farklı ajanın durumunu ve logunu görmek istiyorsan, evet her birine özel komut vermen gerek. Ama tek bir ekranda birden fazla terminal tabiî açmak mümkün. Büyük yapılarda otomasyon veya script’lerle toplu agent health check yapmak da mümkün.
Hangi ortamda daha avantajlı?
CLI ile canlı takip, özellikle dev/test ve pilot ortamlarda çok avantajlı. Production’da merkezî loglama. SIEM sistemleri (ör: Sentinel, Splunk, Graylog) ile birlikte kullanmak daha güvenli ve ölçeklenebilir. Yanı tek başına yeterli görme, ama hızlı müdahale için birinci silahın CLI olur.
Agent parametrelerinde en sık yapılan hata nedir?
Çoğu kişi --name veya --version parametresini unutuyor ya da yanlış ajan adı giriyor. CLI saçma bir şekilde hata dökünce panik oluyorlar. Kodları kopyalarken ajan adını, versiyonu mutlaka iki kere kontrol et!
Zaman Kazanmanın Bedeli Ne? Uzantının Kurulum ve Güncellemesi Çok Kolay!
Kritik Sürüm Uyumları ve Komutlar
- Tüm özelliklerden faydalanacaksan minimumda şöyle olmalı:
azure.ai.agents extension v .01.12-preview + azd v1. .23. .7 üstü şart.
(sürüm uyumsuzluğu hatasına dikkat edin ha!) - Zaten yüklüyse updatete geciktirmek risktir—
bir satır yeter:azd extension upgrade azure.ai.agents - Sıfırdan başlayana tavsiye:
Şunu giriyorsunuz illâ ki:# CLI kurulu olduktan sonra başlatıcı hareket azd extension add azure.ai.agents - Bütün kullanım komutlarında hem işim (–name myagent), hem sürümü unutmayacaksınız (–version x); parametreyi atlayınca saçma uyarılar gelebiliyor çünkü!
- Resmî repo PR #6895 burada; takıldığınız noktada issue bırakabilirsiniz veya sız de katkıda bulunursunuz belki?
“Daha önce kullanmadım” diyen biriyseniz de telaşa gerek yok.
Portal bağımlılığı kırılırken kod tabanlı debug alışkanlığı kazanmak için daha iyi fırsat zor.
Benzer konuyla ilgili deneyimlerimi uzun uzun paylaştığım şu içerikte buluşalım isterim:
25 dolar altında AI uygulaması çıkar mı? Evet çıkar! Nasıl yaptığımı yazmıştım — merak edenler tıklasın
Sonuç – Pratiklik ve Şeffaflık Aynı Anda Mümkün mü?
İtiraf ediyorum,
işin en tatlı yanı ne biliyor musunuz?
O eski “herkeslerden gizlenen” telemetry-falan şimdi tertemiz terminal penceresinde an-be-an önünüzde bitiveriyor!
Benim kendi adıma;
bu yenilik debugging kısmını aşırı rahatlatmaya başladı.
Ama açıkça söylemeliyim —
hâlâ klasik centralize monitöring’e sahip projelerde bu aracı tamamlayıcı olarak görmek şart,
öyle sadece ‘terminal açtım çözdüm’ hayali biraz Pollyanna işi…
Gene de cloud-native çağda işler hızlandıkça böyle yardımcılar paha biçilemez oluyor.
Sız hiç “hangi satır bozuktu?” sendromundan mustarip oldunuz mu?
Varsa sizin hikâyenizi paylaşsanız güzel olurdu!
Yorumlara yazmayı unutmayın hani 🙂
Kaynak: Azure Developer CLI (azd): Debug hosted AI agents from your terminal
Kaynaklar ve İleri Okuma
Azure Developer CLI AI Agents Uzantısı
Azure Monitör ile İzleme ve Teşhis
Azure Developer CLI Tanıtımı — Azure Blog
Azure Developer CLI Resmî GitHub Deposu
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
İlgili Yazılar
Bu içerik işinize yaradı mı?
Benzer içerikleri kaçırmamak için beni sosyal medyada takip edin.
