Liberty 上对 SIP 容器会话存储库进行故障诊断

对 SIP 容器会话存储库进行故障诊断时,您可能需要 SIP 会话详细信息以转储至指定跟踪文件。

关于此任务

可使用 SIP 会话内存转储实用程序来帮助调试有关 SIP 容器会话的问题。SIP 容器提供 SipContainerMBean 方法以对 SIP 容器执行一些可维护性类型操作,包括通过命令行启动服务器停顿。此任务描述如何使用 SipContainerMBean 方法转储 SIP 容器的内存中会话存储库中包含的 SIP 应用程序会话和 SIP 会话信息。您可以配置 SIPContainerMBean 方法以使用各种跟踪方法,从而指定要转储到指定跟踪文件的 SIP 会话详细信息。

启动会话转储方法后,缺省情况下有关会话的请求信息将显示在 console.log 文件中。还可将此信息发送至 setDumpMethod 方法上指定的预定义源。

可通过以下两种方式运行转储实用程序:简明详细。如果使用简明会话转储方法,那么每次执行转储方法时仅显示会话标识。如果要使用详细会话转储方法,那么将执行以下操作:
  • 每次执行转储方法时,将显示事务用户详细信息和 SIP 会话详细信息(如果存在)。
  • 转储至跟踪文件的仅有属性是 JSR 289 规范允许公开的属性。
  • 详细方法在跟踪文件中显示以下信息:appName、callID、对话状态、创建时间和属性名称。

对于每个 SIP 应用程序,都会显示跟踪输出;因此,所有 SIP 会话数据结构的排序在显示之前进行。SIPContainerMBean 转储工具在低优先级线程中运行,因此跟踪不影响生产服务器的整体系统的调用处理等待时间。

具有 SIP 会话的事务用户与没有 SipSession 对象的事务用户之间的转储有所区别。不再存在、不再有效或创建跟踪快照时存在的 SIP 会话也以界定方式包含在转储中。

Liberty 上,可通过两种方式调用 SIPContainerMBean 转储方法:
  • 通过运行 server dump 命令
  • 通过实现 Java™ 管理扩展 (JMX) 客户机,此客户机建立与 JMX 连接器的连接以调用这些方法
以下简明 SipContainerMBean 方法用于转储 SIP 会话标识。
表 1. 用于转储 SIP 会话信息的简明 SipContainerMBean 方法
方法 描述
dumpAllSASIds() 显示所有 SIP 应用程序会话数和 SIP 应用程序会话标识。
dumpAllTUSipSessionIds() 显示事务用户 (TU) 内的事务用户数和 SIP 会话标识(如果存在)。
以下详细 SipContainerMBean 方法用于转储 SIP 会话详细信息。
表 2. 用于转储 SIP 会话信息的详细 SipContainerMBean 方法
方法 描述
dumpAllSASDetails() 显示所有 SIP 应用程序会话数和 SIP 应用程序会话标识详细信息。
dumpAllTUSipSessionDetails() 显示事务用户 (TU) 内的事务用户数和 SIP 会话标识(如果存在)的详细信息。
dumpSASDetails(String sasId) 显示 sasId 参数指定的 SIP 应用程序会话的详细信息。
dumpSipSessionDetails(String sessionId) 显示 sessionId 参数指定的 SIP 会话的详细信息。
注: 使用以下信息来帮助分析打印输出:
  • 对于所有打印输出,第一行提供应用程序名称和一些记录。
  • 输出之间的定界符是制表符
  • 会话属性之间的定界符是 ;(分号)。

过程


用于指示主题类型的图标 任务主题

文件名:twlp_sip_trblsipcontsess.html