<p>Daniel Willmann has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/13516">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Add a chapter to explain our different counters<br><br>Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3<br>---<br>A common/chapters/counters-overview.adoc<br>1 file changed, 50 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/16/13516/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/common/chapters/counters-overview.adoc b/common/chapters/counters-overview.adoc</span><br><span>new file mode 100644</span><br><span>index 0000000..fbdef30</span><br><span>--- /dev/null</span><br><span>+++ b/common/chapters/counters-overview.adoc</span><br><span>@@ -0,0 +1,50 @@</span><br><span style="color: hsl(120, 100%, 40%);">+[[common-counters]]</span><br><span style="color: hsl(120, 100%, 40%);">+== Osmocom Counters</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The following gives an overview of all the types of counters available:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Osmo Counters</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Osmo counters are the oldest type of counters added to Osmocom projects.</span><br><span style="color: hsl(120, 100%, 40%);">+They are not grouped.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+* Printed as part of VTY show stats</span><br><span style="color: hsl(120, 100%, 40%);">+* Increment, Decrement</span><br><span style="color: hsl(120, 100%, 40%);">+* Accessible through the control interface: counter.<counter_name></span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Rate Counters</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Rate counters count rates of events.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+* Printed as part of VTY show stats</span><br><span style="color: hsl(120, 100%, 40%);">+* Intervals: per second, minute, hour, day or absolute value</span><br><span style="color: hsl(120, 100%, 40%);">+* Increment only</span><br><span style="color: hsl(120, 100%, 40%);">+* Accessible through the control interface</span><br><span style="color: hsl(120, 100%, 40%);">+* Rate counters are grouped and different instances per group can exist</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The control interface command to get a counter (group) is:</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+rate_ctr.per_{sec,min,hour,day,abs}.<group_name>.<idx>.[counter_name]</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+It is possible to get all counters from a group by omitting the counter name</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Stat Item</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Stat items are a grouped replacement for osmo counters, but not many stat</span><br><span style="color: hsl(120, 100%, 40%);">+items are available yet.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+* Printed as part of VTY show stats</span><br><span style="color: hsl(120, 100%, 40%);">+* Replacement for osmo counters</span><br><span style="color: hsl(120, 100%, 40%);">+* Not yet available through the control interface</span><br><span style="color: hsl(120, 100%, 40%);">+* Grouped and indexed like rate counters</span><br><span style="color: hsl(120, 100%, 40%);">+* Items have a unit</span><br><span style="color: hsl(120, 100%, 40%);">+* Keeps a list of the last values measured, so could return an average, min,</span><br><span style="color: hsl(120, 100%, 40%);">+  max, std. deviation</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Stats Reporter</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Statsd stats reporter can send osmo counter, rate counter and stats item values to statsd</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+See the stats reporter command of the VTY reference for details on how to</span><br><span style="color: hsl(120, 100%, 40%);">+setup the connection to statsd.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/13516">change 13516</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/13516"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-gsm-manuals </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3 </div>
<div style="display:none"> Gerrit-Change-Number: 13516 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Daniel Willmann <dwillmann@sysmocom.de> </div>