Referensi perintah Agen 365 CLI logs

Kelola log diagnostik CLI. Perintah logs mengekspor salinan file log CLI yang disunting yang aman untuk dibagikan dengan dukungan Microsoft. Gunakan logs export subperintah untuk menyunting dan menyalin file log CLI. File yang diekspor aman untuk dilampirkan ke tiket dukungan tanpa membocorkan email, GUID, atau token.

Peran minimum yang diperlukan: Tidak ada. Perintah membaca dan menulis ulang file log lokal saja.

Syntax

a365 logs [command] [options]

logs export

Ekspor salinan file log diagnostik CLI yang diedit yang aman untuk dibagikan dengan dukungan Microsoft. Menyunting token JWT, alamat email, GUID, dan nama pengguna jalur OS, dan mengganti nilai identik dengan alias yang konsisten sehingga korelasi log dipertahankan.

a365 logs export [<command>] [options]

CLI menulis file log diagnostik untuk setiap perintah tingkat atas ke direktori log lokal Anda (misalnya, %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ pada Windows). logs export membaca satu atau semua file tersebut, menghapus konten sensitif, dan menulis salinan yang disunting ke direktori output yang Anda pilih.

Apa yang disunting

Pattern	Replacement
Token pembawa JWT (header.payload.signature)	<JWT-TOKEN>
Email addresses	<email-1>, <email-2>, ... (alias yang konsisten per email)
GUID (8-4-4-4-12) — lihat Apa yang dipertahankan untuk pengecualian	<id-1>, <id-2>, ... (alias yang konsisten per GUID)
Nama pengguna jalur OS (C:\Users\<name>, /Users/<name>, ) /home/<name>	<username-1>, , <username-2>...

Nilai yang identik mempertahankan alias yang sama di seluruh file, sehingga referensi silang dalam log tetap berguna untuk mendiagnosis masalah. File yang disunting mencakup header yang mencatat jalur sumber (dengan redaksi yang sama diterapkan) dan jumlah setiap pola yang diganti.

What's preserved

Redaktor dengan sengaja menyimpan konten berikut kata demi kata sehingga log yang disunting masih berguna untuk penelusuran kesalahan dan untuk eskalasi dukungan Microsoft:

Preserved	Mengapa aman
Stempel waktu, tingkat log, nama cakupan, kode kesalahan, jalur file (dengan nama pengguna diganti), kode status HTTP, bentuk JSON	Tak satu pun dari ini mengidentifikasi penyewa atau pengguna.
TraceId: <guid> dan CorrelationId: <guid> nilai	Pengidentifikasi acak sesi lokal yang dihasilkan oleh CLI. Mereka tidak sensitif dan merekalah yang memasangkan log dengan pelacakan sisi server.
Nilai request-id dan client-request-id di dalam badan kesalahan Microsoft Graph	Dihasilkan server per panggilan. Dukungan Microsoft menggunakan ini untuk mencari permintaan yang tepat dalam log layanan saat Anda meningkatkan.
ID aplikasi sumber daya Microsoft dan Agen 365 publik yang terkenal: • Microsoft Graph (00000003-0000-0000-c000-000000000000) • API Bot Pesan Agen 365 • API Observabilitas Agen 365 • API Power Platform (Konektivitas) • Alat Agen 365 (audiens MCP, produksi)	Ini adalah konstanta publik yang didokumentasikan — mereka tidak mengungkapkan apa pun tentang penyewa Anda. Melestarikannya berarti baris seperti Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 tetap dapat dibaca alih-alih menjadi ... against <id-4>.

ID objek perwakilan layanan khusus penyewa dan GUID lain yang tidak cocok dengan pola di atas masih disunting melalui mekanisme alias konsisten.

Important

Pola penyuntingan dirancang untuk menghapus konten sensitif yang paling umum. Jika log Anda berisi rahasia kustom (misalnya, rahasia yang dicatat dengan kode di luar CLI ini, atau nilai yang ditempelkan ke dalam pelacakan tumpukan) dalam format yang tidak dikenali redaksi ini, hapus secara manual sebelum dibagikan.

Cara memverifikasi sebelum berbagi

Buka file yang disunting di editor teks dan pindai apa pun yang terlihat spesifik penyewa:

# Spot-check what was preserved vs aliased
Select-String -Path .\a365.setup.redacted.log -Pattern "CorrelationId|TraceId|request-id" | Select-Object -First 10
Select-String -Path .\a365.setup.redacted.log -Pattern "<id-|<email-|<JWT-TOKEN>|<username-" | Measure-Object

Baris header file yang diekspor merangkum hitungan. Jika Anda melihat jumlah <id-N> alias yang lebih tinggi dari yang Anda harapkan, peta alias melakukan tugasnya — setiap GUID khusus penyewa mendapatkan persis satu alias.

export Opsi

Option	Description
<command>	Nama perintah yang lognya ingin Anda ekspor (seperti setup atau cleanup). Hilangkan argumen ini untuk mengekspor setiap file log yang tersedia dalam satu eksekusi.
-o, --output <output>	Direktori untuk menulis file log atau file yang disunting. Default ke direktori saat ini.
-?, , -h--help	Tampilkan bantuan dan informasi penggunaan.

Examples

Ekspor setup log ke direktori saat ini:

a365 logs export setup

Ekspor setiap log yang tersedia ke folder tertentu:

a365 logs export --output ./support-bundle

Ekspor cleanup log ke folder tertentu:

a365 logs export cleanup --output ./support-bundle

Penamaan file keluaran

File yang diekspor ditulis sebagai a365.<command>.redacted.log. Saat Anda menghilangkan <command>, CLI mengekspor setiap log yang tersedia ke dalam file yang disunting sendiri dengan pola penamaan yang sama.

Important

Tinjau file yang disunting sebelum membagikannya. Pola redaksi mencakup token JWT, email, GUID, dan nama pengguna jalur OS, tetapi tidak mencakup setiap rahasia yang mungkin. Jika log Anda berisi rahasia kustom atau ID sensitif dalam format lain, hapus secara manual sebelum dibagikan.

Note

logs export tidak menghapus atau memodifikasi file log asli. Log asli tetap berada di direktori log lokal Anda. Perintah hanya menulis salinan yang diedit ke direktori output.