Metrics
Provide basic information about the health of your services by including metrics in status pages
Last updated
Was this helpful?
Provide basic information about the health of your services by including metrics in status pages
Last updated
Was this helpful?
Metrics in ilert lets you provide additional information about the health of your services in status pages.
A metric is a numerical value that can track anything over time, such as API response time, API error rates, number of open tickets, etc. ilert stores metric data as pairs of floating point values and timestamps.
ilert provides two ways to display a metric
Line graph (optionally with an aggregated value)
Single number
Here's an example of a metric visualized as a line graph:
Display name: The name of the metric that will be displayed on the status page
Period: A metric can be visualized over a period of 24 hours (day), 7 days (week) or 28 days (month).
Aggregated value: An single value that combines all values over the selected period by applying an aggregation function. The aggregated value is shown in the top right corner of the graph and can be hidden. ilert provides four aggregations that you can choose from:
AVG: the arithmetic average of all values over the selected period
SUM: the arithmetic sum of all values over the selected period
MIN: the minimum value of all values over the selected period
MAX: the maximum value of all values over the selected period
Display unit: this unit will be shown as a suffix. Note that this unit is just for display purposes and can be left empty.
With linear interpolation, missing data points will be shown by drawing a straight line between two known data points. If you disable linear interpolation, missing data points will be shown as gaps in the line graph.
Example
The following metric has missing data points. Below you can see the effect of interpolation.
Here's an example of a metric that is displayed as a single number:
Metrics that are displayed as a single number provide the same aggregation functions from above. Additionally, you can choose to display the last reported value (i.e. the value with the latest timestamp).
In the main navigation bar, click on Status pages (or Incident comms) --> Metrics
Click on the Create metric button
Configure your metric and click Save
Once you have created a metric, you can add the metric to any of your status pages.
Navigate to the status page to which you want to include the metric
Go to the Metrics tab, click on the Add metric button and select the metrics that you would like to add to the status page.
The metric will now be displayed on your status page. You can change the order of metrics by reordering the metrics in the metrics tab of the status using drag and drop.
Submitting data points to your metric is as easy making an HTTP POST request using the API key of your metric.
You will find the API key of the metric in the metric's settings page:
Here's an example curl command to update the above MTTA metric to 8.223 minutes:
Note that the timestamp value is omitted in the JSON payload. In this case, the current time stamp will be used.
ilert lets you generate one time sample data for your metric
Open your metrics settings page
Click on the ... button in the top right and select Generate demo data
Select the range for the random data and click on Generate demo data
To clear metrics data
Open your metrics settings page
Click on the ... button in the top right and select Delete metric data
This will delete all data points for that metrics.
Choose your metric data source. You can either submit metric data using our or import metrics from a 3rd party metrics provider such as or .
Our API also support submitting multiple data points at once. Refer to our for more information.
