Search…
⌃K
Links

Viewing your list of workspaces

The Workspaces view lists the workspaces that you have access to. To display the Workspaces view, in the left navigation pane, click Workspaces.
Workspaces view

How the workspace list is displayed

If you are an admin user, then the list includes all of the workspaces in the instance.
Otherwise, the list contains:
  • Workspaces that you own
  • Workspaces that you are granted access to
Admin users are able to see all of the workspaces in the instance. They can use the Role filter to only display workspaces for which they have a role.
Child workspaces always display under their parent workspace. You can only see child workspaces that you have access to. If you have access to a child workspace, but not to its parent workspace, then the parent workspace is grayed out. You cannot select it.

Filtering the workspace list

You can filter the workspaces based on the following information:
  • Name - In the filter field, begin to type text that is in the name of the workspaces to display in the list.
  • Owner - From the Filter by Owner dropdown list, select the owner of the workspaces to display in the list.
  • Database type - From the Filter by Database Type dropdown list, select the type of database for the workspaces to display in the list.
  • Generation status - In the Generation Status column heading, click the filter icon. Check the checkbox next to the generation status values for the workspaces to display in the list.
  • Tags - In the Tags column heading, click the filter icon. By default, the workspaces are not filtered by tag, and all of the checkboxes are unchecked. To only include workspaces that have specific tags, check the checkbox next to each tag to include. To uncheck all of the selected tags, click Reset Tags. When you filter by tag, Tonic checks whether each workspace contains any of the selected tags.
  • Role - In the Role column heading, click the filter icon. You can check and uncheck checkboxes to include or exclude specific roles. For example, you can filter the list to only display workspaces for which you are an owner. For admin users, the Role filter panel also contains a Role assigned checkbox. By default, Role assigned is unchecked, and the list includes workspaces that you do not have a role for. To display all of the workspaces that you do have a role for, check Role assigned. If you filter the list to only display workspaces that have a specific role for, to clear the filter and show all workspaces that you have a role for, check Role assigned. To display all workspaces, including workspaces that you do not have a role for, uncheck Role assigned.
You can combine different filters. For example, you can filter the list to only include workspaces that use PostgreSQL and for which the generation status is Canceled or Failed.
Child workspaces always display under their parent workspace, even if the parent workspace does not match the filter.

Sorting the workspace list

You can sort the workspace list by name, role, or owner.
By default, the list is sorted alphabetically by name.
To sort by a column, click the column heading. To reverse the order of the sort, click the column heading again.
Child workspaces always display under their parent workspace. The child workspaces are sorted within the parent.

Workspace details on the Workspaces view

The Workspaces view provides the following information about each workspace:
  • Name - Contains the name and database type for the workspace. To view the workspace description, hover over the name.
  • Generation status - The status for the most recent generation job. To display the job details for the job, click the job status. To display more details about the date, time, and duration for the job, hover over the generation timestamp. If a job failed recently, you are given additional information about how long this job has been failing (the date of the first failure occurrence among a continuous series of failures).
  • Schema changes - Indicates whether Tonic has detected changes to the source database schema. If there are changes, shows the number of changes. Hover over the column value to display additional details, and to navigate to the Schema Changes page. See Viewing and resolving schema changes.
  • Tags - The tags that are assigned to the workspace.
  • Role - Your role for the current workspace.
  • Owner - The name and email address of the workspace owner.

Getting access to workspace actions

The top Tonic toolbar contains options for the currently selected workspace.
Toolbar options for a workspace
On the Workspaces view, the last column in the list provides additional workspace options:
Options column and dropdown list for a workspace
  • Subsetting icon - Displays the subsetting configuration for the workspace.
  • Post-job actions icon - Displays the post-job actions for the workspace. See and Webhooks.
  • Actions menu - Provides access to additional options.
The Actions menu allows to to perform bulk actions on multiple workspaces. It is enabled when you check one or more of the checkboxes at the far right of each row. The Actions menu provides options for the selected workspaces.
Actions menu for selected workspaces