Distribution Summary

A Distribution Summary is used to track the distribution of events. It is similar to a Timer, but more general, in that the size does not have to be a period of time. For example, a Distribution Summary could be used to measure the payload sizes of requests hitting a server.

Always use base units when recording data, to ensure that the tick labels presented on Atlas graphs are readable. If you are measuring payload size, then use bytes, not kilobytes (or some other unit). This means that a 4K tick label will represent 4 kilobytes, rather than 4 kilo-kilobytes.

Call record() with a value:

from spectator.registry import Registry

registry = Registry()
registry.distribution_summary("server.requestSize").record(10)

request_size = registry.new_id("server.requestSize")
registry.distribution_summary_with_id(request_size).record(10)