This article only applies to Squared Up Version 2.0. If you're looking for help with Squared Up Version 3.0, please visit our new knowledge base

The Scope of a dashboard or section defines the objects or groups for which data is displayed. A dashboard author can either set the scope for the whole dashboard or on a per section basis.

Scope options

There are three ways of defining the scope, whether it is at the page or section level:


Search and select one or more objects. Start by typing the name of an object such as a server and the dropdown will display a filtered list that meets the criteria after each character is typed.

You can also use the list option to show the status of the group itself, rather than the objects within the group:

To remove an item click the x to the right of the item.


Instead of listing servers, you can select a group. As you type the dropdown will be populated with a filtered list of groups from SCOM. Only one group can be selected.

Select the required group from the list in the dropdown.

If you wish to view the members of a group you would use Scope Group in the Status plugin:

In Squared Up v2.2 onwards the performance and KPI scope's support 'recursive' level searches for objects, so it will look at multiple levels of membership rather than just one level, i.e. it will show objects that aren't directly contained in a group, but are contained within other objects in the group. This means you can now use top-level groups to show graph data for objects within sub-groups, by specifying a group AND a class in the Advanced Scope as described below.

In Squared Up v2.1 or below, your group must contain objects rather than just subgroups. A group that contains sub-groups won't show any performance or KPI data.

Filter by State

The scope can be set to include only items that are in critical health or in maintenance mode or both.


The advanced scope has the additional options of specifying class and/or criteria.


You may choose to display objects by class, rather than the objects in a particular group. Either the Class or Group (or both) must be defined. The class text box equates to target class within SCOM.

As you type the dropdown will be populated with a filtered list of classes from SCOM, from which you can select the required class.

For example, in the Status section, you can use the class 'Group' to see the health state of all groups.

You can use a group AND a class (in v2.2 onwards) to show graph data for objects within subgroups.  Note: Choose your class carefully as for a Performance section this will determine which metrics are available in the Metric section.

For example, for a Server KPI dashboard using a group which contains subgroups you would use the class 'Windows Server':


This allows you to create an expression to further refine the scope.


How to use criteria when scoping objects

How to use criteria when scoping alerts

Page Scope

To set the scope for the whole dashboard click set page scope.

Any new dashboard sections will inherit the page scope, and if the page scope is for a single object or group, then the health status is shown next to the page title and the 'maintenance mode' button appears enabling you to put a whole group into maintenance mode.


For more information on the page scope see, How to use the Page Scope

To set the scope for an individual section click on the Scope bar within the 'Configure section'.

Using Wildcards

Refining your scope using wildcards

By default searching will look for the top 10 items containing the words listed in the search. If you wish to create a more specific search you will need to use wildcards (*).

If you provide a wildcard after the term you are looking for, it will find all the objects which start with that word searched and any terms that may follow, an example of this can be seen below.

The same applies if the wildcard is placed at the start of the search, it will look for objects that contain the searched word and which also have terms before that word, see the following for clarification.

If you enclose your searched term in wildcards it will look for objects which contain the searched word, this object will not begin or end with the term searched.

See also:

The Dashboard Designer - The Quick Start Guide

How to find the CounterName for a Performance section

No available data

Dragging a Performance Graph onto a dashboard

How to use the Page Scope

How to use Sort by and Group by to sort objects in Status sections