对 SIP 调用流进行故障诊断
了解如何使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构内的功能对跨会话启动协议 (SIP) 代理和 SIP 容器的 SIP 调用流进行故障诊断。
关于此任务
如果为 SIP 代理和 SIP 容器启用了 HPEL,那么与代理和容器的 SIP 消息处理相关的所有日志和跟踪记录都将包括 SIP 调用标识扩展 SIPCallId。由于 SIPCallId 扩展在 SIP 调用流中的所有组件之间是不变的,因此您可以使用此扩展来跟踪 SIP 代理和容器之间的调用流。
其他扩展也可以用于 SIP 容器。要了解可用的其他扩展,请参阅日志和跟踪扩展文档。
过程
结果
您已准备好查看查询结果。日志查看器将查询结果转储到管理控制台。您可以选择通过将结果以管道传送到指定文件,以将查询结果重定向到文本文件。如果不关注性能,那么可以启用 HPEL 文本日志并将其更改为高级格式。 通过使用高级格式,HPEL 可存储 SIPCalId 扩展。
示例
以下示例说明在 UNIX 环境中运行的情况下,在跟踪数据中包含 SIPCallId 扩展时如何对调用流进行故障诊断。这些示例可以扩展到 Windows 和 z/OS® 操作系统。
- 确定有疑问的 SIP 调用标识。如果您不知道调用标识,那么可以使用以下命令来查看日志中所有调用标识的所有跟踪:
此命令的输出是高级格式,包括可用的附加信息,例如,SIPCallId:logViewer.sh -format advance -includeExtensions 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 -
- 使用以下命令过滤基于特定调用标识的日志:
命令结果为基本格式,显示 SIP 代理日志的典型日志条目。输出按照指定的 SIPCallId 扩展来过滤。bin/logViewer.sh -includeExtensions SIPCallId=1-23304@9.37.23.235
[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