对 SIP 调用流进行故障诊断

了解如何使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构内的功能对跨会话启动协议 (SIP) 代理和 SIP 容器的 SIP 调用流进行故障诊断。

关于此任务

如果为 SIP 代理和 SIP 容器启用了 HPEL,那么与代理和容器的 SIP 消息处理相关的所有日志和跟踪记录都将包括 SIP 调用标识扩展 SIPCallId。由于 SIPCallId 扩展在 SIP 调用流中的所有组件之间是不变的,因此您可以使用此扩展来跟踪 SIP 代理和容器之间的调用流。

其他扩展也可以用于 SIP 容器。要了解可用的其他扩展,请参阅日志和跟踪扩展文档。

过程

  1. 在 SIP 代理服务器和 SIP 容器服务器上启用 HPEL。 您可以使用管理控制台或 wsadmin 脚本编制来启用 HPEL。请参阅有关使用高性能可扩展记录对应用程序进行故障诊断的文档,以了解如何启用和配置 HPEL 功能。 如果可能,代理和容器的所有日志和跟踪记录现在都包含 SIPCallId 扩展。
  2. 为 SIP 代理服务器或 SIP 容器启用跟踪。 可以使用管理控制台来为 SIP 代理服务器或 SIP 容器启用跟踪。有关启用跟踪的更多信息,请参阅有关跟踪 SIP 代理服务器的文档或者有关跟踪 SIP 容器的文档。
  3. 通过 SIP 容器和代理服务器启动流量。
  4. 使用 LogViewer 命令行工具可查询 HPEL 日志和跟踪存储库的内容,并可查看包含 SIPCallId 扩展的特定跟踪数据。

    要了解如何使用此工具来查看 HPEL 日志和跟踪数据,请参阅 LogViewer 命令行工具文档。

    以下示例说明如何使用 LogViewer 工具来查看调用流数据中何处使用 SIPCallId 扩展。
    • 使用以下命令可返回设置了 SIPCallId 扩展的所有日志条目:[Windows]
      bin\logViewer.bat -includeExtensions SIPCallId
      [AIX HP-UX Solaris][Linux]
      bin/logViewer.sh -includeExtensions SIPCallId
      [z/OS]
      bin/logViewer.sh -includeExtensions SIPCallId -instance <instanceid>
      在您使用此命令时,SIPCallId 扩展不可见。
    • 使用以下命令返回高级格式的所有日志条目以及所有跟踪扩展信息:[Windows]
      bin\logViewer.bat -format advanced
      [AIX HP-UX Solaris][Linux]
      bin/logViewer.sh -format advanced
      [z/OS]
      bin/logViewer.sh -format advanced -instance <instanceid>
      .
    • 使用以下命令返回包含 SIPCallId 扩展的所有日志条目以及所有跟踪扩展信息:[Windows]
      bin\logViewer.bat -format advanced -includeExtensions SIPCallId
      [AIX HP-UX Solaris][Linux]
      bin/logViewer.sh -format advanced -includeExtensions SIPCallId
      [z/OS]
      bin/logViewer.sh -format advanced -includeExtensions SIPCallId -instance <instanceid>
      .
    • 使用以下命令可按照特定 SIPCallId 扩展来进行过滤,以返回 SIPCallId 设置为特定标识的所有日志条目。[Windows]
      bin\logViewer.bat -includeExtensions SIPCallId=specificid
      [AIX HP-UX Solaris][Linux]
      bin/logViewer.sh -includeExtensions SIPCallId=specificid
      [z/OS]
      bin/logViewer.sh -includeExtensions SIPCallId=specificid -instance <instanceid>
      .

结果

您已准备好查看查询结果。日志查看器将查询结果转储到管理控制台。您可以选择通过将结果以管道传送到指定文件,以将查询结果重定向到文本文件。如果不关注性能,那么可以启用 HPEL 文本日志并将其更改为高级格式。 通过使用高级格式,HPEL 可存储 SIPCalId 扩展。

