Application Insights kullanarak izleme
Sorun giderme ve hata ayıklama için aracınızın yürütmelerinin ardındaki mantığı belirlemek önemlidir. Ancak, karmaşık aracılar için çeşitli nedenlerle zor olabilir:
- Yanıt oluşturmada çok sayıda adım söz konusu olabilir ve bu da bunların tümünün izlenmesini zorlaştırabilir.
- Adım dizisi, kullanıcı girişlerine göre farklılık gösterebilir.
- Her aşamadaki girişler/çıkışlar uzun olabilir ve daha ayrıntılı incelemeyi hak ediyor olabilir.
- Bir aracının çalışma zamanının her adımı iç içe geçmeyi de içerebilir. Örneğin, aracı başka bir işlem kullanan ve ardından başka bir aracı çağıran bir araç çağırabilir. Üst düzey bir aracı çalıştırmasından garip veya yanlış bir çıkış fark ederseniz, yürütmede sorunun tam olarak nerede ortaya çıkarıldığını saptamak zor olabilir.
İzleme, belirli bir aracı çalıştırmasına dahil olan her temel öğeye ait girişleri ve çıkışları çağrıldıkları sırayla net bir şekilde görmenizi sağlayarak bu sorunu çözer.
Application Insights kaynağı oluşturma
İzleme, OpenTelemetry kullanarak ve Azure AI Foundry projenize application insights kaynağı ekleyerek aracınızın performansını ve davranışını analiz etmenizi sağlar.
Application Insights kaynağı eklemek için Azure AI Foundry portalında İzleme sekmesine gidin ve henüz yoksa yeni bir kaynak oluşturun.
Oluşturulduktan sonra bir Application Insights bağlantı dizesi alabilir, aracılarınızı yapılandırabilir ve Azure İzleyici aracılığıyla aracınızın tam yürütme yolunu izleyebilirsiniz. Genellikle aracı oluşturmadan önce izlemeyi etkinleştirmek istersiniz.
Aracıyı izleme
İlk olarak OpenTelemetry ve Azure SDK izleme eklentisini yüklemek için kullanın pip install
.
pip install opentelemetry
pip install azure-core-tracing-opentelemetry
Ayrıca gözlemlenebilirlik arka ucuna sonuç göndermek için bir ihracatçıya ihtiyacınız olacaktır. İzlemeleri konsola yazdırabilir veya Aspire Panosu gibi yerel bir görüntüleyici kullanabilirsiniz. Aspire Panosu'na veya başka bir OpenTelemetry uyumlu arka ucuna bağlanmak için OpenTelemetry Protocol (OTLP) verenini yükleyin.
pip install opentelemetry-exporter-otlp
Paketleri yükledikten sonra aracılarınızla izleme uygulamak için aşağıdaki Python örneklerinden birini kullanabilirsiniz. Konsol izleme kullanan örnekler sonuçları konsolda yerel olarak görüntüler. Azure İzleyici kullanan örnekler, izlemeleri Azure AI Foundry portalında , portalın sol gezinti menüsündeki İzleme sekmesindeki Azure İzleyici'ye gönderir.
Not
Aracı izleme işlevinde bilinen bir hata var. Hata, içerik kaydı etkinleştirilmediğinde bile aracının işlev aracının ilgili bilgileri (hassas bilgiler içerebilen işlev adları ve parametre değerleri) izlemelere dahil edilmesine neden olur.
Azure İzleyici'nin kullanımı
Konsol izlemeyi kullanma