class pixeltable.telemetry.Histogram

A distribution of per-observation values; declare once at module level with histogram(). Record individual observations only (a call’s latency, a file’s size); recording pre-aggregated sums produces meaningless percentiles. boundaries advises the backend’s bucket layout for backends whose defaults don’t fit the recorded value range.

method record()

Signature

record(value: int | float, **attrs: Any) -> None

Record one observation; keyword attrs get a ‘pxt.’ prefix, None values are skipped. The same low-cardinality rule as Counter.add() applies to attrs.

Last modified on October 9, 2026