# dyn_inc()

## Purpose

dyn_inc(bucket_name_literal_string, str)

Increments counter identified by `str` in dyn-stats bucket identified by `bucket_name_literal_string`. Returns 0 when increment is successful, any other return value indicates increment failed.

Counters updated here are reported by impstats.

Except for special circumstances (such as memory allocation failing etc), increment may fail due to metric-name cardinality being under-estimated. Bucket is configured to support a maximum cardinality (to prevent abuse) and it rejects increment-operation if it encounters a new(previously unseen) metric-name(`str`) when full.

Read more about it here Dynamic Stats

## Example

The following example shows the counter $hostname incremented in the bucket msg_per_host.

    dyn_inc("msg_per_host", $hostname)

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.