Envoyer des données de diagnostic à Log Analytics pour Azure Virtual Desktop

  • Article

Important

Ce contenu s’applique à Azure Virtual Desktop avec des objets Azure Virtual Desktop pour Azure Resource Manager. Si vous utilisez Azure Virtual Desktop (classique) sans objets Azure Resource Manager, consultez cet article.

Azure Virtual Desktop utilise Azure Monitor pour la supervision et les alertes, comme de nombreux autres services Azure. Les administrateurs peuvent ainsi identifier les problèmes par le biais d’une interface unique. Le service crée des journaux d’activité pour les actions des utilisateurs et des administrateurs. Chaque journal d’activité se divise en les catégories suivantes :

Category Description
Activités de gestion Si les tentatives de modification des objets Azure Virtual Desktop avec des API ou PowerShell réussissent.
Flux Si les utilisateurs parviennent à s’abonner aux espaces de travail.
Connexions Moment auquel les utilisateurs lancent et finalisent les connexions au service.
Inscription de l’hôte Si l’hôte de la session s’est correctement inscrit auprès du service lors de la connexion.
Erreurs Où les utilisateurs rencontrent des problèmes avec des activités spécifiques.
Points de contrôle Étapes spécifiques dans la durée de vie d’une activité qui ont été atteintes.
État d’Agent Health Surveillez l’intégrité et l’état de l’agent Azure Virtual Desktop installé sur chaque hôte de session.
Network (Réseau) Les données réseau moyennes pour les sessions utilisateur afin de surveiller certains détails, comme le temps aller-retour estimé.
Graphiques de connexion Les données de performances à partir du flux de graphiques d’Azure Virtual Desktop.
Activité de la gestion des hôtes de la session Activité de la gestion des hôtes de la session.
Mise à l’échelle automatique Opérations de mise à l’échelle.

Les connexions qui n’atteignent pas Azure Virtual Desktop ne figureront pas dans les résultats de diagnostic, car le service de rôle de diagnostics fait partie d’Azure Virtual Desktop. Des problèmes de connexion à Azure Virtual Desktop peuvent survenir lorsque l’utilisateur rencontre des problèmes de connectivité au réseau.

Azure Monitor vous permet d’analyser les données Azure Virtual Desktop et d’examiner les compteurs de performances des machines virtuelles, le tout au sein du même outil. Cet article explique plus en détail comment activer les diagnostics dans un environnement Azure Virtual Desktop.

Remarque

Pour savoir comment superviser vos machines virtuelles dans Azure, consultez Supervision de machines virtuelles Azure avec Azure Monitor. Veillez également à passer en revue le glossaire Azure Virtual Desktop Insights pour mieux comprendre votre expérience utilisateur sur l’hôte de la session.

Prérequis

Avant de pouvoir utiliser Azure Virtual Desktop avec Log Analytics, vous avez besoin des éléments suivants :

Envoyer (push) les données de diagnostic à votre espace de travail

Vous pouvez envoyer (push) les données de diagnostic de vos objets Azure Virtual Desktop à Log Analytics pour votre espace de travail. Vous pouvez configurer cette fonctionnalité immédiatement au moment où vous créez vos objets.

Pour configurer Log Analytics pour un nouvel objet :

  1. Connectez-vous au Portail Azure et accédez à Azure Virtual Desktop.

  2. Accédez à l’objet (par exemple, un pool d’hôtes, un groupe d’applications ou un espace de travail) pour lequel vous souhaitez capturer des journaux et des événements.

  3. Sélectionnez Paramètres de diagnostic dans le menu sur le côté gauche de l’écran.

  4. Sélectionnez Ajouter un paramètre de diagnostic dans le menu sur le côté gauche de l’écran.

    Les options affichées dans la page Paramètres de diagnostic varient selon le type d’objet que vous modifiez.

    Par exemple, quand vous activez les diagnostics pour un groupe d’applications, vous voyez les options permettant de configurer les points de contrôle, les erreurs et la gestion. Dans le cas des espaces de travail, ces catégories configurent un flux pour suivre le moment auquel les utilisateurs s’abonnent à la liste des applications. Pour en savoir plus sur les paramètres de diagnostic, consultez Créer un paramètre de diagnostic pour collecter les journaux et les métriques des ressources dans Azure.

    Important

    N’oubliez pas d’activer les diagnostics pour chaque objet Azure Resource Manager que vous souhaitez superviser. Les données sont disponibles pour les activités une fois les diagnostics activés. La première configuration peut prendre quelques heures.

  5. Entrez un nom pour la configuration de vos paramètres, puis sélectionnez Envoyer à Log Analytics. Le nom que vous utilisez ne doit pas contenir d’espaces et doit être conforme aux conventions de nommage Azure. Dans le cadre des journaux, vous pouvez sélectionner toutes les options que vous souhaitez ajouter à votre analytique des journaux, telles que les points de contrôle, les erreurs, la gestion, etc.

  6. Sélectionnez Enregistrer.

Notes

Log Analytics vous donne la possibilité d’effectuer un streaming des données vers Event Hubs ou de les archiver dans un compte de stockage. Pour en savoir plus sur cette fonctionnalité, consultez Envoyer en streaming des données de supervision Azure vers un hub d’événements et Archiver des journaux de ressource Azure dans un compte de stockage.

Comment accéder à Log Analytics

