概述
freeswitch在业务开发中有极大的便利性,因为fs内部实现了很多小功能,这些小功能组合在一起,通过拨号计划就可以实现很多常见的业务功能。
在voip云平台的开发中,我们经常会碰到资源的限制,有外部线路资源方面的,也有voip平台内部资源方面。
根据资源的实际情况,对呼叫做限制,包括cps(每秒呼叫数,call per second)和capacity(呼叫容量),使用fs自带的limit接口,可以很方便的实现需求。
环境
centos:CentOS release 7.0 (Final)或以上版本
freeswitch:v1.8.7
GCC:4.8.5
接口limit
freeswitch的mod_dptools模块中提供app接口“limit“。
limit <backend> <realm> <resource> <max[/interval]> [<transfer_destination_number> [<dialplan> [<context>]]
<backend>分三类,db,hash,hiredis。db依赖mod_db模块,hash依赖mod_hash模块,hiredis依赖mod_hiredis模块。
在fs官网文档三种backend的优缺点比较,从速度、持久化、集群能力和时间间隔支持四个维度的比较结果。
<realm>和<resource>,两个参数可以随意命名,最好的命名是简单直观,方便区分限制规则。
<max[/interval]>,有俩种格式,<max>表示限制并发容量,<max/interval>表示限制一定时间内的最大呼叫发起量。backend的db模式不支持interval。
transfer dialplan的方式,适用于多个dialplan规则之间的跳转,用的好的情况下会非常灵活方便。
限制cps示例
需求1,限制任意ip进入的cps(每秒呼叫数)为300每秒。
<action application="limit" data="hash inbound ${network_addr} 300/1 !EXCHANGE_ROUTING_ERROR"/>
需求2,限制任意ip一天的呼入数量为100通。
<action application="limit" data="hash inbound ${network_addr} 100/86400 !EXCHANGE_ROUTING_ERROR"/>
需求3,限制指定ip的cps为100每秒。
<condition field="${network_addr}" expression="^1.2.3.4$" break="never">
<action application="limit" data="hash inbound 1.2.3.4 100/1 !EXCHANGE_ROUTING_ERROR"/>
</condition>
需求4,限制呼出的线路资源的cps为20每秒
<action application="limit" data="hash outbound 5.6.7.8 20/1 !EXCHANGE_ROUTING_ERROR"/>
限制capacity示例
需求5,限制全平台capacity并发容量为5000通。
<action application="limit" data="hash inbound capacity 5000 !EXCHANGE_ROUTING_ERROR"/>
需求6,限制指定ip呼入的capacity并发容量为1000通。
<condition field="${network_addr}" expression="^1.2.3.4$" break="never">
<action application="limit" data="hash inbound 1.2.3.4 1000 !EXCHANGE_ROUTING_ERROR"/>
</condition>
需求7,限制呼出的线路资源的capacity并发容量为500通。
<action application="limit" data="hash outbound 5.6.7.8 500 !EXCHANGE_ROUTING_ERROR"/>
限制呼入呼出综合示例
如果我们需要对整个VOIP平台的做呼叫限制,包括cps和capacity,比较通用的做法。
<extension name="limit_dp" continue="true">
<condition field="caller_id_number" expression="^\d+$" break="never">
<action application="limit" data="hash incps ${network_addr} 200/1 !EXCHANGE_ROUTING_ERROR"/>
<action application="limit" data="hash incps all 300/1 !EXCHANGE_ROUTING_ERROR"/>
<action application="limit" data="hash incapacity all 5000 !EXCHANGE_ROUTING_ERROR"/>
</condition>
</extension>
根据"limit_dp"的设置,限制规则如下。
incps_${network_addr},限制单个ip呼入的cps为200每秒。
incps_all,限制呼入总cps为300每秒。
incapacity_all,限制呼叫总容量为5000通。
总结
limit接口很灵活,可以根据具体场景设置不同的限制规则和多重规则。
在backend的选择上,大多数场景使用hash是最快最合适的,有数据持久化需求的场景才考虑hiredis,不建议使用db。
在有设置limit的freeswitch进程中,可以通过如下的命令查看当前的实时capacity容量。
./fs_cli -x 'limit_usage hash incapacity all'
1101
空空如常
求真得真