Penelusuran dan penanganan data

Foundry tracing adalah kemampuan observabilitas di Microsoft Foundry yang mengumpulkan Data Pelanggan dari agen AI. Ini membantu pengembang dan operator memahami perilaku sistem, men-debug masalah, dan mengoptimalkan performa.

Melacak informasi rekaman seperti:

  • Input dan perintah pengguna
  • Masukan dan keluaran agen dan model
  • Pemanggilan alat dan langkah-langkah perantara
  • Metadata eksekusi (tanda waktu, latensi, penggunaan token, kesalahan, dll.)

Data ini mungkin mencakup konten yang dihasilkan pengguna dan telemetri operasional.

Data ini digunakan untuk memberikan visibilitas tentang bagaimana agen berjalan, memungkinkan pemecahan masalah dan peningkatan performa di seluruh alur kerja agen. Foundry menggunakan standar OpenTelemetry dan menyimpan data pelacakan dalam sistem telemetri yang terhubung Azure Monitor Application Insights.

Important

Saat Anda mengaktifkan AppInsights untuk proyek, AppInsights mencatat jejak untuk membantu memantau dan mengevaluasi interaksi tingkat pengguna dengan agen. Anggota proyek dengan peran Log Analytics Reader di AppInsights dapat melihat data penelusuran, yang mungkin berisi data pribadi dan konten pelanggan. Jika tabel Log Analytics yang mendasar dilindungi (tingkat perlindungannya diatur ke Dilindungi), anggota memerlukan peran Pembaca Data Pemantauan Istimewa untuk melihat data pelacakan tersebut. Tinjau data pelacakan apa yang dikumpulkan dan siapa yang dapat melihat dan menggunakan data ini. Informasi selengkapnya ada di bagian berikut.

Status default:

  • Pelacakan nonaktif secara default.
  • Tidak ada data jejak yang dikumpulkan atau disimpan kecuali diaktifkan secara eksplisit oleh Pemilik Akun Foundry atau Pemilik Foundry.

Harga Azure Monitor App Insights tambahan mungkin berlaku.

Ini memastikan pelanggan mempertahankan kontrol saat pengumpulan data dimulai.

Aktifkan penelusuran

Pelacakan diaktifkan saat proyek terhubung ke sumber daya Application Insights Azure Monitor. Alur pengaktifan umum meliputi:

  • Membuat atau menyambungkan sumber daya Application Insights selama pembuatan proyek.
  • Membuat atau menyambungkan sumber daya Application Insights ke proyek yang ada tanpa sumber daya Application Insights yang terhubung.

Saat Anda mengaktifkan pelacakan:

  • Data pelacakan mulai dikumpulkan dan disimpan untuk semua agen dalam proyek.
  • Untuk melihat trace di UI Foundry Tracing, pengguna memerlukan akses ke proyek Foundry dan izin baca pada Application Insights atau ruang kerja Log Analytics yang terhubung. Misalnya, peran seperti Log Analytics Reader, Monitoring Reader, atau Reader pada sumber daya Application Insights, ruang kerja Log Analytics, atau cakupan induk yang sesuai dapat memberikan akses ini. Jika tabel Log Analytics yang mendasar dilindungi, penerima tugas juga memerlukan peran Pembaca Data Pemantauan Istimewa untuk membaca data tersebut.

Menonaktifkan pelacakan

Nonaktifkan pelacakan dengan:

  • Memutuskan atau menghapus sumber daya Application Insights.

Setelah Anda menonaktifkan pelacakan:

  • Tidak ada data jejak baru yang dikumpulkan pada agen dalam proyek tersebut.
  • Data yang dikumpulkan sebelumnya tetap tunduk pada kebijakan retensi Application Insights.

Note

Langkah-langkah tepat tentang cara menonaktifkan pelacakan tergantung pada permukaan UI atau SDK dan harus selaras dengan dokumentasi produk.

Tempat data disimpan

  • Sumber daya Application Insights yang terhubung ke proyek Foundry menyimpan data pelacakan.
  • Application Insights dan konfigurasi Log Analytics Anda mengatur retensi dan penyimpanan data. Untuk informasi selengkapnya, lihat Mengelola retensi data di ruang kerja Log Analytics.

Pertimbangan berbagi data

  • Data pelacakan mungkin dapat diakses oleh pengguna dengan izin yang sesuai pada sumber daya telemetri yang terhubung.
  • Bergantung pada konfigurasi, pengguna dalam proyek atau penyewa yang sama mungkin melihat data.
  • Untuk melihat trace di UI Foundry Tracing, pengguna memerlukan akses ke proyek Foundry dan izin baca pada Application Insights atau ruang kerja Log Analytics yang terhubung. Misalnya, peran seperti Log Analytics Reader, Monitoring Reader, atau Reader pada sumber daya Application Insights, ruang kerja Log Analytics, atau cakupan induk yang sesuai dapat memberikan akses ini. Jika tabel Log Analytics yang mendasar dilindungi, penerima tugas juga memerlukan peran Pembaca Data Pemantauan Istimewa untuk membaca data tersebut.
  • Untuk pertimbangan lain dan informasi penting yang khusus berlaku untuk agen yang dihosting, tinjau agen yang dihosting dan variabel lingkungan agen yang dihosting yang disuntikkan oleh platform.

Pelanggan bertanggung jawab untuk mengonfigurasi kontrol akses dan memastikan kepatuhan terhadap kebijakan organisasi mereka.

Privasi

Pelacakan dapat mengambil data pribadi termasuk:

  • Permintaan dan respons pengguna
  • Konten khusus aplikasi

Praktik terbaik

  • Hindari mencatat rahasia, kredensial, atau token.
  • Redaksi atau minimalkan data pribadi sebelum dicatat.
  • Terapkan kontrol akses dan kebijakan penyimpanan untuk melacak data.

Kontrol perlindungan data

  • Redaksi data pribadi: Redaksi data pribadi, seperti alamat email dan nomor telepon.
  • Batasi akses ke data pelacakan dengan mengelola pengguna mana yang diberikan peran RBAC Log Analytics Reader dengan cermat. Saat tabel Log Analytics yang mendasar dilindungi, kelola juga siapa yang memiliki peran Pembaca Data Pemantauan Istimewa, karena memberikan akses baca ke tabel yang dilindungi.
  • Kebijakan yang dapat dikonfigurasi: Mengontrol data apa yang diambil dan terlihat.

Kontrol ini membantu Anda mengelola risiko dan mematuhi persyaratan privasi.

Tanggung jawab pelanggan

Saat mengaktifkan pelacakan, Anda bertanggung jawab untuk:

  • Memberi tahu pengguna akhir tentang pengumpulan data, termasuk jenis data yang dikumpulkan, tujuannya, siapa yang memiliki visibilitas, opsi mereka, dan informasi lain yang diperlukan bagi mereka untuk membuat pilihan yang wajar (jika berlaku).
  • Memastikan kepatuhan terhadap persyaratan privasi, hukum, dan peraturan.
  • Mengonfigurasi kontrol akses dan kebijakan retensi data yang sesuai.

RINGKASAN

Foundry Tracing adalah fitur observabilitas canggih yang memungkinkan debugging, pemantauan, dan pengoptimalan agen AI. Hal ini:

  • Nonaktif secara default.
  • Diaktifkan secara eksplisit dengan menyambungkan sumber daya telemetri.
  • Dirancang dengan kontrol pelanggan atas pengumpulan dan penanganan data.

Konten terkait

  • Terakhir diperbarui pada