Project

General

Profile

Feature #1700

Document existing statistics/counters of OsmoNITB, OsmoSGSN, OsmoBTS, OsmoPCU

Added by laforge almost 2 years ago. Updated about 1 month ago.

Status:
Feedback
Priority:
High
Assignee:
Target version:
-
Start date:
05/04/2016
Due date:
% Done:

80%

Spec Reference:

Description

there are some statistics/counters available in OsmoNITB, OsmoSGSN, OsmoBTS, OsmoPCU

Please identify all of them and add documentation in the respective user manual.


Related issues

Related to Cellular Network Infrastructure - Feature #1651: document the control interface(s) of the various programs Closed 03/11/2016
Precedes OsmoNITB - Feature #1653: KPIs for OsmoNITB Stalled 05/05/2016 05/05/2016

History

#1 Updated by laforge almost 2 years ago

#2 Updated by msuraev almost 2 years ago

  • Related to Feature #1651: document the control interface(s) of the various programs added

#3 Updated by laforge almost 2 years ago

  • Assignee changed from msuraev to lynxis

#4 Updated by laforge almost 2 years ago

  • Priority changed from Normal to High

#5 Updated by lynxis almost 2 years ago

how the old counters (statistics.c), the newer ones (rate_ctr.c) and the new stats system (stats.c) work together.

statistics.c ---> stats.c
rate_ctr.c   -|
stat_item.c  -| (group description has the same struct, items not)

I'll create a command to generate asciidoc tables which then included into the documentation.

#6 Updated by lynxis almost 2 years ago

similiar to the table osmobts-abis.pdf Table 9: Messages compliant with TS 12.21
http://git.osmocom.org/osmo-gsm-manuals/tree/OsmoBTS/abis/oml.adoc

#7 Updated by laforge almost 2 years ago

to re-cap what was discussed in person today:
  • find a way to programmatically export the rate_ctr and stats_ctr similar in principle to what we do with the vty for generating the vty reference manual
  • attempt to genrate one asciidoc table per counter group
    • the table should contain a hyperlink to a chapter-anchor which is generate dfrom the counter name in the code
  • the asciidoc output can then be amended with human-written further details about each of the counters

Legacy 'osmo_counter' do not require programmatic export, it should be sufficient to list them manually. Thet should be phased out and will probably be replaced by one of the later counters.

#8 Updated by laforge almost 2 years ago

https://gerrit.osmocom.org/#/c/70 is the related gerrit patch set

#9 Updated by laforge over 1 year ago

please resolve the issue if completed, or at least update "% Done" and indicate which parts are missing.

#10 Updated by laforge over 1 year ago

'show asciidoc counters' is working for quite some time. However, I cannot see the output inside the osmocom user manuals yet. I also couldn't find a branch in osmo-gsm-manuals.git which I could merge. Somehow I think this feature existed, but where can I find the code to merge automatic inclusion in the manuals? Lynxis?

#11 Updated by laforge about 1 year ago

lynxis, any update to my last question 3 months ago?

#12 Updated by laforge 11 months ago

yet another follow-up, three months after my last ping that was again three months later? This is not acceptable, sorry.

#13 Updated by lynxis 5 months ago

  • BTS doesn't have any counters.
  • MGW doesn't have any counters.
  • GGSN doesn't have any counters.
  • HLR doesn't even have the required vty command. Missing vty stats init?
  • libosmocore: remove empty osmo counters table
    - g5189
    - g5190

@laforge: I've dropped the NITB part. Is this ok?

#14 Updated by lynxis 5 months ago

  • % Done changed from 0 to 80

#15 Updated by lynxis 5 months ago

  • Status changed from New to In Progress

#16 Updated by lynxis 5 months ago

  • Status changed from In Progress to Feedback

waiting for the git review

#17 Updated by laforge 4 months ago

  • Project changed from OsmoNITB to Cellular Network Infrastructure

#18 Updated by laforge about 1 month ago

  • Assignee changed from lynxis to daniel

Also available in: Atom PDF