Üç farklı görev için üç kodlama ajanı başlatıyorsunuz, ardından sonraki yirmi dakikayı terminal sekmeleri arasında gezinerek tek bir soruya yanıt aramakla geçiriyorsunuz: hangisi şu anda bana ihtiyaç duyuyor? Biri hâlâ çalışıyor. Biri hiç görmediğiniz bir y/n yanıtını bekliyor. Biri bir saat önce yeşil olarak çıkış yaptı ve sessizce yanlış şeyi inşa etti. Hiçbiri size bunu söylemedi. Kendiniz gidip bakmak zorunda kaldınız.
İşte kodlama ajanı gözlemlenebilirliğinin kapatması gereken boşluk tam da bu. Sistem mühendisliğinden ödünç alınan gözlemlenebilirlik, çalışan bir sürecin ne yaptığını, doğrudan ona bağlanmadan yaydığı sinyallerden anlayabilme yeteneğidir (OpenTelemetry'nin güzel bir başlangıç rehberi var). Kodlama ajanları için ölçüt şudur: Bir oturumu takip etmek yerine paylaşılan bir görünümden "her bir ajan ne yapıyor, ne başarısız oldu ve ne bir insana ihtiyaç duyuyor" sorularına yanıt verebilmelisiniz. Çoğu kurulum bunu yapamaz. Bir yerde bir durum, bir yerde bir log bulundurup buna gözlemlenebilirlik derler. Değildir.
Bu makalede bir kodlama ajanının gerçekte yaydığı üç sinyali, hangi hata sinyallerine alarm bağlamaya değer olduğunu ve Sharkly gibi paylaşılan bir görev katmanının ham çıktıyı nasıl harekete geçirilebilir bir şeye dönüştürdüğünü ele alıyoruz. Sharkly, hâlihazırda çalıştırdığınız ajanların üzerinde yer alır; zaten kodlama ajanlarınız var ve buradaki mesele, birden fazla olduklarında işlerini okunabilir kılmak.
Durum, loglar ve hata sinyalleri birbirinden farklı üç şeydir
Bu üç kelime birbirinin yerine kullanılır ve bu karışıklık, kötü izleme kurulumlarının çoğunun temelinde yatar. Üçü de farklı soruları yanıtlar.
Durum, bir çalıştırmanın özet halidir. Çalışıyor, girdi bekliyor, tamamlandı veya başarısız. Tek bir alandır, okuması kolaydır ve size bir çalıştırmanın nerede olduğunu söyler, ne yaptığını değil. Durum, gözlemlenebilirlik değildir; bir çalıştırma hakkındaki en küçük bilgidir.
Loglar ham yürütme izidir. Her araç çağrısı, dosya düzenlemesi ve model yanıtı, sırasıyla. Loglar, bir şeylerin ters gittiğini zaten öğrendikten sonra ne olduğunu anlatır. Bir olay sonrası inceleme için vazgeçilmezdir ama canlı bir sinyal olarak işe yaramaz, çünkü kimse aynı anda kayan beş logu izlemez. Bir log, içinden bir anlam çıkarılmadıkça sinyal değildir.
Hata sinyalleri türetilmiş uyarılardır. Sizi bölmeye değer belirli koşullardır: bir ajan takılıp kalmış, bir çalıştırma yanlış yönde yeşil sonuçlanmış, görev ortasında bütçe tükenmiş. Hata sinyali, gerçekte istediğiniz şeydir ve neredeyse her elle kurulmuş düzenin atladığı katmandır; çünkü onu türetmek, logları sadece depolamak yerine olaylara dönüştürmek anlamına gelir.
Tuzak, ilk ikisinde durmaktır. Durum artı loglar, gözlemlenebilirlik gibi hissettirir çünkü elinizde bir hal ve bir kayıt vardır. Ama ölçeklenebilen tek soru, "hangi ajanım bana ihtiyaç duyuyor?", tamamen üçüncü katmanda yaşar.
Gerçekten önem taşıyan hata sinyalleri
Web servisi gözlemlenebilirliği çökmeleri ve gecikmeyi izler. Kodlama ajanları farklı şekilde başarısız olur ve size bir öğleden sonraya mal olan hatalar, kırmızı bir durum olarak görünenlerden nadiren çıkar. Türetmeye değer sinyaller şunlardır.
| Sinyal | Ne anlama gelir | Durum ve loglar neden bunu kaçırır |
|---|---|---|
| Sessiz takılma | Ajan bir istem ya da eksik bir gizli anahtar bekliyordur ve çıktı üretmiyordur | Durum hâlâ "çalışıyor" gösterir; hiçbir şey el kaldırmaz |
| Yeşil ama yanlış | Çalıştırma başarıyla sonlandı ve yanlış şeyi yaptı | Durum "tamamlandı"; yalnızca diff'i okumak bunu ortaya çıkarır |
| Atlanan doğrulama | Typecheck, testler veya build çalıştırılmadan tamamlandı olarak bildirildi | Loglar bu ihmali içerir ama kimse başarılı bir logu okumaz |
| Bütçenin tükenmesi | Görev ortasında model kotasına ya da harcama üst sınırına ulaşıldı | Hata, bir uyarı olarak değil, kesilmiş bir yanıt olarak ortaya çıkar |
| Gizli çakışma | İki ajan ayrı worktree'lerde aynı dosyaları düzenledi | Her iki çalıştırma da "tamamlandı"; çakışma merge'de bekliyor |
| Çırpınma | Ajan aynı dosyayı bir döngü içinde düzenler, geri alır ve yeniden düzenler | Logda her bir adım tek başına sorunsuz görünür |
Altısının ortak örüntüsü şu: hata, durum katmanında görünmez, log katmanında ise gömülüdür. "Yeşil ama yanlış", insanların en çok küçümsediğidir. Yanlış görevi kendinden emin şekilde tamamlayan bir kodlama ajanı, onu tam tutturanla tamamen aynı görünür; ta ki görev düzeyinde kanıtla inceleme bunu yakalayana kadar. Yalnızca çıkış kodlarını bildiren gözlemlenebilirlik, o hatayı başarı olarak raporlar.
Bunlardan ikisi davranışsal değil yapısaldır. Gizli çakışmalar, aynı repo üzerindeki paralel çalışmanın neden görev başına izole worktree gerektirdiğinin cevabıdır; böylece dosya çakışmaları merge sırasında değil, öncesinde ortaya çıkar. Bütçenin tükenmesi de ajanlar arası harcamayı takip etmenin neden durumla aynı görünümde yer alması gerektiğinin cevabıdır; kotası dolduğu için sessizce duran bir çalıştırma, tamamlanmış bir görev değil, bir hata sinyalidir.
Ekip büyüklüğüne göre ne kadar gözlemlenebilirliğe ihtiyacınız var
İlk günden altı sinyalin tümüne ihtiyacınız yok. Doğru araçlandırma miktarı, kaç ajanın çalıştığına ve bunları kaç kişinin görmesi gerektiğine göre ölçeklenir.
| Kurulum | Neyi araçlandırmalı | Nerede kırılır |
|---|---|---|
| Tek ajan, tek görev | Yalnızca durum; başarısız olursa logu okuyun | İkinci bir ajan başlatana kadar hiçbir şey |
| Birkaç bağımsız ajan | Çalıştırma başına durum ile takılma ve "yeşil ama yanlış" sinyalleri | Durumu sessizlikten çıkarırsınız ve takılmaları kaçırırsınız |
| Küçük ekip, paylaşılan repolar | Paylaşılan bir görünümde altı sinyalin tümü ve inceleme durumu | İzleme sisteminiz başka kimsenin göremediği bir dizüstünde yaşar |
| Daha büyük ekip, birçok repo | Yukarıdakiler artı çalıştırma başına sahiplik, bütçe ve denetim izi | Bir hafta sonra kimse "kim neyi çalıştırdı" sorusuna yanıt veremez |
Dürüst değerlendirme şu: birbirinden bağımsız işlerde tek bir ajan çalıştıran yalnız bir geliştiricinin ihtiyaç duyduğu tüm gözlemlenebilirlik tek bir terminalde mevcuttur. Denklem, ajanlarınız ekranlarınızdan fazla olmaya başladığında, işler başında oturmadığınız makinelerde çalıştığında ya da başka biri aynı panoyu görmeye ihtiyaç duyduğunda değişir. Bu çizginin ötesinde, bir durum alanı ve bir log dizini artık yeterli olmaz.
Ham logların ve tek bir çalışma ortamının yeterli olduğu yerler
Yerleşik araçların en iyi hallerini ortaya koyalım, çünkü birçok iş için onlar kazanır. Claude Code ve Codex, ikisi de okunabilir bir oturum izi tutar ve tek bir görevde tek bir ajan için o iz sizin gözlemlenebilirliğinizdir. Siz başlattınız, izliyorsunuz ve durursa logu okuyacaksınız. Buraya bir yönetim katmanı eklemek, saf fazla yüktür.
Bağımsız işlerde bir veya iki ajan çalıştırıyorsanız ve bunlar hiç kimseye devredilmiyorsa, çalışma ortamının kendi çıktısını kullanın. Çalıştırmalar dikkatinizden fazla olduğunda, takip edemeyeceğiniz bir yerde yürütüldüklerinde ya da inceleme özel bir faaliyet olmaktan çıkıp bir ekip etkinliğine dönüşmesi gerektiğinde paylaşılan bir gözlemlenebilirlik katmanına başvurun. Bu son durum, sessiz katildir: beş ajanın paralel şekilde tamamlanması, diff'lerinin incelenmesi tek bir insanın kuyruğuna diziliyorsa bir kazanç değildir. Ajanlar hızlandı; siz yavaşladınız. Bu da bir gözlemlenebilirlik sorunudur ve hiçbir tek çalışma ortamı bunu çözmez; çünkü önemli olan sinyal, "bu çalıştırma tamamlandı ve incelemenizi bekliyor", tek bir ajanın içinde değil, ajanlar arasında yaşar.
Sonuçlar Görev'e döndüğünde gözlemlenebilirlik
Bir görev katmanı, gözlemlenebilirlik birimini "bir penceredeki süreç"ten "bir hali olan Görev"e çevirir. Sharkly'nin üzerine inşa edildiği kayma budur ve üç sinyalin tümüyle aynı anda örtüşür.
Her ajan çalıştırması bir Görev'e bağlanır. Durum, ilerleme, engeller ve sonuçlar, yalnızca sizin görebileceğiniz bir logda yaşamak yerine o Görev'in zaman çizelgesine döner. Hata sinyalleri tek bir yerde ortaya çıkar: bir insana ihtiyaç duyan çalıştırmalar Gelen Kutusu'na düşer; böylece soru "bir şey tamamlandı mı?" olmaktan çıkıp "işte karar vermem gereken şey" haline gelir. Ajanlar araştırır, yürütür, test eder ve raporlar; insanlar yön belirler, yetki verir ve sonucu kabul eder. Otomasyon, ekip muhakemesinin gerektiği yerde durur.
Sınır önemlidir, çünkü yanlış varsaymak kolaydır. Sharkly ajanı çalıştırmaz ya da kodu yazmaz. Yürütmeyi, hâlâ Claude Code, Codex ve kullandığınız diğer çalışma ortamları yapar. Sharkly bunların etrafına paylaşılan görev, Computer, bağlam ve inceleme katmanını ekler; böylece bağlam, ilerleme, engeller, sonuçlar ve insan incelemesi talepten sürüme kadar görünür kalır. Bu paylaşılan panonun neleri göstermesi gerektiğine dair daha geniş bir resim için bir AI kodlama ajanı panosunun gerçekte neye ihtiyacı olduğuna, canlı izleme açısı içinse paralel çalışan kodlama ajanlarının nasıl izleneceğine bakın.
Tek bir ekosisteme bağlanmak yerine birden fazla kodlama ajanını kullanmaya devam etmek istiyorsanız, o paylaşılan, sinyal öncelikli görünüm, Sharkly'nin etrafında tasarlandığı problemdir. Mevcut kodlama ajanlarınızı Sharkly üzerinden çalıştırabilir ve hâlihazırda kullandığınız her çalışma ortamını koruyabilirsiniz.
SSS
Kodlama ajanı gözlemlenebilirliği loglama ile aynı şey mi? Hayır. Loglama, ne olduğunu depolar. Gözlemlenebilirlik, o logları tek tek okumadan her bir ajanın ne yaptığını, neyin başarısız olduğunu ve neyin size ihtiyaç duyduğunu yanıtlayabilmektir. Loglar, gözlemlenebilirliğe giden girdilerden biridir, tamamı değil.
Önce araçlandırılacak en önemli tek hata sinyali hangisidir? Sessiz takılma. Hiç görmediğiniz bir istem üzerinde sonsuza dek beklerken "çalışıyor" gösteren bir ajan, paralel çalışmanın sessizce ölmesinin en yaygın yoludur. Daha süslü şeylerin peşine düşmeden önce, engellenmiş çalıştırmaların el kaldırmasını sağlayın.
Bunu kodlama ajanımın yerleşik çıktısından alabilir miyim? Tek bir ajan için evet. Çalışma ortamının kendi oturum izi yeterlidir. Yerleşik çıktının ajanlar arası bir görünümü yoktur; dolayısıyla beş çalıştırmadan hangisinin size ihtiyaç duyduğunu söyleyemez ki bu, birden fazlasına ölçeklendiğinizde ortaya çıkan sorunun tam da kendisidir.
