Использование расширенного ведения журнала для искусственных транзакций в Lync Server 2013

 

Последнее изменение раздела: 2012-10-22

Искусственные транзакции (появившиеся в Microsoft Lync Server 2010) позволяют администраторам убедиться, что пользователи могут успешно выполнять распространенные задачи, такие как вход в систему, обмен мгновенными сообщениями или вызовы на телефон, расположенный в телефонной сети общего пользования (ТСОП). Эти тесты (упакованные в виде набора командлетов Lync Server Windows PowerShell) могут выполняться администратором вручную или автоматически запускаться приложением, например System Center Operations Manager.

В Lync Server 2010 искусственные транзакции оказались очень полезными, помогая администраторам выявлять проблемы с системой. Например, командлет Test-CsRegistration может оповещений администраторов о том, что некоторым пользователям сложно зарегистрироваться в Lync Server. Однако искусственные транзакции были несколько менее полезными, помогая администраторам определить, почему у этих пользователей возникли трудности при регистрации в Lync Server. Это было связано с тем, что искусственные транзакции не предоставляют подробные сведения о ведении журнала, которые могут помочь администраторам устранить проблемы с Lync Server. В лучшем случае подробные выходные данные из искусственной транзакции, предоставляемые пошаговые сведения, которые могут позволить администратору догадать, где, скорее всего, возникла проблема.

В Microsoft Lync Server 2013 искусственные транзакции были повторно спроектированы для обеспечения расширенного ведения журнала. "Расширенное ведение журнала" означает, что для каждого действия, которое выполняет искусственная транзакция, будут записываться такие сведения:

  • Время начала действия

  • Время завершения действия

  • Выполненное действие (например, создание, присоединение или выход из конференции, вход в Lync Server, отправка мгновенного сообщения и т. д.)

  • Информационные, подробные сообщения, предупреждения или сообщения об ошибках, которые были созданы при выполнении операции

  • Сообщения о регистрации SIP

  • Записи исключений или диагностические коды, созданные при выполнении действия

  • Net result of running the activity

Эти сведения создаются автоматически при каждом запуске искусственной транзакции. Однако эти сведения не отображаются автоматически и не сохраняются в файле журнала. Вместо этого администраторы, которые вручную выполняют искусственную транзакцию, могут использовать параметр OutLoggerVariable, чтобы указать переменную Windows PowerShell, в которой будут храниться сведения. После этого администраторы могут использовать пару методов, позволяющих сохранять и (или) просматривать расширенный журнал в формате XML или HTML.

Например, администраторы Lync Server 2010 могут запустить командлет Test-CsRegistration с помощью следующей команды:

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

Администраторы могут включить параметр OutLoggerVariable, за которым следует имя переменной по выбору:

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

Примечание.

Не задайте перед именем переменной символ $. Используйте имя переменной, например RegistrationTest, а не $RegistrationTest.

Предыдущая команда выводит содержимое, аналогичное следующему:

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

Однако для этой ошибки доступны гораздо более подробные сведения, чем просто сообщение об ошибке, показанное выше. Чтобы получить доступ к этим сведениям в формате HTML, используйте следующую команду, чтобы сохранить сведения, хранящиеся в переменной RegistrationTest, в HTML-файл:

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

Можно также использовать метод ToXML() для сохранения данных в файл XML:

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

Затем эти файлы можно просмотреть с помощью Internet Explorer, Visual Studio или любого другого приложения, которое может открывать HTML/XML-файлы.

Искусственные транзакции, которые выполняются внутри System Center Operations Manager, автоматически создают эти файлы журналов для сбоев. Однако эти журналы не будут создаваться, если выполнение завершится сбоем, прежде чем Windows PowerShell сможет загрузить и запустить искусственную транзакцию.

Важно

По умолчанию Lync Server 2013 сохраняет файлы журналов в папку, которая не является общей. Чтобы сделать эти журналы доступными, необходимо поделиться этой папкой (например, \\atl-watcher-001.litwareinc.com\WatcherNode).