« Tüm yayınlar

Asenkron AI Agent Akışlarını OpenTelemetry ve SigNoz ile İzlemek

Asenkron AI agent pipeline'larında OpenTelemetry trace context'ini manuel propagation ve SigNoz ile kuyruktan LLM çağrısına kadar izleme yöntemi.

FastAPI'den Redis/Celery gibi bir arka plan kuyruğuna devredilen AI agent görevlerinde, standart HTTP auto-instrumentation trace bağlamını korumakta yetersiz kalıyor; bu da mühendislerin dağınık log satırlarını manuel olarak birleştirmek zorunda kalmasına yol açıyor. Yeni bir kılavuz, OpenTelemetry trace bağlamının kuyruk sınırı boyunca manuel olarak inject/extract edilmesiyle bu sorunun nasıl çözülebileceğini detaylandırıyor; böylece arka plan worker span'leri, kaynak API isteğinin altında doğru şekilde iç içe görünüyor.

Yaklaşım aynı zamanda LLM çağrısının kendisini de model adı, token sayıları, gecikme süresi ve sağlayıcı gibi özel span attribute'ları ile enstrümante etmeyi kapsıyor; böylece opak 'kara kutu' API çağrıları sorgulanabilir telemetriye dönüşüyor. SigNoz ile görselleştirme birleştirildiğinde, FastAPI isteğini, Celery worker'ını, vektör veritabanı sorgusunu ve LLM üretim adımını kapsayan tam bir Gantt tarzı trace ağacı elde ediliyor.

Gerçek zamanlı risk skorlama, halüsinasyon tespiti veya çok adımlı agent orkestrasyonu gibi gecikmeye hassas pipeline'lar geliştiren ekipler için bu desen, genel OpenTelemetry kurulum kılavuzlarının ele almadığı önemli bir gözlemlenebilirlik boşluğunu kapatıyor ve yavaşlamaların retrieval, orkestrasyon veya model sağlayıcısından mı kaynaklandığını belirlemeyi mümkün kılıyor.