示例

以下示例说明在 UNIX 环境中运行的情况下,在跟踪数据中包含 SIPCallId 扩展时如何对调用流进行故障诊断。这些示例可以扩展到 Windows 和 z/OS® 操作系统。
  1. 确定有疑问的 SIP 调用标识。如果您不知道调用标识,那么可以使用以下命令来查看日志中所有调用标识的所有跟踪:[AIX HP-UX Solaris][Linux]
    logViewer.sh -format advance -includeExtensions SIPCallId 
    此命令的输出是高级格式,包括可用的附加信息,例如,SIPCallId:
    [10/2/12 13:23:08:634 EDT] 00000084  > UOW= source=com.ibm.ws.proxy.channel.sip.SipProxyConnection method=messageReceivedThreaded org=IBM prod=WebSphere component=Application Server thread=[UDP Thread Pool : 0] SIPCallId=[1-23304@9.37.23.235]
              Entry
    [10/2/12 13:23:08:634 EDT] 00000084  > UOW= source=com.ibm.ws.proxy.channel.sip.SipProxyConnection method=readIndication:  id = 1282434117 org=IBM prod=WebSphere component=Application Server thread=[UDP Thread Pool : 0] SIPCallId=[1-23304@9.37.23.235]
              Entry
    [10/2/12 13:23:08:634 EDT] 00000084  3 UOW= source=com.ibm.ws.proxy.channel.sip.SipProxyConnection org=IBM prod=WebSphere component=Application Server thread=[UDP Thread Pool : 0] SIPCallId=[1-23304@9.37.23.235]
              Received Message from 9.37.23.235:10200   - 
    [10/2/12 13:23:08:634 EDT] 00000084  3 UOW= source=com.ibm.ws.proxy.channel.sip.SipProxyConnection org=IBM prod=WebSphere component=Application Server thread=[UDP Thread Pool : 0] SIPCallId=[1-23304@9.37.23.235]
              Message received from CLIENT: 
    [10/2/12 13:23:08:634 EDT] 00000084  3 UOW= source=com.ibm.ws.proxy.channel.sip.SipProxyConnection org=IBM prod=WebSphere component=Application Server thread=[UDP Thread Pool : 0] SIPCallId=[1-23304@9.37.23.235]
              Received Message from 9.37.23.235:10200   -
  2. 使用以下命令过滤基于特定调用标识的日志:[AIX HP-UX Solaris][Linux]
    bin/logViewer.sh -includeExtensions SIPCallId=1-23304@9.37.23.235
    命令结果为基本格式,显示 SIP 代理日志的典型日志条目。输出按照指定的 SIPCallId 扩展来过滤。
    [10/2/12 13:23:08:634 EDT] 00000084 SipProxyConne >  messageReceivedThreaded Entry
    [10/2/12 13:23:08:634 EDT] 00000084 SipProxyConne >  readIndication:  id = 1282434117 Entry
    [10/2/12 13:23:08:634 EDT] 00000084 SipProxyConne 3   Received Message from 9.37.23.235:10200   - 
    [10/2/12 13:23:08:634 EDT] 00000084 SipProxyConne 3   Message received from CLIENT: 
    [10/2/12 13:23:08:634 EDT] 00000084 SipProxyConne 3   Received Message from 9.37.23.235:10200   - 
    [10/2/12 13:23:08:634 EDT] 00000084 SIPMessageImp >  getDuplicate Entry
    [10/2/12 13:23:08:634 EDT] 00000084 SIPMessageFac >  SipMessageFactoryImpl:getRef entry Entry
    [10/2/12 13:23:08:634 EDT] 00000084 SIPMessageFac <  SipMessageFactoryImpl:getRef: exit: Exit

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



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tsip_troublesipcallflows
文件名:tsip_troublesipcallflows.html