Share via

Lync Server 2013 での代理トランザクションのリッチ ログの使用

  • [アーティクル]

 

トピック最終更新日時: 2012-10-22

代理トランザクション (Microsoft Lync Server 2010 で導入) を使用すると、管理者は、ユーザーがシステムへのログオン、インスタント メッセージの交換、公衆交換電話ネットワーク (PSTN) にある電話への通話などの一般的なタスクを正常に完了できることを確認できます。 これらのテスト (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 登録メッセージ

  • アクティビティの実行時に生成される例外レコードまたは診断コード

  • アクティビティを実行した結果の正味

この情報は、代理トランザクションが実行されるたびに自動的に生成されます。 ただし、情報は自動的にログ ファイルに表示または保存されません。 代わりに、代理トランザクションを手動で実行している管理者は、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 など) を共有する必要があります。