Vercel CLI'ya trace span arama eklendi: geliştiriciler ve agent'lar artık terminalden hata ayıklayabilecek

Vercel, komut satırı aracına trace span arama özelliği ekledi. Şirketin changelog kaydına göre yeni vercel traces search komutu, gözlemlenebilirlik (observability) verisini terminale taşıyor ve geliştiricilerin — ayrıca kod yazan agent'ların — hataları, gecikmeleri ve güvenlik açısından hassas davranışları Vercel dashboard'unu açmadan incelemesini sağlıyor.

Span'ları terminalden aramak

Bir span, bir isteğin içindeki tek bir adımı temsil eder; bu da onun bir şeyin nerede yanlış gittiğini veya yavaşladığını bulmak için doğal birim haline getirir. Daha önce bu tür bir inceleme dashboard'u açmayı gerektiriyordu; yeni komut bu iş akışını shell içinde tutuyor.

Varsayılan olarak vercel traces search son bir saatteki en yeni önce sıralamayla en fazla 100 span döndürüyor. Bu varsayılan yaygın bir ön koşulu ortadan kaldırıyor: başlamadan önce bir request ID ya da trace ID bilmeniz gerekmiyor. Komutu çalıştırın, en güncel olanlara bakın, sonra aralığı daraltın.

Komut; ortam, servis, span adı, durum, deployment ID, request ID, trace ID ve span ID için özel filtreler, ayrıca zaman aralıkları için --since ve --until içeriyor. Changelog'daki iki örnek:

text

son bir saatteki hata span'ları

vercel traces search --status error --since 1h

tek bir trace içindeki tüm span'lar

vercel traces search --trace-id 4bf92f3577b34da6a3ce929d0e0e4736

KQL sorguları ve JSON çıktısı

Özel bir flag'i olmayan her şey için --query, Kibana Query Language (KQL) alt kümesini kabul ediyor. Changelog, bunun duration gibi alanların yanı sıra span ve kaynak (resource) niteliklerini kapsadığını belirtiyor; dolayısıyla aşağıdaki gibi bir sorgu iki saniyeden yavaş span'ları buluyor:

text vercel traces search --query 'span.duration > 2000'

-- flag'i span başına bir JSON nesnesi çıkarıyor. Changelog bunu, betiklerin ve agent'ların analiz edebilmesi için yapılandırılmış veri olarak tanımlıyor — otomatik araçların başka türlü kazımak zorunda kalacağı biçimlendirilmiş terminal metni yerine makine tarafından okunabilir bir çıktı.

Kullanılabilirlik

Özellik bir CLI güncellemesiyle geliyor: en yeni sürüme geçmek için vercel upgrade komutunu çalıştırın, ardından tam seçenek listesi için vercel traces search --help komutunu kullanın. Vercel, daha fazla ayrıntı için vercel traces dokümanına işaret ediyor.

Neden önemli

Gözlemlenebilirlik verisi tarihsel olarak web dashboard'larında yaşadı; bu, tarayıcıdaki insanlar için iyi çalışıyor ama giderek yaygınlaşan iki iş akışı için kötü: terminal öncelikli geliştirme ve otomatik kod yazan agent'lar.

Bu değişiklik ikisine de hizmet ediyor. Geliştiriciler için bir tanımlayıcıyı bir yerde bulup dashboard'a yapıştırmanın gidiş gelişi kayboluyor — hızlı bir --status error --since 1h araması henüz bozulanların anlık görünümünü veriyor ve tam bir trace'e inmek tek bir flag uzağınızda. Agent'lar için JSON çıktısı, teşhisin kodu yazan ve dağıtan araç zincirinin içinde yapılabileceği anlamına geliyor: başarısız bir deployment fark eden bir agent, ilgili span'ları çekebilir, hata veren ya da yavaş adımı bulabilir ve bir insanın tarayıcı ile terminal arasında bilgi taşımasına gerek kalmadan harekete geçebilir.

Çerçeveleme de dikkat çekici. Changelog, kod yazan agent'ları geliştiricilerin yanı sıra birincil hedef kitle olarak sayıyor — bu da tedarikçilerin, kullanıcının bir program olabileceği varsayımıyla geliştirici araçları tasarladığının bir işareti daha. Yapılandırılmış çıktı ve ifade gücü yüksek bir sorgu söz dizimi, tam olarak shell'e yazı yazan bir insana da shell'i yöneten bir agent'a da eşit derecede iyi hizmet eden türden bir arayüz.