Documentation

Documentation.Interface-Statistics-1-7 History

Hide minor edits - Show changes to output

August 05, 2013, at 04:28 PM by 109.99.235.212 -
Changed lines 4-5 from:
[- Page for other versions: [[Interface-Statistics|devel]] [[Interface-Statistics-1-9|1.9]] [[Interface-Statistics-1-8|1.8]] old versions: 1.7 [[Interface-Statistics-1-6|1.6]] [[Interface-Statistics-1-5|1.5]] [[Interface-Statistics-1-4|1.4]] -]
to:
(:allVersions Interface-Statistics 1.7:)
Changed line 69 from:
@]
to:
@]
May 29, 2013, at 12:28 PM by 109.99.235.212 -
Added lines 1-69:
!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-1-7|Manual 1.7]] -> Statistics Interface
(:title Statistics Interface - ver 1.7 :)
----
[- Page for other versions: [[Interface-Statistics|devel]] [[Interface-Statistics-1-9|1.9]] [[Interface-Statistics-1-8|1.8]] old versions: 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.7'''+]%% ||

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

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.

----
!!!! 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-7|by OpenSIPS core]] or by [[Documentation/Modules-1-7|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-7|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-7|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 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
> 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

# 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.
>>important<<
Reseting a computed-value statistic will be ignored and have no effect.
>><<
The MI [[Documentation/Interface-CoreMI-1-7|reset_statistics]] command can be used here:

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

Page last modified on August 05, 2013, at 04:28 PM