【WMS-UTR项目】SIP协议增加Q.850的cause字段

ID	Creation Date	Assignee	Status
OMPUB-1412	2024-08-13T18:15:49.000+0800	杨威	已解决

1、何老师想在SIP的日志里展示一个Q.850的cause字段内容。

2、Q.850在SIP协议里定义了电话呼叫中的各种信令和错误码：https://www.cisco.com/c/zh_cn/support/docs/unified-communications/unified-border-element/214634-voice-router-internal-call-disconnect-ca.html。

!image-2024-08-13-18-15-05-397.png|width=436,height=321!yangwei commented on 2024-08-14T17:57:24.285+0800:

定义

按RFC3326定义，Reason Field可以在多种SIP消息中出现

!image-2024-08-14-17-33-24-635.png|width=683,height=603!

典型的格式为:

{code:java} Reason : [protocol];[reason-param][reason-param]...[reason-param]{code} 例如：

{code:java} Reason: SIP ;cause=200 ;text="Call completed elsewhere" Reason: Q.850 ;cause=16 ;text="Terminated" Reason: SIP ;cause=600 ;text="Busy Everywhere" Reason: SIP ;cause=580 ;text="Precondition Failure"{code}

TSG实现

sip作为一个典型的包含Transaction的协议，TSG使用callid作为Transaction（通常对应一个通话）的唯一标识，以通话为单位记录sip transaction日志，每个通话记录如下信息：

call-id，Originator（主叫账号），Responder（被叫账号），User-Agent（客户端信息），Server（服务端信息），Media Type（编码），SDP（Responder Content），Duration（持续时间），Bye（挂断方）

需求

如上所述，SIP协议中的Reason字段，可以在一个通话中的多个消息中出现，并且定义的protocol至少包括SIP，Q.850。

结合issue中给出的思科连接，用户需求的意图是记录每个通话挂断的Reason？（待确认[~niuxiang]），即记录Method为Bye消息的Reason字段

日志

考虑SIP日志增加一个新的字段SIP.bye_reason，字段值可选如下三种类型：

string，即直接输出原始报文中为Reason的值，例如 SIP.bye_reason : "Q.850 ;cause=16 ;text="Terminated"" ** 优点：结构简单，记录所有原始信息 ** 缺点：用户在界面进行检索和统计Q.850相关的cause，需要单独组织sql语句
array(string)，即按分号拆分Reason值，如：SIP.bye_reason : [”Q.850“，”cause=16“, "text="Terminated""] ** 优点：预拆分信息，类似IP Tags字段，方便对protocol或者cause等信息进行检索和统计 ** 缺点：功能端预拆分原始信息，拆分失败可能丢失信息
json string，参照Encapsulation字段，输出一个可以被反序列化为json的字符串，如SIP.bye_reason : ”[\”Q.850\“，\”cause=16\“, "text="Terminated""]”

** 优点：便于后期扩展 ** 缺点：检索和统计Q.850相关的cause，需要单独组织sql语句

niuxiang commented on 2024-08-15T16:38:32.746+0800:

[~yangwei]

跟何老师确认一下需求：

1、他只关心cause字段，不要全部的reason

2、需要全部的cause字段，不只是Bye消息

yangwei commented on 2024-09-26T10:05:08.416+0800:

已在[2024-09-23 Hotfix firewall module to support IP CIDR mapping, SIP Cause, and fix excessive memory usage|https://docs.geedge.net/display/TSGEN/2024-09-23+Hotfix+firewall+module+to+support+IP+CIDR+mapping%2C+SIP+Cause%2C+and+fix+excessive+memory+usage]中更新该功能

Attachments

61131/image-2024-08-13-18-15-05-397.png

61212/image-2024-08-14-17-20-21-632.png

61213/image-2024-08-14-17-31-18-831.png

61214/image-2024-08-14-17-33-24-635.png

61133/msh-sip02.pcapng

3.7 KiB Raw Blame History Unescape Escape

【WMS-UTR项目】SIP协议增加Q.850的cause字段

Attachments

3.7 KiB

Raw Blame History