(:allVersions Interface-Statistics 1.9:)

@]

(:title Statistics Interface - ver 1.9 :)

[- Page for other versions: [[Interface-Statistics|devel]] 1.9 [[Interface-Statistics-1-8|1.8]] old versions: [[Interface-Statistics-1-7|1.7]] [[Interface-Statistics-1-6|1.6]] [[Interface-Statistics-1-5|1.5]] [[Interface-Statistics-1-4|1.4]] -]

|| %color=#185662%[+'''Statistics Interface v1.9'''+]%% ||

>>important<<

(:title Statistics Interface ver 1.9 :)

\\

&nbsp;\\

||[[Interface-CoreEvents-1-9|Prev]] || [[Interface-CoreStatistics-1-9|Next]]||

||[[Interface-CoreEvents-1-9|Next]] || [[Interface-CoreStatistics-1-9|Prev]]||

[- Page for other versions [[Interface-Statistics|devel]] 1.9 [[Interface-Statistics-1-8|1.8]] old versions : [[Interface-Statistics-1-7|1.7]] [[Interface-Statistics-1-6|1.6]] [[Interface-Statistics-1-5|1.5]] [[Interface-Statistics-1-4|1.4]] -]
|| %color=#185662%[+'''Statistics Interface'''+]%% ||

||[[Interface-CoreEvents-1-9|Next]] || [[Interface-CoreStatistics-1-9|Next]]||

!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-1-9|Manual 1.9]] -> Statistics Interface
----
%blue%[- Page for other versions [[Interface-Statistics|devel]] 1.9 [[Interface-Statistics-1-8|1.8]] old versions : [[Interface-Statistics-1-7|1.7]] [[Interface-Statistics-1-6|1.6]] [[Interface-Statistics-1-5|1.5]] [[Interface-Statistics-1-4|1.4]] -]%%
|| %blue%'''Statistics Interface'''%% ||
|| border=0 width=100%
||%blue%[[Interface-CoreEvents-1-9|Next]]%% || %blue%[[Interface-CoreStatistics-1-9|Next]]%%||
%%

'''Reseting the value''' of a statistic variable (to 0 value), but only if it is counter-type variable.
>>warning<<
Reseting a computed-value statistic will be ignored and have no effect.
>><<
The MI [[Documentation/Interface-CoreMI-1-9|reset_statistics]] command can be used here:

The '''Statistics Interface''' is an OpenSIPS interface that provides access to various internal statistics of OpenSIPS. The statistic provide useful information about what is going on inside OpenSIPS - this can be used by external applications, for monitoring purposes, load evaluation, realtime integration with other services. The values of statistic variables are exclusively numerical.

\\

To get access to the statistics you have to use the [[Documentation/Interface-MI-1-9|MI interface]] which provides (directly from OpenSIPS core) several MI functions for:\\\
'''Fetching the value''' of a statistic variable, of an entire group of variables or of all variables. The MI [[Documentation/Interface-CoreMI-1-9|get_statistics]] command can be used here:

'''Reseting the value''' of a statistic variable (to 0 value), but only if it is counter-type variable - otherwise the reset operation will have no effect. The MI [[Documentation/Interface-CoreMI-1-9|reset_statistics]] command can be used here:

----

----

* '''fetching the value''' of a statistic variable, of an entire group of variables or of all variables. The MI [[Documentation/Interface-CoreMI-1-9|get_statistics]] command can be used here:

# get various statistic variables, by list of names
> opensipsctl fifo get_statistics rcv_requests inuse_transactions
> core:rcv_requests = 453
> tm:inuse_transactions = 10


# get all stats from a group

# get all stats from OpenSIPS
> opensipsctl fifo get_statistics all
>...........

* '''reseting the value''' of a statistic variable (to 0 value), but only if it is counter-type variable - otherwise the reset operation will have no effect. The MI [[Documentation/Interface-CoreMI-1-9|reset_statistics]] command can be used here:

[@
# reset one statistic variable, by name
> opensipsctl fifo reset_statistics rcv_requests
@]

The '''Statistics Interface''' is an OpenSIPS interface that provides access to various internal statistics of OpenSIPS. The statistic provide useful information about what is going on inside OpenSIPS - this can be used by external applications, for monitoring purposes, load evaluation, realtime integration with other services.

!!!! Overview

'''OpenSIPS''' typically provides two types of statistic variables:
# counter like - variables that keep counting things that happened in OpenSIPS, like received requests, processed dialogs, failed DB queries, etc
# computed values - variables that are calculated in realtime, like how much memory is used, the current load, active dialogs, active transactions, etc

The statistic variables are not restart persistent, they all start with a 0 value (the counter like variables). The ''counter like'' statistics can also be reset (to 0 value) during OpenSIPS runtime.

In OpenSIPS, the statistics variables are grouped in different sets, depending on their purposes or how is providing them. For example, the OpenSIPS core provides the '''shmem''', '''load''', '''net''', etc groups, while each OpenSIPS module provides its own group (typically the group has the same name as the module).

All available statistic variables are listed and documented : statistics provided [[Documentation/Interface-CoreStatistics-1-9|by OpenSIPS core]] or by [[Documentation/Modules-1-9|OpenSIPS modules]] (see the Statistics chapter for each module).

!!!! Usage

To get access to the statistics you have to use the [[Documentation/Interface-MI-1-9|MI interface]] which provides (directly from OpenSIPS core) several MI functions for:
* '''fetching value''' of a statistic variable, of an entire group of variables or of all variables. The MI [[Documentation/Interface-CoreMI-1-9|get_statistics]] command can be used here:
[@
# get one statistic variable, by name
> opensipsctl fifo get_statistics rcv_requests
> core:rcv_requests = 3428
> opensipsctl fifo get_statistics real_used_size
> shmem:real_used_size = 2951864

# get multiple stats by group
> opensipsctl fifo get_statistics shmem:
> shmem:total_size = 33554432
> shmem:used_size = 2897024
> shmem:real_used_size = 2951864
> shmem:max_used_size = 2952304
> shmem:free_size = 30602568
> shmem:fragments = 26
@]
* '''reset value'''

!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-1-9|Manual 1.9]] -> Interface -> Statistics
----

The '''Statistics Interface''' is an OpenSIPS interface that provides you access to various internal statistics of OpenSIPS.

!!! Overview