Session Watch (Aperçu) surveille une session PowerShell distante vers Active Directory et enregistre les changements d’état de la session, de la session côté serveur, de la connexion réseau ou des vérifications du contrôleur de domaine. Vous pouvez utiliser les fichiers CSV et de synthèse obtenus pour comparer les horodatages UTC avec d’autres journaux.
État de l’aperçu et périmètre pris en charge
Session Watch est une fonctionnalité en aperçu. Elle peut être modifiée ou supprimée avant sa version complète, et pourrait ne pas devenir disponible de manière générale. Cet aperçu surveille uniquement les sessions Active Directory via IPv4. Il ne surveille pas les sessions Exchange.
Ce que Session Watch enregistre
Session Watch ouvre une session PowerShell distante vers le serveur Active Directory depuis le conteneur où l’outil s’exécute. Il utilise la même méthode de connexion que le conteneur de production et maintient la session ouverte pendant la durée que vous sélectionnez.
Lors de chaque cycle, Session Watch vérifie la session ouverte, les autres sessions sur le serveur Active Directory qui utilisent le même compte, ainsi que la connectivité réseau. Il écrit chaque résultat dans un fichier CSV et génère une synthèse à la fin du test.
Utilisez Session Watch pour :
- Identifier si et quand la session cesse de fonctionner.
- Enregistrer les défaillances temporaires, y compris une vérification échouée qui réussit au cycle suivant.
- Déterminer si un problème est d’abord apparu dans la session, le serveur Active Directory, le réseau ou un contrôleur de domaine.
- Collecter des horodatages UTC à comparer avec d’autres journaux.
Session Watch collecte des observations. Il n’identifie pas la cause d’un problème.
Cet aperçu couvre uniquement Active Directory, via IPv4. Il ne surveille pas les sessions Exchange.
Vérifier l’utilisation du compte et la journalisation avant de commencer
Le test utilise le compte que vous saisissez. Il s’agit normalement du compte utilisé par le conteneur de production lors de la configuration locale.
- Limites de sessions du compte : les sessions de test sont comptabilisées dans les mêmes limites par utilisateur sur le serveur Active Directory. Un test de longue durée ajoute une charge à ce compte.
- Journaux du contrôleur de domaine : chaque cycle effectue au moins trois appels avec le compte. Ces appels génèrent des événements de connexion, notamment 4624 et 4634, ainsi que des événements Kerberos ou NTLM, dans le journal de sécurité des contrôleurs de domaine. Informez les administrateurs Active Directory avant d’exécuter un test long.
- Méthode d’authentification : Windows sélectionne Kerberos lorsque Url AD contient un nom de serveur et que le conteneur peut atteindre un contrôleur de domaine. Windows sélectionne NTLM dans les autres cas, par exemple lorsque Url AD contient une adresse IP. Si NTLM est désactivé, seul Kerberos peut être utilisé. Dans cette configuration, une adresse IP dans Url AD échoue généralement.
- Fenêtre : gardez l’outil ouvert pendant toute la durée du test. Utilisez une fenêtre en plein écran pour une meilleure expérience utilisateur.
Démarrer un test Session Watch
- Dans le menu, sous « Aperçu”, sélectionnez « Session Watch (Aperçu) ».
- Saisissez le compte Active Directory, le mot de passe et l’Url AD. Utilisez le nom du serveur Active Directory tel qu’il est configuré pour le conteneur de production.
- Répondez aux trois questions de configuration. Appuyez sur Entrée pour accepter une valeur par défaut.
| Question | Valeur par défaut | Signification |
|---|---|---|
| Durée en minutes | 30 | La durée totale du test. Sélectionnez une valeur supérieure à la période après laquelle le problème survient habituellement. |
| Intervalle en secondes | 90 (minimum 30) | La pause entre les cycles. Un intervalle plus court enregistre davantage de détails et crée davantage d’événements de connexion. |
| Délai d’expiration de la commande en secondes | 60 | Le délai maximal pendant lequel une vérification peut attendre une réponse avant que Session Watch l’enregistre comme HANG. Ce délai s’applique également à l’ouverture et à la fermeture d’une session. |
- Vérifiez l’avertissement, qui affiche le nombre prévu de cycles et d’appels, puis confirmez le test.
Vérifications effectuées pendant chaque test
L’écran affiche une ligne pour chaque vérification et les événements récents sous le tableau.
| Vérification | Fonctionnement |
|---|---|
| Lecture AD | Lit chaque domaine via la session que Session Watch maintient ouverte. |
| Sessions du compte | Vérifie les autres sessions distantes qui utilisent le même compte sur le serveur Active Directory. |
| Session surveillée | Vérifie la session Session Watch telle que le serveur Active Directory la voit. |
| Réseau AD | Effectue une recherche de nom et une tentative de connexion depuis le conteneur vers chaque adresse du serveur Active Directory sur le port 5985. |
| Instantané du contrôleur de domaine | Au début, à la fin et au premier KO ou HANG de la lecture AD, ouvre une courte session distincte sur le serveur Active Directory. La session vérifie chaque contrôleur de domaine sur les ports 88 et 9389, puis effectue une lecture lorsque le port 9389 est ouvert. Le port 88 est utilisé pour Kerberos. Le port 9389 est utilisé pour les services Web Active Directory, utilisés par les commandes PowerShell Active Directory. |
| Nouvelle session | Au premier KO ou HANG de la lecture AD, ouvre une nouvelle session vers le même serveur avec le même compte. Cela indique si une nouvelle session peut être ouverte alors que la session d’origine ne peut pas être utilisée. |
Interpréter les colonnes à l’écran
- État : le résultat le plus récent.
- Dernières ms et Min/Moy/Max ms : les temps de réponse.
- OK/Échec : le nombre de vérifications réussies et échouées. Échec inclut KO, HANG et BUSY.
- Détail : un résultat ou message d’erreur raccourci pour tenir dans la fenêtre. Le texte complet est écrit dans le fichier CSV. La valeur est jaune lorsque l’état a changé au cours du cycle actuel.
Arrêter un test avant sa fin prévue
Appuyez sur Q ou Ctrl+C pour arrêter le test. Session Watch ferme ses sessions et écrit la synthèse. Si des cycles ont déjà démarré, il effectue une dernière vérification du contrôleur de domaine avant de fermer.
Chaque opération de fermeture de session n’attend pas plus longtemps que le délai d’expiration de commande configuré.
Valeurs d’état écrites par Session Watch
| État | Signification |
|---|---|
| OK | La vérification s’est terminée avec succès. |
| KO | La vérification a échoué avec une erreur. |
| HANG | La vérification n’a pas renvoyé de réponse avant le délai d’expiration. |
| BUSY | La vérification n’a pas été exécutée, car la session était encore occupée par une commande enregistrée comme HANG. |
| STOPPED | Le test a été interrompu avec Q ou Ctrl+C. |
Trouver les fichiers CSV et de synthèse
Session Watch écrit tous les fichiers dans C:\temp. Chaque nom de fichier contient la date et l’heure de début locales.
| Fichier | Contenu |
|---|---|
sessionwatch_<date>_<time>.csv |
Tous les résultats de test, écrits pendant l’exécution du test. |
sessionwatch_<date>_<time>_rest.csv |
Créé uniquement lorsque le CSV principal est verrouillé à la fin du test, par exemple si le fichier est ouvert dans Excel. Il contient les lignes qui n’ont pas pu être écrites dans le CSV principal. |
sessionwatch_<date>_<time>_summary.txt |
La synthèse du test, écrite à la fin du test. |
Si le CSV est ouvert dans Excel pendant l’exécution du test, les nouvelles lignes attendent que le fichier soit disponible, puis sont écrites dans le CSV.
Colonnes CSV
| Colonne | Contenu |
|---|---|
| TimeUtc | Date et heure en UTC. |
| Cycle | Numéro de cycle. Le cycle 0 correspond au début du test. |
| Check, Target | L’élément vérifié et le domaine, la machine ou la session vérifiés. |
| Status, Ms | Le résultat et le temps de réponse. |
| SessionState | L’état de la session maintenue ouverte pour la lecture AD, par exemple Opened ou Broken. |
| Server | Le système qui a répondu. Pour Réseau AD, il s’agit de l’adresse tentée. |
| Detail | Le texte complet du résultat ou de l’erreur. |
Créer une synthèse à partir d’un CSV existant
Pour créer à nouveau une synthèse, y compris pour un fichier CSV plus ancien, sélectionnez « Synthèse Session Watch (Aperçu) » sous « Aperçu » dans le menu, puis sélectionnez le fichier CSV.
Lire le fichier de synthèse
Le fichier de synthèse contient cinq sections.
- En-tête : le fichier CSV source, les heures de début et de fin en UTC, le nombre de cycles et les paramètres du test.
- À PROPOS DU TEST : une description du test sur quatre lignes.
- SYNTHÈSE PAR VÉRIFICATION : une ligne pour chaque vérification et cible. La ligne contient le nombre de résultats OK, KO, HANG et Autres, le temps de réponse le plus lent, ainsi que l’heure et le cycle du premier problème. Réseau AD comporte une ligne pour chaque adresse.
-
CHRONOLOGIE (UTC) : uniquement les changements, y compris les étapes de début ; le premier problème pour chaque vérification ; chaque changement d’état ; les changements d’état de la session, de contrôleur de domaine répondant et de nombre d’autres sessions ; chaque instantané de contrôleur de domaine ; et les événements de fermeture de session. Une ligne au format
--- <date> ---identifie chaque nouveau jour. - À PROPOS DES VÉRIFICATIONS : une description de chaque vérification.
Exemple de synthèse par vérification
| Vérification | Cible | OK | KO | HNAG | Autre | Le plus lent | Premier problème |
|---|---|---|---|---|---|---|---|
| Lecture AD | contoso.local |
3 | 3 | 0 | 0 | 147 ms | 09:48:44 cycle 4 |
| Sessions du compte | dc01.contoso.local |
6 | 0 | 0 | 0 | 39 ms | - |
| Session surveillée | dc01.contoso.local |
3 | 3 | 0 | 0 | 39 ms | 09:48:47 cycle 4 |
| Réseau AD |
192.0.2.10 |
7 | 0 | 0 | 0 | 11 ms | - |
| Réseau AD |
198.51.100.20 |
0 | 6 | 0 | 0 | 2121 ms | 09:47:09 cycle 1 |
| Nouvelle session | dg-endurance-AD-check |
1 | 0 | 0 | 0 | 161 ms | - |
| Instantané du contrôleur de domaine | dc01.contoso.local |
2 | 0 | 0 | 0 | 98 ms | - |
Chronologie (UTC)
--- 2026-10-24 --- | ||
| 09:47:09 | Réseau AD |
198.51.100.20 KO : Filtré - aucune réponse dans les 2000 ms |
| 09:48:44 | Lecture AD | session Opened → Broken
|
| 09:48:44 | Lecture AD |
contoso.local OK → KO : Impossible d’effectuer l’opération, car le pool d’espaces d’exécution n’est pas dans l’état Opened. L’état actuel est Broken. |
| 09:48:46 | Nouvelle session | OK : ouverte |
| 09:48:47 | Instantané du contrôleur de domaine |
dc01.contoso.local OK : premier échec : 88 Open - 9389 Open - lecture OK |
| 09:48:47 | Fermer la session |
dg-endurance-AD-check OK en 12 ms |
| 09:48:47 | Session surveillée | OK → KO : introuvable sur le serveur - le conteneur voit la session comme Broken
|
Interpréter les résultats de la synthèse
Pendant le test, le point de terminaison Active Directory (AD) 198.51.100.20 était inaccessible sur le port 5985. Les six tentatives de connexion ont expiré après environ deux secondes. L’autre point de terminaison AD, 192.0.2.10, était accessible lors des six tentatives.
Pendant le cycle 4, à 09:48:44 UTC, la session AD persistante est passée de Opened à Broken. La vérification de lecture AD a ensuite échoué, car elle ne pouvait plus utiliser le pool d’espaces d’exécution existant.
Les vérifications de récupération ont réussi : une nouvelle session a été ouverte à 09:48:46 UTC et l’instantané du contrôleur de domaine s’est terminé à 09:48:47 UTC. Toutefois, la vérification de la session surveillée ne pouvait plus trouver la session surveillée sur le serveur, confirmant que la session persistante d’origine avait été perdue.
Limitations de l’aperçu
- Session Watch maintient une session ouverte. Le conteneur de production peut ouvrir plusieurs sessions en même temps. Un problème nécessitant plusieurs sessions simultanées, tel qu’une limite de serveur par utilisateur, peut ne pas se produire pendant le test. Sessions du compte affiche le nombre de sessions du compte.
- Session Watch n’inspecte pas le conteneur de production. Il ouvre sa propre session depuis le conteneur où l’outil s’exécute. Un problème causé uniquement par le conteneur de production, tel que son code ou sa charge, peut ne pas se produire pendant le test.
- Sessions du compte répertorie les sessions du compte uniquement sur le serveur auquel la session Session Watch se connecte. Si Url AD peut mener à plusieurs serveurs, les sessions sur les autres serveurs ne sont pas comptabilisées. Session Watch affiche une ligne jaune au début du test lorsque cette condition s’applique.