Liberty での SIP コンテナー・セッション・リポジトリーのトラブルシューティング

SIP コンテナー・セッション・リポジトリーをトラブルシューティングする場合、SIP セッションの詳細情報を、指定したトレース・ファイルにダンプする必要がある場合があります。

このタスクについて

SIP セッション・メモリー・ダンプ・ユーティリティーを使用して、SIP コンテナー・セッションに関連した問題のデバッグに役立てることができます。SIP コンテナーでは、コマンド行を使用したサーバー停止の開始など、SIP コンテナーに対していくつかの保守性タイプの操作を実行する SipContainerMBean メソッドが提供されています。このタスクでは、SipContainerMBean メソッドを使用して、SIP コンテナーのメモリー内セッション・リポジトリーに含まれている、SIP アプリケーション・セッションおよび SIP セッションの情報をダンプする方法について説明します。さまざまなトレース方式を使用するように SIPContainerMBean メソッドを構成することにより、SIP セッションの詳細を、指定したトレース・ファイルにダンプ出力するように指定することができます。

セッション・ダンプ・メソッドが開始されると、セッションについて要求された情報が、デフォルトで console.log ファイルに出力されます。また、setDumpMethod メソッドに指定された事前定義ソースにこの情報を送信することもできます。

ダンプ・ユーティリティーは、簡潔および詳細の、2 つのモードで実行できます。簡潔セッション・ダンプ・メソッドを使用した場合、ダンプ・メソッドの実行ごとにセッション ID のみが出力されます。詳細セッション・ダンプ・メソッドを使用したい場合、以下のアクションが実行されます。
  • SIP セッションの詳細と共に、トランザクション・ユーザーの詳細 (存在する場合) が、ダンプ・メソッドの実行ごとに出力されます。
  • トレース・ファイルにダンプ出力される属性は、JSR 289 仕様で公開が許可されている属性のみです。
  • 詳細メソッドは、appName、callID、ダイアログの状態、作成時間、属性名の情報をトレース・ファイルに出力します。

トレースの印刷出力は SIP アプリケーションごとに実行されます。したがって、出力の前に、すべての SIP セッション・データ構造のソートが行われます。SIPContainerMBean ダンプ機能は、トレースが実動サーバーのシステム全体の呼び出し処理の待ち時間に影響を与えないように、優先順位の低いスレッドで実行されます。

ダンプでは、SIP セッションがあるトランザクション・ユーザーと、SipSession オブジェクトがないトランザクション・ユーザーが区別されます。また、もう存在していない SIP セッション、もう有効でない SIP セッション、またはトレース・スナップショットの作成時に存在した SIP セッションも明確にダンプに組み込まれます。

Liberty では、次の 2 つの方法で SIPContainerMBean ダンプ・メソッドを呼び出すことができます。
  • server dump コマンドを実行する
  • JMX コネクターへの接続を確立してそれらのメソッドを呼び出す Java™ Management Extensions (JMX) クライアントを実装する。
以下の簡潔な SipContainerMBean メソッドは、SIP セッション ID をダンプするために使用されます。
表 1. SIP セッション情報をダンプするために使用される、簡潔な SipContainerMBean メソッド
メソッド 説明
dumpAllSASIds() すべての SIP アプリケーション・セッションの数と SIP アプリケーション・セッション ID を表示します。
dumpAllTUSipSessionIds() トランザクション・ユーザーの数と、トランザクション・ユーザー (TU) が存在する場合、TU 内の SIP セッション ID を表示します。
次の詳細な SipContainerMBean メソッドは、SIP セッションの詳細をダンプするために使用されます。
表 2. 詳細な SipContainerMBean メソッドは、SIP セッション情報をダンプするために使用されます。
メソッド 説明
dumpAllSASDetails() すべての SIP アプリケーション・セッションの数と SIP アプリケーション・セッション ID の詳細を出力します。
dumpAllTUSipSessionDetails() トランザクション・ユーザーの数と、トランザクション・ユーザー (TU) が存在する場合、TU 内の SIP セッション ID の詳細を出力します。
dumpSASDetails(String sasId) sasId パラメーターによって指定されている SIP アプリケーション・セッションの詳細を出力します。
dumpSipSessionDetails(String sessionId) sessionId パラメーターによって指定されている SIP セッションの詳細を出力します。
注: 以下の情報を使用して、印刷出力の解析に役立ててください。
  • すべての印刷出力で、最初の行にはアプリケーション名とレコード数が記載されています。
  • 出力間の区切り文字は TAB です。
  • セッション属性間の区切り文字は ; (セミコロン) です。

手順


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_sip_trblsipcontsess
ファイル名: twlp_sip_trblsipcontsess.html