Share via

Utilisation de la journalisation enrichie pour les transactions synthétiques dans Lync Server 2013

  • Article

 

Rubrique Dernière modification : 2012-10-22

Les transactions synthétiques (introduites dans Microsoft Lync Server 2010) permettent aux administrateurs de vérifier que les utilisateurs sont en mesure d’effectuer des tâches courantes telles que la connexion au système, l’échange de messages instantanés ou l’appel à un téléphone situé sur le réseau téléphonique commuté (RTC). Ces tests (qui sont empaquetés sous la forme d’un ensemble d’applets de commande Windows PowerShell Lync Server) peuvent être effectués manuellement par un administrateur, ou ils peuvent être exécutés automatiquement par une application telle que System Center Operations Manager.

Dans Lync Server 2010, les transactions synthétiques se sont avérées extrêmement utiles pour aider les administrateurs à identifier les problèmes liés au système. Par exemple, l’applet de commande Test-CsRegistration peut alerter les administrateurs du fait que certains utilisateurs éprouvent des difficultés à s’inscrire auprès de Lync Server. Toutefois, les transactions synthétiques ont été un peu moins utiles pour aider les administrateurs à déterminer pourquoi ces utilisateurs avaient de la difficulté à s’inscrire auprès de Lync Server. Cela est dû au fait que les transactions synthétiques n’ont pas fourni d’informations de journalisation détaillées qui pourraient aider les administrateurs à résoudre les problèmes liés à Lync Server. Au mieux, la sortie détaillée d’une transaction synthétique fournit des informations pas à pas qui peuvent permettre à un administrateur de faire une estimation éclairée de l’endroit où un problème s’est probablement produit.

Dans Microsoft Lync Server 2013, les transactions synthétiques ont été recréées pour fournir une journalisation enrichie. La « journalisation enrichie » signifie que, pour chaque activité effectuée par une transaction synthétique, des informations telles que celles-ci seront enregistrées :

  • Heure à laquelle l’activité a démarré

  • Heure de fin de l’activité

  • Action effectuée (par exemple, création, participation ou sortie d’une conférence; connexion à Lync Server, envoi d’un message instantané, etc.)

  • Les messages informatifs, détaillés, d’avertissement ou d’erreur générés pendant l’exécution de l’activité.

  • Messages d’inscription SIP

  • Enregistrements d’exception ou codes de diagnostic générés lors de l’exécution de l’activité

  • Résultat net de l’exécution de l’activité

Ces informations sont générées automatiquement chaque fois qu’une transaction synthétique est exécutée. Toutefois, les informations ne sont pas automatiquement affichées ou enregistrées dans un fichier journal. Au lieu de cela, les administrateurs qui exécutent manuellement une transaction synthétique peuvent utiliser le paramètre OutLoggerVariable pour spécifier une variable Windows PowerShell dans laquelle les informations seront stockées. À partir de là, les administrateurs peuvent ensuite utiliser une paire de méthodes qui leur permettent d’enregistrer et/ou d’afficher le journal enrichi au format XML ou HTML.

Par exemple, les administrateurs Lync Server 2010 peuvent exécuter l’applet de commande Test-CsRegistration à l’aide d’une commande similaire à la suivante :

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com

Les administrateurs ont la possibilité d’inclure le paramètre OutLoggerVariable suivi d’un nom de variable de leur choix :

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable RegistrationTest

Remarque

Ne faites pas précéder le nom de la variable du caractère $ . Utilisez un nom de variable comme RegistrationTest et non $RegistrationTest.

La commande précédente génère du contenu similaire à ce qui suit :

Target Fqdn   : atl-cs-001.litwareinc.com
Result        : Failure
Latency       : 00:00:00
Error Message : This machine does not have any assigned certificates.
Diagnosis     :

Toutefois, des informations beaucoup plus détaillées sont disponibles pour cet échec que le message d’erreur ci-dessus. Pour accéder à ces informations au format HTML, utilisez une commande similaire à celle-ci afin d’enregistrer les informations stockées dans la variable RegistrationTest dans un fichier HTML :

$RegistrationTest.ToHTML() | Out-File C:\Logs\Registration.html

Vous pouvez aussi utiliser la méthode ToXML() pour enregistrer les données dans un fichier XML :

$RegistrationTest.ToXML() | Out-File C:\Logs\Registration.xml

Ces fichiers peuvent ensuite être affichés à l’aide d’Internet Explorer, de Visual Studio ou de toute autre application capable d’ouvrir des fichiers HTML/XML.

Les transactions synthétiques exécutées à partir de System Center Operations Manager génèrent automatiquement ces fichiers journaux en cas de défaillances. Toutefois, ces journaux ne seront pas générés si l’exécution échoue avant que Windows PowerShell ne puisse charger et exécuter la transaction synthétique.

Important

Par défaut, Lync Server 2013 enregistre les fichiers journaux dans un dossier qui n’est pas partagé. Pour rendre ces journaux d’activité facilement accessibles, vous devez partager ce dossier (par exemple, \\atl-watcher-001.litwareinc.com\WatcherNode.