Metrics
Provide basic information about the health of your services by including metrics in status pages
Last updated
Provide basic information about the health of your services by including metrics in status pages
Last updated
(c) 2011 - 2024 ilert GmbH
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 aggreated 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 aggregration 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.
Interval aggregration in graphs (aka rollup aggregration)
ilert stores a large number of data points per metric (up to one datapoint every 30 seconds). In most cases, there are more data points than what can be visualized on a graph. Therefore, ilert aggregates the values by combining them in time intervals. For example, when selecting Month as period, data points are aggregated into 2 hour intervals. To aggreate the values, ilert uses the same aggregation function that you select for the summary display in the right corner of the graph.
Periods and Aggreation Intervals
Month - 2 hours
Week - 30 minutes
Day - 5 minutes
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 aggregration functions from above. Additionally, you can chose 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
Chose your metric data source. You can either submit metric data using our Series API or import metrics from a 3rd party metrics provider such as Datadog or Prometheus.
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 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.
Metrics API Key
Every metric has its own API key, just like alert sources have their own API keys. You cannot use your personal API key so submit metrics data at the moment.
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.
Our API also support submitting multiple data points at once. Refer to our API documentation for more information.
ilert's Metric Data Storage
A metric can store maximum 1 data point every 30 seconds. Each submitted data point is truncated to its nearest 30s interval.
Submitting data points with a higher resolution will result in the last data point being the only one stored.
A metric can store data up to 28 days in the past. When creating a new metric, we recommend to backfill data for the past 28 days.
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.
