Pelacakan & Pengamatan

Segera hadir

Dokumentasi DevUI untuk C# akan segera hadir. Silakan periksa kembali nanti atau lihat dokumentasi Python untuk panduan konseptual.

Mengaktifkan Pelacakan

Aktifkan pelacakan saat memulai DevUI dengan flag --tracing.

devui ./agents --tracing

Ini memungkinkan pelacakan OpenTelemetry untuk operasi Kerangka Kerja Agen.

Melihat Jejak di DevUI

Saat pelacakan diaktifkan, antarmuka web DevUI menampilkan informasi pelacakan:

1. Menjalankan agen atau alur kerja melalui UI
2. Buka panel debug (tersedia dalam mode pengembang)
3. Lihat garis waktu pelacakan yang memperlihatkan:
   • Hierarki rentang
   • Informasi waktu
   • Peristiwa agen/alur kerja
   • Panggilan alat dan hasil

Struktur Pelacakan

Agent Framework mengeluarkan jejak mengikuti konvensi semantik OpenTelemetry untuk GenAI. Jejak yang biasa meliputi:

Agent Execution
    LLM Call
        Prompt
        Response
    Tool Call
        Tool Execution
        Tool Result
    LLM Call
        Prompt
        Response

Untuk alur kerja, pelacakan menunjukkan jalur proses eksekusi melalui pelaksana:

Workflow Execution
    Executor A
        Agent Execution
            ...
    Executor B
        Agent Execution
            ...

Pelacakan melalui Pemrograman

Saat menggunakan DevUI secara terprogram dengan serve(), pelacakan dapat diaktifkan:

from agent_framework.devui import serve

serve(
    entities=[agent],
    tracing_enabled=True
)

Integrasi dengan Alat Eksternal

DevUI menangkap dan menampilkan jejak yang dipancarkan oleh Kerangka Kerja Agen - itu tidak membuat rentangnya sendiri. Ini adalah jejak OpenTelemetry standar yang juga dapat diekspor ke alat pengamatan eksternal seperti:

• Jaeger
• Zipkin
• Azure Monitor
• Datadog

Untuk mengekspor jejak ke pengumpul eksternal, atur OTLP_ENDPOINT variabel lingkungan:

export OTLP_ENDPOINT="http://localhost:4317"
devui ./agents --tracing

Tanpa titik akhir OTLP, jejak ditangkap secara lokal dan hanya ditampilkan di panel debug DevUI.