kumomta/docs/reference/kumo.counter_series/increment.md

tags

tags
counter_series

counter_series:increment

series:increment(value)

{{since('2026.05.12-a6845223')}}

Adds value to the current bucket of the series.

• value — unsigned integer amount to add. Must be >= 0.

The current bucket is the one corresponding to the present moment in time; older buckets rotate out automatically as time elapses.

Addition saturates at u64::MAX. To subtract from the current bucket, use delta with a negative value.

Example

local series = kumo.counter_series.define {
  name = 'deliveries.ok',
  num_buckets = 5,
  bucket_size = '1m',
}
series:increment(1)