Monitors

Usage limits apply and are determined by your plan

How does monitoring work?

Monitors are used to watch for changes in your data and signal when a specified state or threshold is matched. Pro and Enterprise users can even provide scripts for even more in-depth control over monitors.

Depending on how you configure a monitor, you can choose whether the status roll up returns a red, amber or green color to the tile.

The status of the tile will then automatically roll up to the dashboard, and to the workspace. So if a tile turns red, so does the dashboard and workspace.

The red, amber or green status indicators mean you can instantly see if everything is okay or if something needs your attention.

Once your monitor is configured, SquaredUp can alert you when its state changes by sending notifications.

Overview video

This short video (2 mins 40) shows how to enable monitoring for a tile and add a new notification rule:

Monitor errors

If a monitor evaluation fails due to an error (for example, a timeout) the state of the monitor immediately changes to Unknown and the tile quickly changes to grey.

However, no notification is sent until five consecutive evaluation failures have occurred. This means that a monitor evaluation that intermittently times out will not trigger any notifications (unless there are five timeouts in a row).

Where can I see an overview of my monitoring?

Go to the Monitors tab on the left-hand side to see which dashboards and tiles related to this workspace have monitoring activated.

The Monitors page shows a table displaying monitors configured in this workspace, their current state, last and next evaluation times, and details of the last state change.

Click on the dashboard name to view that dashboard.

Configuring monitors

Monitoring is configured on a tile level, which means you can add monitoring to any tile on a dashboard. When you're editing a tile the Monitoring tab, on the right of the screen, lets you switch on and configure monitoring.

Monitoring can be based on a state (for objects that come with a state property), a threshold (like "if there are more then 10 new tickets in the last 24 hours switch the status to red"), or a monitor condition script.

The Preview box shows the tile's state color and value for the current configuration while you are changing settings.

Monitor settings

state
Select a state field from the tile to determine the monitor status.
threshold
This allows you to configure monitoring for yourself based on threshold levels you determine, for example, over 5 show as Error.
script
Use your own custom script to determine the monitoring status. See Scripts.

This feature is available with a Pro or Enterprise plan

State monitors

Column
Select the column that contains the state information. This will use a state field from the tile to determine the monitoring status and convert it into one of 3 levels: Success, Warning or Error.
Advanced:
Frequency
How often (in minutes) you want the data to be checked for changes.

Threshold monitors

Value
Select the value to monitor:
  • Top: Uses the latest data point (i.e the top value)
  • Sum: Adds the data points together
  • Mean: The average of the data points
  • Count: The total number of data points
Timeframe
The time period for which to aggregate data.
Evaluate by
Select a column to calculate a health state for each unique value in that column. A default column is selected based upon the available data.
Select None to perform the monitor calculation for the entire data set.
Column
The data column that will determine the threshold.
Conditions:
Error
Warning
For example, for Pingdom you might set Error to greater than 700, and the status will show as red when the Average Response is greater than 700ms.
Advanced:
Frequency
How often (in minutes) you want the data to be checked for changes.

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket