Change in osmo-gsm-manuals[master]: Add a chapter to explain our different counters

[Daniel Willmann]

Daniel Willmann has submitted this change and it was merged. ( https://gerrit.osmocom.org/13516 )

Change subject: Add a chapter to explain our different counters
......................................................................

Add a chapter to explain our different counters

Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3
---
A common/chapters/counters-overview.adoc
1 file changed, 50 insertions(+), 0 deletions(-)

Approvals:
  Harald Welte: Looks good to me, approved
  Jenkins Builder: Verified



diff --git a/common/chapters/counters-overview.adoc b/common/chapters/counters-overview.adoc
new file mode 100644
index 0000000..fbdef30
--- /dev/null
+++ b/common/chapters/counters-overview.adoc
@@ -0,0 +1,50 @@
+[[common-counters]]
+== Osmocom Counters
+
+The following gives an overview of all the types of counters available:
+
+=== Osmo Counters
+
+Osmo counters are the oldest type of counters added to Osmocom projects.
+They are not grouped.
+
+* Printed as part of VTY show stats
+* Increment, Decrement
+* Accessible through the control interface: counter.<counter_name>
+
+=== Rate Counters
+
+Rate counters count rates of events.
+
+* Printed as part of VTY show stats
+* Intervals: per second, minute, hour, day or absolute value
+* Increment only
+* Accessible through the control interface
+* Rate counters are grouped and different instances per group can exist
+
+The control interface command to get a counter (group) is:
+
+rate_ctr.per_{sec,min,hour,day,abs}.<group_name>.<idx>.[counter_name]
+
+It is possible to get all counters from a group by omitting the counter name
+
+=== Stat Item
+
+Stat items are a grouped replacement for osmo counters, but not many stat
+items are available yet.
+
+* Printed as part of VTY show stats
+* Replacement for osmo counters
+* Not yet available through the control interface
+* Grouped and indexed like rate counters
+* Items have a unit
+* Keeps a list of the last values measured, so could return an average, min,
+  max, std. deviation
+
+=== Stats Reporter
+
+Statsd stats reporter can send osmo counter, rate counter and stats item values to statsd
+
+See the stats reporter command of the VTY reference for details on how to
+setup the connection to statsd.
+

-- 
To view, visit https://gerrit.osmocom.org/13516
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-MessageType: merged
Gerrit-Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3
Gerrit-Change-Number: 13516
Gerrit-PatchSet: 2
Gerrit-Owner: Daniel Willmann <dwillmann at sysmocom.de>
Gerrit-Reviewer: Daniel Willmann <dwillmann at sysmocom.de>
Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>
Gerrit-Reviewer: Jenkins Builder (1000002)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20190415/c24fa5c5/attachment.htm>