Table of Contents
List of Examples
update_stat usagereset_stat usageTable of Contents
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.
The following modules must be loaded before this module:
No dependencies on other Kamailio modules.
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.
This function can be used from REQUEST_ROUTE, BRANCH_ROUTE, FAILURE_ROUTE and ONREPLY_ROUTE.
Example 1.2. update_stat usage
...
update_stat("register_counter", "+1");
...
$var(a_calls) = "active_calls";
update_stat("$var(a_calls)", "-1");
...
Resets to zero the value of the statistic variable.
Meaning of the parameters is as follows:
variable - variable to be reset-ed (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
...
reset_stat("register_counter");
...
$var(reg_counter) = "register_counter";
update_stat("$var(reg_counter)");
...