Module ore::metrics::delete_on_drop

This is supported on crate feature metrics only.

Support for metrics that get removed from their corresponding metrics vector when dropped.

Ownership & life times

This kind of data type is realized by a struct that retains ownership of the labels used to create the spin-off metric. The created metric follows these rules:

• When passing references, the metric must not outlive the references to the labels used to create it: A 'static slice of static strings means the metric is allowed to live for the 'static lifetime as well.
• Metrics created from references to dynamically constructed labels can only live as long as those labels do.
• When using owned data (an extension over what Prometheus allows, which only lets you use references to refer to labels), the created metric is also allowed to live for 'static.

Structs

DeleteOnDropCounter

A GenericCounter wrapper that deletes its labels from the vec when it is dropped

DeleteOnDropGauge

A GenericGauge wrapper that deletes its labels from the vec when it is dropped

DeleteOnDropHistogram

A GenericCounter wrapper that deletes its labels from the vec when it is dropped

Traits

CounterVecExt

Extension trait for all gauge metrics vectors.

GaugeVecExt

Extension trait for all metrics vectors.

HistogramVecExt

Extension trait for all gauge metrics vectors.

PromLabelsExt

An extension trait for types that are valid (or convertible into) prometheus labels: slices/vectors of strings, and HashMaps.