> ## Documentation Index
> Fetch the complete documentation index at: https://cachethq.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics

> Learn how to manage metrics in Cachet.

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](/docs/v3.x/guide/components#reordering-components).
