Metrics

Metrics in ilert lets you provide additional information about the health of your services in status pages.

What is a metric?

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.

Metric Display Options in ilert

ilert provides two ways to display a metric

1. Line graph (optionally with an aggreated value)

2. Single number

Line Graph

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.

Linear interpolation

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.

Single number metric

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).

Create a metric

1. In the main navigation bar, click on Status pages (or Incident comms) --> Metrics

2. Click on the Create metric button

3. 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.

4. Configure your metric and click Save

Add a metric to status page

Once you have created a metric, you can add the metric to any of your status pages.

1. Navigate to the status page to which you want to include the metric

2. 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.
3. 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.

Submit data points to a metric

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:

curl -L -X POST 'https://api.ilert.com/api/series/ilm110229945419465b5494fxxxxxxxxxxxxxxxxf' \
-H 'Content-Type: application/json' \
--data-raw '{
    "value": 8.223
}'

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.

Generate sample data

ilert lets you generate one time sample data for your metric

1. Open your metrics settings page

2. Click on the ... button in the top right and select Generate demo data

3. Select the range for the random data and click on Generate demo data

Clear metrics data

To clear metrics data

1. Open your metrics settings page

2. Click on the ... button in the top right and select Delete metric data

This will delete all data points for that metrics.