Workspaces
Use workspaces to model your teams and entities, and the dependencies between them, to enable greater collaboration and knowledge sharing. A workspace may represent an application, a service, a component, a team… it's completely up to you. Each workspace has its own dashboards, data sources, monitors and scopes.
Each workspace has an overview page that you can access by clicking on the workspace name on the left-hand menu. There is a Workspace settings button at the top of each workspace overview page.
Additionally, each workspace has its own health which is rolled-up from its dashboards, monitors, and downstream dependencies.
Rollups aggregate status across workspaces to provide high-level summaries that make it easier to communicate status across the business. One place to visualize the big picture and bring together everything you need to stay in control.
This short video (2 mins 20) shows status roll-ups in SquaredUp:
Start by configuring a monitor on a dashboard tile (see Monitors). The monitor state will automatically rollup to the dashboard and in turn to the workspace.
How to add, edit and delete workspaces
From the Settings > Workspaces tab you can view, add, edit, and delete workspaces.
- To add a new workspace, do one of the following:
- Go to Settings > Workspaces then click Add workspace.
- Click + Create workspace after clicking on the dropdown next to the current workspace name on the left-hand menu.
- Configure the workspace settings:
- Configure the following on the General tab:
Name:
The name of the workspace.
Description:
Optionally, enter a description of the workspace.
Icon:
Optionally, you can upload an image for the workspace. The image will appear across the application such as on the home page, workspace home and maps
Tags:
Optionally, you can give the workspace one or more tags from the dropdown list. These can be used for grouping, filtering or searching, for example from the Organization home page, see Organization home.
Type:
Optionally, you can give the workspace a type from the dropdown list. This can be used for grouping, filtering or searching, for example from the Organization home page, see Organization home. - Optionally, configure the following on the Access Control tab:
Restrict access to this workspace:
Optionally, enable this toggle to limit who can access this workspace.Allow view-only sharing for all dashboards in this workspace:You can control access to workspaces by setting up permissions, where you can assign Viewer, Editor or Full Control permissions to users or groups. If you do not set permissions when creating a workspace, then anyone will be able to view, edit and administer it.
By default, Restrict access to this workspace is set to off. The workspace can be viewed, edited and administered by anyone. If you would like to control who has access to this workspace, switch Restrict access to this workspace to on.
Use the Restrict access to this workspace dropdown to control who has access to the workspace:
- By default, the user setting the permissions for the workspace will be given Full Control and the Everyone group will be given Viewer permissions.
- Tailor access to the workspace, as required, by selecting individual users or user groups from the dropdown and giving them Viewer, Editor or Full Control permissions.
- If the user is not available from the dropdown, you are able to invite them to the workspace by typing in their email address and then clicking Add. The new user will then receive an email inviting them to create an account on SquaredUp. Once the account has been created, they will gain access to the organization.
- At least one user or group must be given Full Control.
- Administrator users are able to modify the ACL and delete the workspace.
Access Level
Viewer- User can view the workspace contents (dashboards, scopes, KPIs, etc.).
- User can add the workspace as a downstream workspace for monitoring from other workspaces.
- User can see the workspace and related objects in their scopes (i.e., to monitor the state of the workspace).
- User cannot edit or delete anything within the workspace, including dashboards, tiles, scopes and KPIs. User cannot configure the workspace or its contents (e.g., change workspace name, change the ACL, configure notifications).
Editor- User can do everything from Viewer level, but additionally can modify the workspace contents (dashboards, scopes, KPIs, notifications, etc.).
- User can modify workspace properties, such as name.
- User cannot modify the workspace ACL.
- User cannot delete the workspace.
Full Control- User can do anything with the workspace, including changing its ACL and deleting it.
Administrators have special ‘administrative’ access to all workspaces. This means they see all workspaces listed under Settings > Workspaces, and they can modify workspace properties, including the ACL, for any workspace.
Administrators do not see all workspaces in the main dashboarding area of SquaredUp, and do not have any access to the contents of workspaces unless they add themselves to the workspace ACL.
When Sharing is enabled for the organization the Allow dashboard sharing toggle is shown and can be enabled or disabled for the workspace. Sharing allows dashboards in the workspace to be shared with anyone. See Sharing.
- Configure the following on the General tab:
- Click Add to create the new workspace.
- To edit workspace settings, do one of the following:
- Go to Settings > Workspaces then either click the Edit workspace icon next to the workspace name, or click the workspace name on the left-hand menu.
- Go to the workspace overview page (accessed by clicking on the workspace name on the left-hand menu) and click the top Workspace settings button.
- Configure the workspace settings:
- Configure the following on the General tab:
Name:
The name of the workspace.
Description:
Optionally, enter a description of the workspace.
Icon:
Optionally, you can upload an image for the workspace. The image will appear across the application such as on the home page, workspace home and maps
Tags:
Optionally, you can give the workspace one or more tags from the dropdown list. These can be used for grouping, filtering or searching, for example from the Organization home page, see Organization home.
Type:
Optionally, you can give the workspace a type from the dropdown list. This can be used for grouping, filtering or searching, for example from the Organization home page, see Organization home.
Default page:
Specify the default landing page to display when you switch to or drill down to a workspace. Choose from:- Workspace overview: Sets the default landing page to your workspace dashboard collection. This is the default option used when creating a new workspace.
- First dashboard in the list: Sets the default landing page to the first dashboard listed in the left-hand nav bar.
- Optionally, configure the following on the Access Control tab:
Restrict access to this workspace:
Optionally, enable this toggle to limit who can access this workspace.Allow view-only link sharing for all dashboards in this workspace:You can control access to workspaces by setting up permissions, where you can assign Viewer, Editor or Full Control permissions to users or groups. If you do not set permissions when creating a workspace, then anyone will be able to view, edit and administer it.
By default, Restrict access to this workspace is set to off. The workspace can be viewed, edited and administered by anyone. If you would like to control who has access to this workspace, switch Restrict access to this workspace to on.
Use the Restrict access to this workspace dropdown to control who has access to the workspace:
- By default, the user setting the permissions for the workspace will be given Full Control and the Everyone group will be given Viewer permissions.
- Tailor access to the workspace, as required, by selecting individual users or user groups from the dropdown and giving them Viewer, Editor or Full Control permissions.
- If the user is not available from the dropdown, you are able to invite them to the workspace by typing in their email address and then clicking Add. The new user will then receive an email inviting them to create an account on SquaredUp. Once the account has been created, they will gain access to the organization.
- At least one user or group must be given Full Control.
- Administrator users are able to modify the ACL and delete the workspace.
Access Level
Viewer- User can view the workspace contents (dashboards, scopes, KPIs, etc.).
- User can add the workspace as a downstream workspace for monitoring from other workspaces.
- User can see the workspace and related objects in their scopes (i.e., to monitor the state of the workspace).
- User cannot edit or delete anything within the workspace, including dashboards, tiles, scopes and KPIs. User cannot configure the workspace or its contents (e.g., change workspace name, change the ACL, configure notifications).
Editor- User can do everything from Viewer level, but additionally can modify the workspace contents (dashboards, scopes, KPIs, notifications, etc.).
- User can modify workspace properties, such as name.
- User cannot modify the workspace ACL.
- User cannot delete the workspace.
Full Control- User can do anything with the workspace, including changing its ACL and deleting it.
Administrators have special ‘administrative’ access to all workspaces. This means they see all workspaces listed under Settings > Workspaces, and they can modify workspace properties, including the ACL, for any workspace.
Administrators do not see all workspaces in the main dashboarding area of SquaredUp, and do not have any access to the contents of workspaces unless they add themselves to the workspace ACL.
When Sharing is enabled for the organization the Allow dashboard sharing toggle is shown and can be enabled or disabled for the workspace. Sharing allows dashboards in the workspace to be shared with anyone. See Sharing. - Optionally, configure the following on the Advanced tab:
Links:see Workspace linking for more information about links.
The Links section tells you how many workspaces the new workspace will be linked to. Workspaces will automatically be linked to the new workspace based on their permission settings.
Select Show workspaces to view all of the workspaces that are linked to the workspace.
You can remove linked workspaces by selecting x next to the desired workspace.
You can add linked workspaces by typing their name.
- Configure the following on the General tab:
- Click Save.
- Go to Settings > Workspaces.
- Click the Delete workspace icon next to the workspace that you want to delete.
- Click Delete.
This short 47 second video shows you how to organize the dashboards in your workspace:
Workspace Home
If you have the Default page option set to Workspace overview in the workspace settings, then the workspace home is displayed whenever you navigate to a workspace (after configuring a data source).
The workspace home presents an overview of the dashboards, monitors, data sources and health states within a workspace. This information is displayed across the Health, Data Sources and Map sections.
Health
The Health section lets you to view the rolled-up health state of the monitors and dashboards within your workspace. Use the filters at the top of the section to toggle between Monitors and Dashboards view and then use the adjacent Sort and State filters to control what is displayed. Click a monitor or dashboard in the list to open it. See What are status rollups?
Data Sources
The Data Sources section displays a list containing each of the data sources configured for the workspace, in addition to the Status of the data source and the count of objects it includes. Click a data source name to quickly open the corresponding overview page.
KPIs
The KPIs section lets you see all the KPIs in this workspace at-a-glance. See KPIs.
Map
The Map section displays an interactive model of the dependencies with this workspace. See Map for more information.
Displaying workspace state
Your Organization home page shows the state of each workspace.