Tags and Filtering Basics

Tags and filtering are useful for organizations that have a high volume of checks. Create tags to filter checks in your Dashboard, Public Status Page, or SLA Reports so you can quickly access your most important checks.

Table of Contents

• Tags and Filtering At A Glance
• Creating Tags
  • Adding Tags to a Check
• Filtering Views
• Use Case: Filter by User
• Other Use Cases

Tags and Filtering At A Glance

• Add up to 1,000 tags to your account within the UI, and up to 6,000 tags using the REST API. 

• Add the same tag to any number of checks.

• Organize checks based on your use case and workflow.

Tags let you group checks based on what makes sense for your workflow.

Each account (and sub-account) can add up to 1,000 tags, with a 100-character limit.

By using the endpoint: POST/api/v1/check-tags/, each account (and-subaccount) can have up to 6,000 tags, with a 100-character limit also.

Here are a few examples of how one might set up tags:

• Teams or Team Members
• Monitor several domains, with tags to group by a client, business entity or domain/website name
• Tags that help to auto-select checks for use in a group check

The following tutorial assumes you’re logged in to your Uptime.com account.

Creating Tags

Return

Navigate to Monitoring. Click the drop-down arrow next to Add Check then click Manage Tags. Or in the menu bar, you can go to Settings > Tags.

You’ll be redirected to Settings > Tags. To add a new tag, at the top-right, click on Add tag field. As you add tags, a new field will appear underneath to enter the next one.

To assign a color to your tag, click on the gray box to the left of the text field. This will open the Select a tag color pop-up window. The color selection interface offers three ways to choose a color:

1. Color Matrix: At the top, you'll see a large color matrix that allows for fine-tuned color selection. You can click anywhere on this matrix to select your desired color shade.
2. Preset Colors: Below the matrix, there are 12 preset color options for your tags.
3. Hex Value: Enter a hex color value directly into the field to define a color.

Be sure to click the Save button when finished.

Adding Tags to a Check

Return

You can add a tag to any check type, and each check can have multiple tags. It's necessary to create tags before you can add them to a check.

When adding or editing a check, the Tags field appears under Basic options. If the field is not there, then no tags have been set up.

There are two ways to add tags to existing checks.

For the first method, navigate to Monitoring and click the Edit Check icon. Add tags in the Tags field and click Save.

To add Tags in bulk, navigate to Monitoring and tick the boxes next to each check for which the tags should be applied. Then click More actions > Set Tags from the drop-down menu.

When you choose the Set Tags option from the drop-down menu, the Manage Tags pop-up box appears. If you need to add additional tags, select the Manage Tags button to add new tags or delete ones that no longer apply.

Filtering Views

Return

By default, the Monitoring page displays all checks organized alphanumerically by name. For accounts with many checks, filtering and tagging offers options for narrowing down views to only the checks you need to view or edit.

The Filters option offers allows you to filter checks down to only what you need.

• To filter by Check State, click the Filters button then click “Status.” Select one of the following states:  Up, Down, Paused, or Maintenance to show only checks in those states. Multiple states can be selected.
• To filter by Tag, click the Filters button then click "Tags." Click to select specific tags, or type the names of the tags directly into the text box.
• To remove all filters, click the Filters button then click Reset All.

Active filter selections are denoted with a checkbox, with the total number of applied filters displayed next to the Filters button.

Use Case: Filter by User

Return

A Premium subscription has unlimited users at your discretion. You should assign each member of your team an account, and put those users in charge of their respective infrastructure. To improve efficiency in the management of their checks, your team can utilize tags for easy filtration. 

Tags will allow your teams to filter checks and create custom dashboards and status pages of any type. 

We suggest using tags that help categorize checks based on:

• Project Owners
• Group (such as grouping all API or sales related checks together)
• System
• Development and Production environments

Another option is to create a separate tag for projects in progress, which allows the company to check on sites currently under development and spot and correct problems before the website goes live.

Other Use Cases

Return

Tags are flexible enough for any company to organize checks for easy filtration.

Here are some other use cases for tagging in Uptime.com:

• Affiliate marketers with multiple domains
• Web hosting companies that offer managed site monitoring services for customers
• Managed IT service companies
• Freelance web developers responsible for site maintenance
• Computer security specialists working with cloud-based services, apps and network storage
• Data centers responsible for multiple servers can tag checks based on their equipment name or ID