Skip to main content
Cachet allows you to track arbitrary metrics on your status page. A metric can represent anything measurable, such as the number of users on your platform, the number of requests per second or even random things like the number of teas brewed. A metric consists of:
  • Name: The name of the metric, e.g. Users Online.
  • Suffix: The suffix of the metric, e.g. users.
  • Description: A description of the metric, e.g. The number of users currently online.
  • Default View: How to display the metric, e.g. Last hour, Today, Week, Month.
  • Default Value: The default value of the metric when missing points, e.g. 0.
  • Display Chart: Whether the metric is plotted in a chart on the status page. You can enable or disable this.
  • Places: The number of decimal places to display.
  • Metric Type: The type of calculation to perform on the metric, e.g. sum or average.
  • Threshold: The threshold determines when a new point should be created or the last point updated.
  • Show when empty: Whether Cachet displays the metric on your status page when it has no points. When disabled, the metric is hidden until it has data.
  • Visible: Whether the metric is visible to users, guests or always hidden.

​
Metric points

A metric is made up of multiple points that you add over time. Each point consists of:
  • Value: The value of the metric at this point in time.
  • Timestamp: The time the metric was recorded.
For performance, if you create a metric point within the threshold of an existing point, Cachet updates the existing point with the new value.

​
Reordering metrics

You can reorder metrics to control the order they appear in on your status page, in the same way you reorder components.