はじめに
本ドキュメントでは、TelePresence エンドポイント (TC/CE) のログを Collaboration Solutions Analyzer (CSA) ツールを使って解析する方法を紹介します。
Collaboration Solutions Analyzer (CSA) を使うことによって、TelePresence エンドポイントのログから設定情報、 SIP/H.323 コールの情報、イベントログなどを簡単に確認することができます。
ログの取得
TelePresence エンドポイントのログは、以下の方法でログバンドル (log_bundle-[SystemUnit名]-yyyymm-hhmm.tar.gz) を取得します。
ログ解析 (Log analysis)
ログイン
以下の URL にアクセスし(Cisco.com アカウントが必要です)、[Log analysis] をクリックします。
https://cway.cisco.com/tools/CollaborationSolutionsAnalyzer/
以下の短縮 URL でもアクセスできます。
https://cs.co/csa

ログのアップロード
取得したエンドポイントのログバンドルをドラッグ・アンド・ドロップし、[Upload files] ボタンをクリックします。
アップロードが終了するまでしばらく時間がかかります。

アップロードが成功すると、[Available Files] にアップロードしたファイルが表示されます。[Product Type] が ENDPOINT となっていることを確認し、チェックをつけて [Run Analysis] をクリックして解析を開始します。もしくは右の▷ボタンをクリックします。

診断 (Diagnostic Signature)
ログバンドル をアップロード後、CSA がログから問題を検出すると、問題の内容と解決策を表示します。検出されなかった場合は、No issues were found. と表示されます。
システム情報 (System Information)
System Information では 一般情報 (General Information)、IP 設定 (IP Configuration)、デバイスレジストレーション (Device registration)、Web 診断 (Web diagnostics) を確認できます。

一般情報 (General Information)
General Information では、ホストの設定(製品名、バージョン、ホスト名、ドメイン、NTPサーバ、DNS サーバ、プロビジョニングモード)、ライセンスの情報を確認できます。

IP 設定 (IP Configuration)
IP Configuration では IP アドレス、サブネットマスク、デフォルトゲートウェイを確認できます。

デバイス登録 (Device Registration)
エンドポイントの SIP / H.323 の登録状況を確認できます。

Web 診断 (Web diagnostics)
エンドポイントが検出している診断情報を表示します。

Log Overview
Log Overview では以下の情報を確認することができます。
- Call
- SIP registrations
- RTP streams
- TCP/UDP streams
- Events
コール (Call)
バンドルログ にコールが含まれている場合、Call タブにコールの一覧が表示されます。該当のコールをクリックすると、コールの詳細 (Call detail) が確認できます。

コールの詳細 (Call detail)
Call detail のタブには以下の項目があります (ログの内容によって表示されない項目もあります)。
- Call leg Info: コールレッグの情報
- Signaling: SIP/H.323 のシグナリング情報、イベント情報
- Ladder Diagram: SIP/H.323 シーケンス図

[Download pcap] をクリックすると、pcap 形式でコールを保存できます。
Call leg Info
Call leg Info には、着信コールレッグもしくは発信コールレッグのサマリが表示されます。RTP が取得されている場合は、RTP の統計情報も表示されます。

Signaling
Signaling タブをクリックすると、SIP などのシグナリング情報およびエンドポイントが検出したイベント情報が表示されます。

Ladder Diagram
Ladder Diagram をクリックすると SIP などのシグナリングがシーケンス図として表示されます。Signaling タブとほぼ同じ情報ですが、こちらの方が見やすいかもしれません。メッセージをクリックするとシグナリングの詳細メッセージを確認できます。音声やビデオのアイコンをマウスオーバすると、コーデックや受信 IP アドレス・ポート番号などの情報が表示されます。ノードを表す四角い箱は左右に移動することができます。


SIP registrations
SIP Registration の一覧が出力されます。エントリーをクリックするとそのフローを確認できます。

RTP streams
パケットキャプチャより、RTP ストリームの一覧を表示します。エントリーをクリックするとパケット送信間隔とパケットロスのグラフを表示します。

TCP/UDP streams
パケットキャプチャより、TCP/UDP ストリームの一覧を表示します。
Event
エンドポイントのコールに関連するイベントの一覧です。エントリーをクリックすると関連するイベントが表示されます。

参考情報