Liberty での SIP コンテナー・セッション・リポジトリーのトラブルシューティング
SIP コンテナー・セッション・リポジトリーをトラブルシューティングする場合、SIP セッションの詳細情報を、指定したトレース・ファイルにダンプする必要がある場合があります。
このタスクについて
SIP セッション・メモリー・ダンプ・ユーティリティーを使用して、SIP コンテナー・セッションに関連した問題のデバッグに役立てることができます。SIP コンテナーでは、コマンド行を使用したサーバー停止の開始など、SIP コンテナーに対していくつかの保守性タイプの操作を実行する SipContainerMBean メソッドが提供されています。このタスクでは、SipContainerMBean メソッドを使用して、SIP コンテナーのメモリー内セッション・リポジトリーに含まれている、SIP アプリケーション・セッションおよび SIP セッションの情報をダンプする方法について説明します。さまざまなトレース方式を使用するように SIPContainerMBean メソッドを構成することにより、SIP セッションの詳細を、指定したトレース・ファイルにダンプ出力するように指定することができます。
セッション・ダンプ・メソッドが開始されると、セッションについて要求された情報が、デフォルトで console.log ファイルに出力されます。また、setDumpMethod メソッドに指定された事前定義ソースにこの情報を送信することもできます。
- SIP セッションの詳細と共に、トランザクション・ユーザーの詳細 (存在する場合) が、ダンプ・メソッドの実行ごとに出力されます。
- トレース・ファイルにダンプ出力される属性は、JSR 289 仕様で公開が許可されている属性のみです。
- 詳細メソッドは、appName、callID、ダイアログの状態、作成時間、属性名の情報をトレース・ファイルに出力します。
トレースの印刷出力は SIP アプリケーションごとに実行されます。したがって、出力の前に、すべての SIP セッション・データ構造のソートが行われます。SIPContainerMBean ダンプ機能は、トレースが実動サーバーのシステム全体の呼び出し処理の待ち時間に影響を与えないように、優先順位の低いスレッドで実行されます。
ダンプでは、SIP セッションがあるトランザクション・ユーザーと、SipSession オブジェクトがないトランザクション・ユーザーが区別されます。また、もう存在していない SIP セッション、もう有効でない SIP セッション、またはトレース・スナップショットの作成時に存在した SIP セッションも明確にダンプに組み込まれます。
- server dump コマンドを実行する
- JMX コネクターへの接続を確立してそれらのメソッドを呼び出す Java™ Management Extensions (JMX) クライアントを実装する。
メソッド | 説明 |
---|---|
dumpAllSASIds() | すべての SIP アプリケーション・セッションの数と SIP アプリケーション・セッション ID を表示します。 |
dumpAllTUSipSessionIds() | トランザクション・ユーザーの数と、トランザクション・ユーザー (TU) が存在する場合、TU 内の SIP セッション ID を表示します。 |
メソッド | 説明 |
---|---|
dumpAllSASDetails() | すべての SIP アプリケーション・セッションの数と SIP アプリケーション・セッション ID の詳細を出力します。 |
dumpAllTUSipSessionDetails() | トランザクション・ユーザーの数と、トランザクション・ユーザー (TU) が存在する場合、TU 内の SIP セッション ID の詳細を出力します。 |
dumpSASDetails(String sasId) | sasId パラメーターによって指定されている SIP アプリケーション・セッションの詳細を出力します。 |
dumpSipSessionDetails(String sessionId) | sessionId パラメーターによって指定されている SIP セッションの詳細を出力します。 |
- すべての印刷出力で、最初の行にはアプリケーション名とレコード数が記載されています。
- 出力間の区切り文字は TAB です。
- セッション属性間の区切り文字は ; (セミコロン) です。