Collections
A collection is a named group of objects, such as all the services owned by a team or every host in a single region. Collections allow you to save these groups for reuse, so you don't have to keep picking the same objects every time you edit a tile.
They also keep your dashboards consistent. Every tile that uses the same collection shows the same objects. A single change to the collection updates every tile automatically.
Collections also power dashboard filters, giving viewers a list of objects to switch between to dynamically update their dashboards.
Each collection belongs to the workspace you create it in, meaning each workspace only shows the collections that are relevant to it.
Collection types
Every collection is either fixed or dynamic. You choose the type when you select its objects, and the Collections page shows it in the Selection column.
Fixed
A fixed collection contains the specific objects you select. It only changes when you edit it.
Use one for a hand-picked set, such as the services a team owns.
Dynamic
A dynamic collection saves a search instead of a list. Each time a tile loads, SquaredUp finds the objects that match, so new objects are added and removed ones drop out automatically.
Use one for a set that follows a rule, such as every host in one region. Collections that data sources add for their built-in dashboards are dynamic.
Collection usage
Once you’ve created a collection, you can pick it wherever you choose objects for a tile, including object fields on the Parameters step and in the Data Explorer. Change the collection, and every tile and filter that uses it updates to match. You’ll use collections in:
- Tiles: Select a collection instead of individual objects on the Objects step of the tile editor.
- Dashboard filters: Supply the objects viewers can switch between.
Manage collections
Collections are managed from the Collections page in each workspace’s left-hand menu. You can also create one from the tile editor.
Create a collection
- In a workspace, click Collections in the left-hand menu, then click Add collection.
- Find the objects you want. Search by name in Search objects, or narrow the list in the Filter panel by data source, type or collection. To filter by another property, click Add filter.
- Tick the objects for a fixed collection, or select the checkbox in the table header for a dynamic one.
- Click Next, enter a name, and click Save.
If you filter by a collection as well as other filters, the header checkbox is unavailable and the new collection has to be fixed.
You can also create a collection from the tile editor. On the Objects step, click next to Collection in the Filter panel. The Add collection window opens with the objects you’ve already chosen.
Edit a collection
Editing a collection changes every tile and dashboard filter that uses it, and the edit window shows a warning to remind you.
- In a workspace, click Collections in the left-hand menu, then click edit next to the collection.
- Change the objects. Tick or untick objects, change the filters, or use the checkbox in the table header to switch between fixed and dynamic. The panel on the right lists the objects currently selected.
- Click Next, change the name if you need to, and click Save.
Delete a collection
- In a workspace, click Collections in the left-hand menu.
- Click delete next to the collection.
- Click Delete to confirm. Deleting a collection is permanent.
Collection limits
A collection can hold up to 500 objects. From 100 objects, SquaredUp warns that the collection may slow dashboards down. Over 500, only the first 500 are used. Dynamic collections can grow past the limit over time, so check their size now and then.