在 Lync Server 2013 中对综合事务使用丰富的日志记录

  • 项目

 

上次修改的主题： 2012-10-22

Microsoft Lync Server 2010 中引入的综合事务 () 为管理员提供了一种方法来验证用户是否能够成功完成常见任务，例如登录到系统、交换即时消息或拨打位于公共交换电话网络 (PSTN) 上的电话。 这些测试 (打包为一组 Lync Server Windows PowerShell cmdlet) 可由管理员手动进行，也可以由 System Center Operations Manager 等应用程序自动运行。

在 Lync Server 2010 中，综合事务在帮助管理员识别系统问题方面非常有用。 例如， Test-CsRegistration cmdlet 可能会提醒管理员某些用户难以注册 Lync Server。 但是，综合事务在帮助管理员确定这些用户在 Lync Server 注册时遇到困难的原因方面不太有用。 这是因为综合事务没有提供详细的日志记录信息来帮助管理员排查 Lync Server 的问题。 充其量，合成事务提供的详细输出提供了分步信息，使管理员能够对可能发生问题的位置进行有教程的猜测。

在 Microsoft Lync Server 2013 中，已重新构建综合事务以提供丰富的日志记录。 “丰富日志记录”意味着，对于合成事务执行的每个活动，将记录此类信息：

  • 活动启动的时间

  • 活动完成的时间

  • 执行的操作 (例如，创建、加入或离开会议;登录到 Lync Server;发送即时消息;等)

  • 活动运行时生成的信息、详细、警告或错误消息

  • SIP 注册消息

  • 活动运行时生成的异常记录或诊断代码

  • 运行活动的净结果

每次运行综合事务时都会自动生成此信息。 但是，信息不会自动显示或保存到日志文件中。 相反，手动运行综合事务的管理员可以使用 OutLoggerVariable 参数来指定要在其中存储信息的Windows PowerShell变量。 然后，管理员可以使用一对方法来保存和/或查看 XML 或 HTML 格式的丰富日志。

例如，Lync Server 2010 管理员可以使用类似于以下命令的命令运行 Test-CsRegistration cmdlet：

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

管理员可以选择包括 OutLoggerVariable 参数，后跟所选的变量名称：

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable 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。