freeswitch通过limit限制cps

概述

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

空空如常

求真得真