Lexicon
Counter
A counter is a metric that only increases: requests served, errors thrown, bytes sent. How to read counters with rate and increase, and the classic errors.
On this page
Definition
A counter is a metric type for values that only accumulate: requests served, errors thrown, bytes transmitted, jobs completed. The stored value climbs continuously and resets to zero when a process restarts, which is why counters are almost never read raw.
What it means in observability
Counters answer how much and how fast for events. The raw cumulative total, 4,183,203 requests since startup, is rarely the interesting number; what teams actually watch is derived from it: requests per second, errors in the last five minutes, growth versus last week. Counters are the foundation of rate based alerting and of the traffic and error halves of the golden signals, which makes them the most queried metric type in most estates.
How it works in practice
Reading a counter means transforming it. Rate converts the cumulative series into per second change, increase yields the raw change over each interval, and normalization expresses change per second, minute, or hour regardless of bucket size. Temporality matters underneath: cumulative counters report running totals while delta counters report per interval changes, and the backend accounts for restarts so a process reset does not masquerade as negative traffic.
Where it gets hard
The classic errors are all reading errors. Plotting raw cumulative values produces an impressive staircase that says nothing. Averaging a counter makes no sense at all. Comparing rates computed over different windows quietly compares different things. And around restarts, naive arithmetic produces spikes or negative values unless reset detection handles the discontinuity.
Where Tsuga fits
Tsuga exposes rate, increase, and normalization as one click functions and shows each metric's type and temporality in the explorer, so counters get read the way counters work.
Related terms
- CardinalityCardinality is the number of distinct values, or distinct value combinations, that an attribute or set of attributes can take.
- GaugeA gauge is a metric type that records a point in time value that can move in both directions: memory in use, queue depth, active connections, temperature, items in a cart.
- HistogramA histogram is a metric type that captures how values distribute, by counting observations into buckets, rather than recording what any single value was.
- MetricA metric is a named numeric measurement tracked over time, request counts, memory usage, response latency, carrying a type, a unit, and attributes that slice it into series.