Partager via

Utiliser Log Analytics pour la fonctionnalité de diagnostic dans Azure Virtual Desktop (classique)

  • Article

Important

Ce contenu s’applique à Azure Virtual Desktop (classique), qui ne prend pas en charge les objets Azure Resource Manager Azure Virtual Desktop. Si vous essayez de gérer des objets Azure Resource Manager et Azure Virtual Desktop, consultez cet article.

Azure Virtual Desktop offre une fonctionnalité de diagnostic qui permet à l’administrateur d’identifier les problèmes via une seule interface. Cette fonctionnalité journalise les informations de diagnostic chaque fois qu’un rôle Azure Virtual Desktop affecté utilise le service. Chaque journal contient des informations sur le rôle Azure Virtual Desktop impliqué dans l’activité, les messages d’erreur qui s’affichent pendant la session, les informations du locataire et les informations utilisateur. La fonctionnalité de diagnostic crée des journaux d’activité pour les actions d’utilisateur et d’administration. Chaque journal d’activité se trouve sous trois catégories principales :

  • Activités d’abonnement de flux : lorsqu’un utilisateur tente de se connecter à son flux via des applications Bureau à distance Microsoft.
  • Activités de connexion : lorsqu’un utilisateur tente de se connecter à un bureau ou à RemoteApp via des applications Bureau à distance Microsoft.
  • Activités de gestion : lorsqu’un administrateur effectue des opérations de gestion sur le système, telles que la création de pools d’hôtes, l’attribution d’utilisateurs à des groupes d’applications et la création d’attributions de rôles.

Les connexions qui n’atteignent pas Azure Virtual Desktop ne s’affichent pas dans les résultats de diagnostic, car le service de rôle de diagnostic lui-même fait partie d’Azure Virtual Desktop. Les problèmes de connexion Azure Virtual Desktop peuvent se produire lorsque l’utilisateur rencontre des problèmes de connectivité réseau.

Pourquoi utiliser Log Analytics

Nous vous recommandons d’utiliser Log Analytics pour analyser les données de diagnostic dans le client Azure qui dépassent le dépannage d’un seul utilisateur. Comme vous pouvez extraire des compteurs de performances de machine virtuelle dans Log Analytics, vous disposez d’un outil pour collecter des informations pour votre déploiement.

Avant de commencer

Avant de pouvoir utiliser Log Analytics avec la fonctionnalité de diagnostic, vous devez créer un espace de travail.

Une fois que vous avez créé votre espace de travail, suivez les instructions de Connecter des ordinateurs Windows à Azure Monitor pour obtenir les informations suivantes :

  • Identifiant de l’espace de travail
  • Clé primaire de votre espace de travail

Vous aurez besoin de ces informations ultérieurement dans le processus d’installation.

Envoyer des données de diagnostic à votre espace de travail

Vous pouvez transférer des données de diagnostic à partir de votre bailleur Azure Virtual Desktop vers le Log Analytics de votre espace de travail. Vous pouvez configurer cette fonctionnalité immédiatement lorsque vous créez votre locataire pour la première fois en liant votre espace de travail à votre locataire, ou vous pouvez le configurer ultérieurement avec un locataire existant.

Pour lier votre locataire à votre espace de travail Log Analytics pendant que vous configurez votre nouveau locataire, exécutez l’applet de commande suivante pour vous connecter à Azure Virtual Desktop avec votre compte d’utilisateur TenantCreator :

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

Si vous souhaitez lier un locataire existant au lieu d’un nouveau locataire, exécutez cette applet de commande à la place :

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

Vous devez exécuter ces applets de commande pour chaque locataire que vous souhaitez lier à Log Analytics.

Note

Si vous ne souhaitez pas lier l’espace de travail Log Analytics lorsque vous créez un locataire, exécutez plutôt l’applet de commande New-RdsTenant.

Cadence d’envoi d’événements de diagnostic

Les événements de diagnostic sont envoyés à Log Analytics une fois terminés.

Exemples de requêtes

Les exemples de requêtes suivants montrent comment la fonctionnalité de diagnostic génère un rapport pour les activités les plus fréquentes dans votre système :

Ce premier exemple montre les activités de connexion initiées par les utilisateurs avec des clients de bureau à distance pris en charge :

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

Cet exemple de requête suivant montre les activités de gestion par les administrateurs sur les locataires :

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

Arrêter l’envoi de données à Log Analytics

Pour arrêter l’envoi de données d’un locataire existant à Log Analytics, exécutez l’applet de commande suivante et définissez des chaînes vides :

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

Vous devez exécuter cette applet de commande pour chaque locataire à partir duquel vous souhaitez arrêter l’envoi de données.

Étapes suivantes

Pour passer en revue les scénarios d’erreur courants que la fonctionnalité de diagnostic peut identifier pour vous, consultez Identifier et diagnostiquer les problèmes.