-Timers record the time it takes to do stuff.
+Timers record the time it takes to do things. They're a bit like histograms
+where the value being recorded is time.
+Timers should be a fairly intuitive concept. They can tell you things like:
+ 75% of all searches took 0.5 seconds or less. 95% of all searches took 1.0
+Timers also track the rate of the timed events, so it's like they have a meter
+metric built-in for convenience.
(def image-processing-time (timer "image-processing-time"))
You can also use the ``deftimer`` macro to create a timer and bind it to a var
in one concise, easy step::
+Once you have a timer you can record times to it in two different ways.
+You can record the time it takes to evaluate one or more expressions with the ``time!`` macro::
(use '[metrics.timers :only (time!)])
-``time!`` is a macro. If you need a function instead, you can use ``time-fn!``,
-but you'll need to pass it a function instead of just a body::
+``time!`` is a macro. If you need a function instead (e.g.: for ``map``'ing
+over a list), you can use ``time-fn!``, but you'll need to pass it a function
(use '[metrics.timers :only (time-fn!)])