Kamailio-开源SIP软交换平台

中国第一个专注Kamailio SIP 软交换技术分享平台

用户工具

站点工具


statistics_script_statistics_support_released

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

statistics_script_statistics_support_released [2017/09/11 17:19] (当前版本)
james_zhu 创建
行 1: 行 1:
 +====== Statistics Module ======
  
 +==== Bogdan Iancu ====
 +
 +Voice Sistem SRL\\ 
 +
 +=== Edited by ===
 +
 +==== Bogdan Iancu ====
 +
 +Copyright © 2006 Voice Sistem SRL
 +
 +----
 +
 +**Table of Contents**
 +
 +  * **1. Admin Guide** ​
 +    * **1. Overview** ​
 +    * **2. Dependencies** ​
 +      * **2.1. Kamailio Modules** ​
 +      * **2.2. External Libraries or Applications** ​
 +    * **3. Parameters** ​
 +      * **3.1. variable (string)** ​
 +    * **4. Functions** ​
 +      * **4.1. update_stat(variable,​value)** ​
 +      * **4.2. reset_stat(variable)** ​
 +
 +**List of Examples**
 +
 +  * **1.1. variable example** ​
 +  * **1.2. update_stat usage** ​
 +  * **1.3. reset_stat usage** ​
 +
 +====== Chapter 1. Admin Guide ======
 +
 +**Table of Contents**
 +
 +  * **1. Overview** ​
 +  * **2. Dependencies** ​
 +    * **2.1. Kamailio Modules** ​
 +    * **2.2. External Libraries or Applications** ​
 +  * **3. Parameters** ​
 +    * **3.1. variable (string)** ​
 +  * **4. Functions** ​
 +    * **4.1. update_stat(variable,​value)** ​
 +    * **4.2. reset_stat(variable)** ​
 +
 +===== 1. Overview =====
 +
 +The Statistics module is a wrapper over the internal statistics manager, allowing the script writer to dynamically define and use of statistic variables.
 +
 +By bringing the statistics support into the script, it takes advantage of the script flexibility in defining logics, making possible implementation of any kind of statistic scenario.
 +
 +===== 2. Dependencies =====
 +
 +==== 2.1. Kamailio Modules ====
 +
 +The following modules must be loaded before this module:
 +
 +  * No dependencies on other Kamailio modules. ​
 +
 +==== 2.2. External Libraries or Applications ====
 +
 +The following libraries or applications must be installed before running Kamailio with this module loaded:
 +
 +  * None. 
 +
 +===== 3. Parameters =====
 +
 +==== 3.1. variable (string) ====
 +
 +Name of a new statistic variable. The name may be followed by additional flag which describe the variable behavior:
 +
 +  * no_reset : variable cannot be reset. ​
 +
 +**Example 1.1. variable example**
 +
 +<​code>​
 +modparam("​statistics",​ "​variable",​ "​register_counter"​)
 +modparam("​statistics",​ "​variable",​ "​active_calls/​no_reset"​)
 +</​code>​
 +
 +\\ ===== 4. Functions =====
 +
 +==== 4.1. update_stat(variable,​value) ====
 +
 +Updates the value of the statistic variable with the new value.
 +
 +Meaning of the parameters is as follows:
 +
 +  * variable - variable to be updated (it can be a string or a pseudovariable); ​
 +  * value - value to update with; it may be also negative (it can be a string or pseudovariable). ​
 +
 +This function can be used from ANY_ROUTE.
 +
 +**Example 1.2. ''​update_stat''​ usage**
 +
 +<​code>​
 +...
 +update_stat("​register_counter",​ "​+1"​);​
 +...
 +$var(a_calls) = "​active_calls";​
 +update_stat("​$var(a_calls)",​ "​-1"​);​
 +...
 +</​code>​
 +
 +\\ ==== 4.2. reset_stat(variable) ====
 +
 +Resets to zero the value of the statistic variable.
 +
 +Meaning of the parameters is as follows:
 +
 +  * variable - variable to be reset (it can be a string or a pseudovariable). ​
 +
 +This function can be used from REQUEST_ROUTE,​ BRANCH_ROUTE,​ FAILURE_ROUTE and ONREPLY_ROUTE.
 +
 +**Example 1.3. ''​reset_stat''​ usage**
 +
 +<​code>​
 +...
 +reset_stat("​register_counter"​);​
 +...
 +$var(reg_counter) = "​register_counter";​
 +update_stat("​$var(reg_counter)"​);​
 +...
 +</​code>​
 +
 +\\
statistics_script_statistics_support_released.txt · 最后更改: 2017/09/11 17:19 由 james_zhu