Vous pouvez accéder aux espaces de travail Log Analytics sur le portail Azure ou sur Azure Monitor.

Accéder à Log Analytics sur un espace de travail Log Analytics

  1. Connectez-vous au portail Azure.

  2. Recherchez Espace de travail Log Analytics.

  3. Sous Services, sélectionnez Espaces de travail Log Analytics.

  4. Dans la liste, sélectionnez l’espace de travail que vous avez configuré pour votre objet Azure Virtual Desktop.

  5. Une fois dans votre espace de travail, sélectionnez Journaux. Vous pouvez filtrer votre liste de menu avec la fonction Rechercher.

Accéder à Log Analytics sur Azure Monitor

  1. Connectez-vous au portail Azure.

  2. Recherchez et sélectionnez Surveiller.

  3. Sélectionnez Journaux d’activité.

  4. Suivez les instructions de la page de journalisation pour définir l’étendue de votre requête.

  5. Vous êtes prêt à interroger les diagnostics. Toutes les tables de diagnostics ont un préfixe « WVD ».

Notes

Pour plus d’informations sur les tables stockées dans les journaux Azure Monitor, consultez la documentation de référence sur les données Azure Monitor. Toutes les tables relatives à Azure Virtual Desktop ont le préfixe « WVD ».

Cadence d’envoi des événements de diagnostic

Les événements de diagnostic sont envoyés à Log Analytics lorsqu’ils sont terminés.

Les rapports Log Analytics ne portent que sur les états intermédiaires suivants des activités de connexion :

  • Démarré : lorsqu’un utilisateur sélectionne et se connecte à une application ou à un ordinateur de bureau dans le client Bureau à distance.
  • Connecté : lorsque l’utilisateur se connecte avec succès à la machine virtuelle sur laquelle l’application ou le bureau est hébergé.
  • Terminé : lorsque l’utilisateur ou le serveur déconnecte la session dans laquelle l’activité a eu lieu.

Exemples de requêtes

Accédez à des exemples de requêtes par le biais de l’interface utilisateur d’Azure Monitor Log Analytics :

  1. Accédez à votre espace de travail Log Analytics, puis sélectionnez Journaux. L’interface utilisateur de l’exemple de requête s’affiche automatiquement.
  2. Changez le filtre en Catégorie.
  3. Sélectionnez Azure Virtual Desktop pour examiner les requêtes disponibles.
  4. Sélectionnez Exécuter pour exécuter la requête sélectionnée.

Pour plus d’informations sur l’interface de l’exemple de requête, consultez Requêtes enregistrées dans Azure Monitor Log Analytics.

La liste de requêtes suivante vous permet de consulter les informations ou les problèmes de connexion pour un seul utilisateur. Vous pouvez exécuter ces requêtes dans l’éditeur de requête Log Analytics. Pour chaque requête, remplacez userupn par l’UPN de l’utilisateur que vous souhaitez rechercher.

Pour rechercher toutes les connexions d’un seul utilisateur :

WVDConnections
|where UserName == "userupn"
|take 100
|sort by TimeGenerated asc, CorrelationId

Pour déterminer le nombre de fois qu’un utilisateur s’est connecté par jour :

WVDConnections
|where UserName == "userupn"
|take 100
|sort by TimeGenerated asc, CorrelationId
|summarize dcount(CorrelationId) by bin(TimeGenerated, 1d)

Pour rechercher la durée de session par utilisateur :

let Events = WVDConnections | where UserName == "userupn" ;
Events
| where State == "Connected"
| project CorrelationId , UserName, ResourceAlias , StartTime=TimeGenerated
| join (Events
| where State == "Completed"
| project EndTime=TimeGenerated, CorrelationId)
on CorrelationId
| project Duration = EndTime - StartTime, ResourceAlias
| sort by Duration asc

Pour rechercher les erreurs liées à un utilisateur spécifique :

WVDErrors
| where UserName == "userupn"
|take 100

Pour déterminer si une erreur spécifique s’est produite pour d’autres utilisateurs :

WVDErrors
| where CodeSymbolic =="ErrorSymbolicCode"
| summarize count(UserName) by CodeSymbolic

Notes

  • Quand un utilisateur démarre une session de bureau complet, son utilisation de l’application dans la session n’est pas suivie sous la forme de points de contrôle dans la table WVDCheckpoints.
  • La colonne ResourcesAlias de la table WVDConnections indique si un utilisateur s’est connecté à un bureau complet ou à une application publiée. La colonne affiche uniquement la première application ouverte pendant la connexion. Toutes les applications publiées que l’utilisateur ouvre sont suivies dans WVDCheckpoints.
  • La table WVDErrors affiche les erreurs de gestion, les problèmes d’inscription de l’hôte et d’autres problèmes qui se produisent lorsque l’utilisateur s’abonne à une liste d’applications ou de bureaux.
  • La table WVDErrors vous permet également d’identifier les problèmes qui peuvent être résolus par des tâches d’administration. La valeur ServiceError doit toujours être égale à false pour ces types de problèmes. Si ServiceError est égal à true, vous devez faire remonter le problème à Microsoft. Vérifiez que vous fournissez le CorrelationID pour les erreurs que vous escaladez.
  • Lorsque vous déboguez des problèmes de connectivité, dans certains cas, les informations du client peuvent être manquantes même si les événements de connexion se terminent. Cela s’applique aux tables WVDConnections et WVDCheckpoints.

Étapes suivantes