Exemples de requêtes de diagnostic pour la mise à jour d’hôte de session dans Azure Virtual Desktop

Article
10/27/2024

Important

La mise à jour d’hôte de session pour Azure Virtual Desktop est actuellement en PRÉVERSION. Cette préversion est fournie en l’état, avec tous les défauts et selon les disponibilités, et est exclue des contrats de niveau de service (SLA) ou de toute garantie limitée que Microsoft fournit pour les services Azure en disponibilité générale. Pour vous inscrire à la préversion limitée, remplissez ce formulaire : https://forms.office.com/r/ZziQRGR1Lz.

Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

La mise à jour d’hôte de session utilise Log Analytics dans Azure Monitor pour stocker des informations sur les mises à jour. Cet article contient quelques exemples de requêtes que vous pouvez utiliser avec Log Analytics pour afficher des informations de diagnostic sur les mises à jour d’hôte de session.

Prérequis

Avant de pouvoir utiliser ces requêtes, vous avez besoin des éléments suivants :

Un pool d’hôtes existant avec une configuration d’hôte de session.
Les paramètres de diagnostic configurés sur chaque pool d’hôtes que vous utilisez avec la mise à jour d’hôte de session pour envoyer des journaux et des métriques à un espace de travail Log Analytics. Au minimum, les catégories Point de contrôle, Erreur et Journaux d’activité de la Gestion des hôtes de session doivent être activés.
Une mise à jour d’hôte de session déjà planifiée et exécutée sur les hôtes de session dans le pool d’hôtes.

Emplacement des données de diagnostic

Une fois que vous avez configuré les paramètres de diagnostic sur un pool d’hôtes, les données de diagnostic pour la mise à jour d’hôte de session sont stockées dans les tables WVDSessionHostManagement et WVDCheckpoints de votre espace de travail Log Analytics. Les entrées de journal utilisent le type d’activité Gestion existant, qui provient du fournisseur Azure Resource Manager (ARM).

La table WVDSessionHostManagement est spécifique à la mise à jour d’hôte de session et est créée une fois que vous avez activé la catégorie Journaux d’activité de la Gestion des hôtes de session sur les paramètres de diagnostic de chaque pool d’hôtes que vous utilisez avec la mise à jour d’hôte de session, et les exécutions de mise à jour d’hôte de session. Si vous avez déjà configuré les paramètres de diagnostic pour un pool d’hôtes, vous devez activer la catégorie Journaux d’activité de la Gestion des hôtes de session. Pour plus d’informations, consultez Configurer les paramètres de diagnostic pour capturer les journaux et les métriques de plateforme pour Azure Virtual Desktop.

Le reste de cet article présente des exemples de requêtes que vous pouvez exécuter. Vous pouvez les utiliser comme base pour créer vos propres requêtes. Vous devez exécuter chacune de ces requêtes dans Log Analytics. Pour plus d’informations sur l’exécution des requêtes, consultez Démarrer Log Analytics.

Mises à jour d’hôte de session terminées avec succès

Cette requête met en corrélation les tables WVDSessionHostManagement et WVDCheckpoints afin de fournir le temps écoulé pour effectuer une mise à jour et la durée moyenne pour mettre à jour un seul hôte de session en minutes au cours des 30 derniers jours :

let timeRange                               = ago(30d);
let succeededStatus                         = "Succeeded";
let hostPoolUpdateCompletedCheckpoint       = "HostPoolUpdateCompleted";
let sessionHostUpdateCompletedCheckpoint    = "SessionHostUpdateCompleted";
let provisioningTypeUpdate                  = "Update";
WVDSessionHostManagement
| where ProvisioningStatus == succeededStatus and TimeGenerated >= timeRange and ProvisioningType == provisioningTypeUpdate
| join kind = inner (
      // Get number of session hosts updated
    WVDCheckpoints
    | where Name == hostPoolUpdateCompletedCheckpoint
    | extend ParametersParsed = parse_json(Parameters)
    | extend SessionHostUpdateCount = ParametersParsed["SessionHostsUpdateCompleted"], UpdateCompletionTime = todatetime(ParametersParsed["TimeCompleted"]), UpdateStartTime = todatetime(ParametersParsed["TimeStarted"])
    | project CorrelationId, SessionHostUpdateCount, UpdateStartTime, UpdateCompletionTime
) on CorrelationId
| join kind = inner
(
      // Get time to update individual session hosts
    WVDCheckpoints
    | where Name == sessionHostUpdateCompletedCheckpoint
    | extend ParametersParsed = parse_json(Parameters)
    | extend SessionHostUpdateTime = todecimal(ParametersParsed["TimeTakenToUpdateSessionHostInSeconds"])
    // Calculate median time to update session host
    | summarize SessionHostMedianUpdateTime = percentile(SessionHostUpdateTime, 50) by CorrelationId
) on CorrelationId
| project TimeGenerated, _SubscriptionId, _ResourceId, CorrelationId, UpdateStartDateTime = UpdateStartTime, UpdateEndDateTime = UpdateCompletionTime, ['UpdateDuration [InMinutes]'] = datetime_diff('minute', UpdateCompletionTime, UpdateStartTime), SessionHostUpdateCount, ['MedianSessionHostUpdateTime [InMinutes]'] = toint(SessionHostMedianUpdateTime/(60 * 1.0)), UpdateBatchSize = UpdateMaxVmsRemoved, FromSessionHostConfigVer, ToSessionHostConfigVer, UpdateDeleteOriginalVm