Vercel Daemons artık OpenTelemetry izlerini Vercel Tracing'e aktarabiliyor

Daemons, Vercel Tracing'e katıldı

Vercel gözlemlenebilirlik kapsamını arka plan işlerine genişletti. Vercel blog'una göre, platformun arka plan worker hizmeti olan Daemons artık OpenTelemetry izlerini Vercel Tracing'e gönderebiliyor. Bir daemon tarafından üretilen izler, projenin diğer izlerinin yanında incelenebiliyor ve Vercel bu özelliği hem mühendisler hem de onların adına hareket eden otomatik agent'lar için yararlı olarak konumlandırıyor.

Exporter endpoint yerine bir socket

Mekanizma, platform tarafından sağlanan bir Unix socket. Vercel, her daemon'un OTLP/HTTP izlerini kabul etmek için kendi socket'ini aldığını ve bu socket'in yolunun VERCEL_OTEL_SOCKET_PATH ortam değişkeni aracılığıyla sürece sunulduğunu belirtiyor. SDK socket'i kendi başına tespit ettiği için, bir daemon'un harici bir collector endpoint'ine yönlendirilmesi veya telemetri göndermek için kimlik bilgileriyle donatılması gerekmiyor.

Node.js daemon'ları için entegrasyon neredeyse sıfır yapılandırma gerektiriyor. @vercel/otel SDK'sını 2.3.0 veya sonraki bir sürüme yükseltmek, varsayılan yapılandırma altında otomatik iz aktarımını etkinleştiriyor ve SDK, bir worker'ın kaydettiği span'ları Vercel'e iletiyor. Vercel'in öne çıkardığı tek gereklilik, OpenTelemetry'nin worker başlamadan önce ilklendirilmesi; bu da SDK'nın registerOTel fonksiyonuna "my-daemon" gibi seçilmiş bir service name ile tek bir çağrı yapılması anlamına geliyor.

CLI üzerinden span sorgulama

Bir kez aktarıldığında, daemon span'ları Vercel CLI üzerinden erişilebilir hale geliyor. Bir traces search komutu projeye ve service name'e göre filtreleme yapabiliyor ve sonuçları JSON olarak döndürebiliyor; Vercel bu formatı agent'lar için kullanışlı olarak gösteriyor. Changelog'daki örnek olan vercel traces search --project my-project --service my-daemon --json, bir daemon'un son bir saatteki span'larını hem bir insanın hem de otomatik bir aracın ayrıştırabileceği yapılandırılmış çıktı olarak getiriyor. Vercel ayrıca okuyucuları daha fazla ayrıntı için daemon tracing dokümantasyonuna yönlendiriyor.

Neden önemli

Arka plan worker'ları geleneksel olarak gözlemlenebilirlikte kör bir nokta olmuştur. Request/response döngüsünün dışında çalıştıkları için gecikme sıçramaları, yeniden denemeleri ve sessiz hataları çoğu zaman web trafiğiyle aynı yerde görünmez ve ekipler onları görebilmek için sık sık ayrı bir collector veya satıcı eklemek zorunda kalır. Daemon span'larını platformun zaten kullandığı aynı OpenTelemetry hattı üzerinden Vercel Tracing'e yönlendirerek Vercel bu boşluğu kapatıyor: artık tek bir iz görünümü hem bir işi kuyruğa koyan frontend isteğini hem de onu işleyen worker'ı kapsayabiliyor.

İki tasarım kararı öne çıkıyor. Birincisi, otomatik olarak tespit edilen bir Unix socket kullanmak, OTLP export'una genellikle eşlik eden endpoint ve kimlik bilgisi kurulumunu ortadan kaldırıyor ve worker'ları instrument etmenin önündeki sürtünmeyi düşürüyor. İkincisi, CLI'nın JSON üretmesi, Vercel'in hata ayıklama iş akışlarının giderek daha agent odaklı hale geleceğini beklediğini gösteriyor: bir sorunu fark eden bir agent, bir insanın dashboard açmasını beklemeden doğrudan bir daemon'un span'larında arama yapabilir. Zaten iş yüklerini Vercel'de çalıştıran ekipler için pratik çıkarım basit: @vercel/otel'i 2.3.0 veya sonrasına güncelleyin, varsayılan yapılandırmayı koruyun, SDK'yı worker başlamadan önce ilklendirin ve arka plan worker'ları görünmez olmaktan çıksın.