Menggunakan Log Analytics untuk fitur diagnostik di Azure Virtual Desktop (klasik)

  • Artikel

Penting

Konten ini berlaku untuk Azure Virtual Desktop (klasik), yang tidak mendukung objek Azure Resource Manager Azure Virtual Desktop. Jika Anda berusaha mengelola objek Azure Resource Manager Azure Virtual Desktop, baca artikel ini.

Azure Virtual Desktop menawarkan fitur diagnostik yang memungkinkan administrator mengidentifikasi masalah melalui integrasi tunggal. Fitur ini mencatat informasi diagnostik setiap kali seseorang yang diberi peran Azure Virtual Desktop menggunakan layanan ini. Setiap log berisi informasi tentang peran Azure Virtual Desktop mana yang terlibat dalam aktivitas, setiap pesan kesalahan yang muncul selama sesi, informasi penyewa, dan informasi pengguna. Fitur diagnostik membuat log aktivitas untuk tindakan pengguna dan administratif. Setiap log aktivitas termasuk dalam tiga kategori utama:

  • Aktivitas langganan umpan: saat pengguna mencoba menyambungkan ke umpan melalui aplikasi Microsoft Remote Desktop.
  • Aktivitas koneksi: saat pengguna mencoba menyambungkan ke desktop atau RemoteApp melalui aplikasi Microsoft Remote Desktop.
  • Aktivitas manajemen: ketika administrator melakukan operasi manajemen pada sistem, seperti membuat kumpulan host, menetapkan pengguna ke grup aplikasi, dan membuat penetapan peran.

Koneksi yang tidak mencapai Azure Virtual Desktop tidak akan muncul dalam hasil diagnostik karena layanan peran diagnostik itu sendiri adalah bagian dari Azure Virtual Desktop. Masalah koneksi Azure Virtual Desktop dapat terjadi saat pengguna mengalami masalah konektivitas jaringan.

Alasan Anda harus menggunakan Log Analytics

Kami menyarankan Anda menggunakan Log Analytics untuk menganalisis data diagnostik di klien Azure yang melampaui pemecahan masalah pengguna tunggal. Karena dapat menarik penghitung kinerja VM ke Log Analytics, Anda memiliki satu alat untuk mengumpulkan informasi untuk penyebaran.

Sebelum Anda memulai

Sebelum dapat menggunakan Log Analytics dengan fitur diagnostik, Anda harus membuat ruang kerja.

Setelah Anda membuat ruang kerja, ikuti petunjuk dalam Menyambungkan komputer Windows ke Azure Monitor untuk mendapatkan informasi berikut:

  • ID ruang kerja
  • Kunci utama ruang kerja Anda

Anda akan memerlukan informasi ini nanti dalam proses penyiapan.

Mendorong data diagnostik ke ruang kerja Anda

Anda dapat mendorong data diagnostik dari penyewa Azure Virtual Desktop ke Log Analytics untuk ruang kerja Anda. Anda dapat langsung menyiapkan fitur ini saat pertama kali membuat penyewa dengan menautkan ruang kerja ke penyewa, atau Anda dapat menyiapkannya nanti dengan penyewa yang sudah ada.

Untuk menautkan penyewa ke ruang kerja Log Analytics saat menyiapkan penyewa baru, jalankan cmdlet berikut untuk masuk ke Azure Virtual Desktop dengan akun pengguna TenantCreator Anda:

Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com

Jika Anda akan menautkan penyewa yang sudah ada, bukan penyewa baru, jalankan cmdlet ini sebagai gantinya:

Set-RdsTenant -Name <TenantName> -AzureSubscriptionId <SubscriptionID> -LogAnalyticsWorkspaceId <String> -LogAnalyticsPrimaryKey <String>

Anda harus menjalankan cmdlet ini untuk setiap penyewa yang ingin ditautkan ke Log Analytics.

Catatan

Jika Anda tidak ingin menautkan ruang kerja Log Analytics saat membuat penyewa, jalankan cmdlet New-RdsTenant sebagai gantinya.

Tempo untuk mengirim peristiwa diagnostik

Peristiwa diagnostik dikirim ke Log Analytics setelah selesai.

Contoh kueri

Contoh kueri berikut menunjukkan bagaimana fitur diagnostik membuat laporan untuk aktivitas yang paling sering di sistem Anda:

Contoh pertama ini menunjukkan aktivitas koneksi yang dimulai oleh pengguna dengan klien desktop jarak jauh yang didukung:

WVDActivityV1_CL
| where Type_s == "Connection"
| join kind=leftouter (
    WVDErrorV1_CL
    | summarize Errors = makelist(pack('Time', Time_t, 'Code', ErrorCode_s , 'CodeSymbolic', ErrorCodeSymbolic_s, 'Message', ErrorMessage_s, 'ReportedBy', ReportedBy_s , 'Internal', ErrorInternal_s )) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g 
| join  kind=leftouter (
    WVDCheckpointV1_CL
    | summarize Checkpoints = makelist(pack('Time', Time_t, 'ReportedBy', ReportedBy_s, 'Name', Name_s, 'Parameters', Parameters_s) ) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g
|project-away ActivityId_g, ActivityId_g1

Contoh kueri berikutnya ini menunjukkan aktivitas manajemen oleh admin pada penyewa:

WVDActivityV1_CL
| where Type_s == "Management"
| join kind=leftouter (
    WVDErrorV1_CL
    | summarize Errors = makelist(pack('Time', Time_t, 'Code', ErrorCode_s , 'CodeSymbolic', ErrorCodeSymbolic_s, 'Message', ErrorMessage_s, 'ReportedBy', ReportedBy_s , 'Internal', ErrorInternal_s )) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g 
| join  kind=leftouter (
    WVDCheckpointV1_CL
    | summarize Checkpoints = makelist(pack('Time', Time_t, 'ReportedBy', ReportedBy_s, 'Name', Name_s, 'Parameters', Parameters_s) ) by ActivityId_g
    ) on $left.Id_g  == $right.ActivityId_g
|project-away ActivityId_g, ActivityId_g1

Berhenti mengirim data ke Log Analytics

Untuk berhenti mengirim data dari penyewa yang sudah ada ke Log Analytics, jalankan cmdlet berikut dan atur string kosong:

Set-RdsTenant -Name <TenantName> -AzureSubscriptionId <SubscriptionID> -LogAnalyticsWorkspaceId <String> -LogAnalyticsPrimaryKey <String>

Anda harus menjalankan cmdlet ini untuk setiap penyewa asal pengiriman data yang ingin Anda hentikan.

Langkah berikutnya

Untuk meninjau skenario kesalahan umum yang dapat diidentifikasi oleh fitur diagnostik untuk Anda, lihat Mengidentifikasi dan mendiagnosis masalah.