Getting Started with the Uptime.com Group Check

Group checks allow the nesting of multiple checks that may or may not comprise a single system, and can also be useful when systems are interdependent.

To skip to a specific section of the "Intro to Group Checks" video, click the links with the youtube-logo-final.svg!

Grouping checks allows you to receive alerts under customizable failure conditions, or to report on the group’s average uptime %.

Table of Contents

What Can a Group Check Do?

  • Organize multiple checks monitoring a single system into one group
  • Alert when a specific group of checks sees a widespread outage
  • Escalate group check incidents to a system owner
  • Track components of a system, such as load balance

Creating a Group Check

Return to top

youtube-logo-final.svg Skip to 0:29

To create your first group check, click on Monitoring>Checks or Monitoring>Group Checks, followed by the Add New button. 

It is also possible to create a group check or add to an existing one using bulk actions. Select several checks from your list of checks and then click Bulk Actions > Create Group Check or Add to Group Check.

adding-group-checks.png

You will find the Group Check nested beneath the Web subheading in the All Checks dropdown. 

nested.png

Setup and Check Selection

Return to top

There are two methods to select checks:

  1. Manually select checks
  2. Auto-select checks by tag

Manual check selection allows you to add up to 200 individual checks to a group from a list of your existing checks.

Auto-selecting a check by tag will add all checks that have the selected tag(s) applied, including present and future checks added to this tag. 

A single Group Check is allowed a maximum of 50 tags, but each tag can contain an unlimited number of checks. You can find more detail about check tags here.

required-fields.png

A single check of any type can exist in multiple groups, but group checks cannot contain other group checks.

Group Behavior

Return to top

A group check can alert you when Downtime/Alert Conditions are met, or it can report an average uptime % for all checks within a group. 

group-behavior-reporting.png

When you report on average uptime %, the check’s contact field becomes disabled, and the check does not issue alerts. Additionally, a crossed-out bell icon in the UI signals notifications are not enabled.

Please note: Real User Monitoring (RUM), Blacklist, Malware, SSL Certificate Expiry, and WHOIS/Domain Expiry checks are excluded from calculations for average uptime % reporting.

average-uptime_.png

The group check’s default behavior is to alert you based on Downtime/Alert Conditions.  

Group Check Alert Conditions

Return to top

youtube-logo-final.svg Skip to 1:16

Group checks calculate a state change once every 30 seconds, and the state of the group (either UP or DOWN) is reflected at that time. 

Group Checks do not include real-time analysis. Alerts will specify when Group Down / Alert Conditions are met, and will contain a brief listing of checks nested within the group that reported downtime.

GC-alert.png

Group Down / Alert Conditions

Define a condition that will bring the group down. The following options are available:

  • Any assigned check is down
  • 2 / 3 / 4 / 5 / 10 assigned checks are down
  • 1 / 3 / 5 / 10 / 25 / 50 % of assigned checks are down
  • All assigned checks are down

An alert is issued when the selected Group Down / Alert Conditions are met, and the check is set to Alert when Downtime/Alert Conditions are met

This group check alert is in addition to any alerts issued by the individual checks within the group

Managing Group Checks

Return to top

A group check can contain multiple checks of any type, except for other group checks. Clicking any group check will display all checks nested within it. 

Managing group checks does not affect the settings of individual checks nested within that group, and there are a few additional limitations.

For example, group checks do not have a real-time analysis as they are available for the individual checks.

Group Checks Page

Return to top

GC-page.png

The Group Checks page shows all group checks configured for your account. Click into a given check to see a list of all assigned checks organized within that group check. 

group-check-example.png

Adding and Removing Checks from a Group

Return to top

To add or remove checks from an existing group, locate the group check from Monitoring>Group Checks, and selection Actions>Edit. Select checks from the Checks Available window, and deselect any checks from the Checks Selected window to remove them:

Comp_1_1.gif

Note: Deleting a check from within a group deletes the check from your account but deleting a group check does not delete the individual checks within it. 

gc-delete-check.png

If checks have been assigned to a group by tag, and you wish to remove them, you will need to navigate to the check(s) in question and click Actions>Edit to remove the check’s tag. This operation can be done in bulk

Maintenance with Group Checks

Return to top

Individual checks assigned to a group can be in maintenance mode, but the group check does not inherit this status from the nested children checks.

To put a group check in maintenance mode, click  Monitoring>Group Checks, select the check in question and click Actions>Edit. Click the Maintenance tab to set a maintenance window

Scenario:
If an individual check under maintenance belongs to a group that is not under maintenance, and this check goes down, its downtime applies to the failure condition you have selected.

Accessing Group Check Reports

Return to top

youtube-logo-final.svg Skip to 1:56

To access an Uptime report for a Group Check, select Actions>Report for that Group Check from the list of your group checks.

actions-report-GC.png

You can investigate a report for an individual check from the Group Check Details page when you click the name of the group check.gc-report-access2.png

Group checks do not list a response time, but response time is available for any checks nested within a group. 

Use Cases for Group Checks

Return to top

Get Alerted to Widespread Outages

Return to top

With large enough sites or monitored infrastructures, a single failed URL doesn’t always indicate a problem. If you’re monitoring dozens, or hundreds, of URLs, it may be more beneficial to think of your site’s uptime in terms of percentage of down URLs. Using the Uptime.com group check, you can monitor these URLs and set alerts when 1%, 3%, or even 10% of these URLs go down. 

Cataloging all Checks for a Single System

Return to top

Suppose “My System” contains 5 components, and more than one of those components can fail before the system will stop working. A group check set to fail if 2 of its 5 assigned checks fail will give your team first-alert capability that a critical system is potentially down. 

Escalating to a System Owner

Return to top

Building on the previous use case, Uptime.com normally recommends escalations to a system owner after X minutes of downtime have passed. Such practices lead to resolutions, and improve overall downtime response. Group checks can offer a more immediate and precise escalation to the system’s owner, with data on which systems are down to improve reaction and time to resolution. 

Properly configured, alerts from a Group Check can provide real-time visibility on potentially critical system failures. 

Track Important Product Pages

Return to top

Group checks can monitor performance and uptime for a set of HTTP(S) checks aimed at your most trafficked landing pages. Group these checks together for reporting purposes to see how well these most important pages perform. Group Checks do not report on response time, but the individual checks nested within them do. Use Real User Monitoring to supercharge the data you collect with real-user session performance. 

Load Balance Tracking

Return to top

Group checks can be effective for monitoring a load balancer. Setup will require multiple HTTP(S) checks, one pointing directly to the domain and the remainder pointing to each load balance IP address using the HOST header. More details on check setup, with examples, are available here.

Group these HTTP(S) checks into a single group check and set failure conditions to either multiple URLs, or by percentage of URLs down for the most accurate representation into the state of your load balancing. 

Reporting on Average Uptime% for a Single System

Set a Group’s behavior to Report on average uptime% to create a check that will provide the average of any checks assigned to it as a single value. Attach this check to any existing SLA and scheduled reporting, as a card in your Dashboard, or as a component of your status page

Want to see our checks in action? Check out our youtube-logo-final.svg YouTube Library for more!

Was this article helpful?
1 out of 1 found this helpful