Log Analytics gebruiken voor de diagnostische functie in Azure Virtual Desktop (klassiek)

  • Artikel

Belangrijk

Deze inhoud is van toepassing op Azure Virtual Desktop (klassiek), dat geen ondersteuning biedt voor Azure Resource Manager Azure Virtual Desktop-objecten. Als u Azure Resource Manager Azure Virtual Desktop-objecten wilt beheren, raadpleegt u dit artikel.

Azure Virtual Desktop biedt een diagnostische functie waarmee de beheerder problemen kan identificeren via één interface. Met deze functie worden diagnostische gegevens geregistreerd wanneer iemand die de Azure Virtual Desktop-rol heeft toegewezen, de service gebruikt. Elk logboek bevat informatie over welke Azure Virtual Desktop-rol betrokken was bij de activiteit, eventuele foutberichten die tijdens de sessie worden weergegeven, tenantgegevens en gebruikersgegevens. De diagnostische functie maakt activiteitenlogboeken voor zowel gebruikers- als beheeracties. Elk activiteitenlogboek valt onder drie hoofdcategorieën:

  • Feedabonnementactiviteiten: wanneer een gebruiker verbinding probeert te maken met de feed via Microsoft Extern bureaublad-toepassingen.
  • Verbindingsactiviteiten: wanneer een gebruiker verbinding probeert te maken met een bureaublad of RemoteApp via Microsoft Extern bureaublad-toepassingen.
  • Beheeractiviteiten: wanneer een beheerder beheerbewerkingen uitvoert op het systeem, zoals het maken van hostgroepen, het toewijzen van gebruikers aan toepassingsgroepen en het maken van roltoewijzingen.

Verbindingen die Azure Virtual Desktop niet bereiken, worden niet weergegeven in diagnostische resultaten omdat de diagnostische functieservice zelf deel uitmaakt van Azure Virtual Desktop. Verbindingsproblemen met Azure Virtual Desktop kunnen optreden wanneer de gebruiker problemen ondervindt met de netwerkverbinding.

Waarom u Log Analytics moet gebruiken

U wordt aangeraden Log Analytics te gebruiken om diagnostische gegevens in de Azure-client te analyseren die verder gaan dan het oplossen van problemen met één gebruiker. Omdat u VM-prestatiemeteritems kunt ophalen in Log Analytics, beschikt u over één hulpprogramma om informatie voor uw implementatie te verzamelen.

Voordat u aan de slag gaat

Voordat u Log Analytics kunt gebruiken met de diagnostische functie, moet u een werkruimte maken.

Nadat u uw werkruimte hebt gemaakt, volgt u de instructies in Windows-computers verbinden met Azure Monitor voor de volgende informatie:

  • De werkruimte-id
  • De primaire sleutel van uw werkruimte

U hebt deze informatie later in het installatieproces nodig.

Diagnostische gegevens naar uw werkruimte pushen

U kunt diagnostische gegevens van uw Azure Virtual Desktop-tenant naar Log Analytics voor uw werkruimte pushen. U kunt deze functie direct instellen wanneer u uw tenant voor het eerst maakt door uw werkruimte te koppelen aan uw tenant, of u kunt deze later instellen met een bestaande tenant.

Als u uw tenant wilt koppelen aan uw Log Analytics-werkruimte terwijl u uw nieuwe tenant instelt, voert u de volgende cmdlet uit om u met uw TenantCreator-gebruikersaccount aan te melden bij Azure Virtual Desktop:

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

Als u een bestaande tenant wilt koppelen in plaats van een nieuwe tenant, voert u in plaats daarvan deze cmdlet uit:

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

U moet deze cmdlets uitvoeren voor elke tenant die u wilt koppelen aan Log Analytics.

Notitie

Als u de Log Analytics-werkruimte niet wilt koppelen wanneer u een tenant maakt, voert u de New-RdsTenant cmdlet uit.

Frequentie voor het verzenden van diagnostische gebeurtenissen

Diagnostische gebeurtenissen worden naar Log Analytics verzonden wanneer ze zijn voltooid.

Voorbeelden van query's

De volgende voorbeeldquery's laten zien hoe de diagnostische functie een rapport genereert voor de meest frequente activiteiten in uw systeem:

In dit eerste voorbeeld ziet u verbindingsactiviteiten die zijn geïnitieerd door gebruikers met ondersteunde extern bureaublad-clients:

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

In deze volgende voorbeeldquery ziet u beheeractiviteiten door beheerders op tenants:

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

Stoppen met het verzenden van gegevens naar Log Analytics

Als u wilt stoppen met het verzenden van gegevens van een bestaande tenant naar Log Analytics, voert u de volgende cmdlet uit en stelt u lege tekenreeksen in:

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

U moet deze cmdlet uitvoeren voor elke tenant van waaruit u geen gegevens meer wilt verzenden.

Volgende stappen

Als u veelvoorkomende foutscenario's wilt bekijken die met de diagnostische functie voor u kunnen worden geïdentificeerd, raadpleegt u Problemen identificeren en diagnosticeren.