Check Groups

What a Check Group Is

A Check Group is a team-scoped group that holds shared settings which its member checks inherit. Instead of configuring locations, alerting, and frequency on every check, you set them once on the group and assign checks to it. A group manages:

• Locations — the regions members run from.
• Alert channels — where members send notifications.
• Alert frequency — how often members alert.
• A mute / activate switch — a single on-off control for all members.

This lets you manage regions, alerting, and the on/off state of many checks from one place.

Manage Groups

Open the Check Groups page to create, edit, and delete groups. When you create or edit a group, pick its shared locations, alert channels, and alert frequency.

Assign a Check to a Group

When creating or editing a check, use the Group selector on the New API Check page to add the check to a group. The check then inherits the group's shared settings.

Inheritance Rules

The relationship between a group and its members follows a few clear rules:

• When the group defines a setting, it takes precedence over the check's own setting. The group-level locations, alert channels, and frequency override what the individual check would otherwise use.
• Muting the group mutes all of its members. Members still run on schedule, but no alerts are sent for any of them.
• Deactivating the group pauses all of its members. None of the member checks run while the group is deactivated.
• If a group is deleted, its members fall back to their own settings. The checks are not deleted — they simply resume using their individual configuration.

Why Use Groups

Check Groups are the fastest way to apply a consistent set of regions and alerting policies across a fleet of checks, and to pause or mute an entire set of related checks during a deploy or an incident — all from a single control.

For per-check configuration, see How to Create a New API Check.