kuilt-otel/us.tractat.kuilt.otel/MetricBufferPolicy

MetricBufferPolicy

enum MetricBufferPolicy : Enum<MetricBufferPolicy>

Controls what happens when the number of distinct metric series in WarpMetricExporter reaches maxMetrics.

Unlike span buffers, a metric's accumulated value does not grow with the number of events — a counter recording a million increments still takes O(1) space. Buffer caps therefore apply to the number of distinct metric series (unique MetricKeys), not to the number of events. A cap is only needed when code creates an unbounded fan-out of label combinations (a label cardinality explosion).

Every eviction is logged with the evicted key, so an operator can tell which series were dropped.

Entries

DROP_OLDEST

Drop the metric series that was last written earliest (by insertion order).

DROP_NEWEST

Drop the metric series that was last written most recently.

Properties

entries

val entries: EnumEntries<MetricBufferPolicy>

Returns a representation of an immutable list of all enum entries, in the order they're declared.

name

expect val name: String

ordinal

expect val ordinal: Int

Functions

valueOf

fun valueOf(value: String): MetricBufferPolicy

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

values

fun values(): Array<MetricBufferPolicy>

Returns an array containing the constants of this enum type, in the order they're declared.