Workspaces
What is a Workspace
A workspace is a grouping within your OpsWorker organization. The organization is the top-level tenant; a workspace organizes clusters into a logical boundary that represents a team, environment, or business unit.
Every OpsWorker organization starts with one default workspace. Admins can create additional workspaces to separate concerns, for example one workspace per team, per environment, or per business unit.
How Workspaces Organize Your Setup
Organization (your company)
├── Workspace: "Platform Team"
│ ├── Cluster: production-us-east
│ └── Cluster: production-eu-west
├── Workspace: "Application Team"
│ └── Cluster: staging
Alert rules and notification routing are configured per cluster, not per workspace. A workspace is the boundary that owns the clusters.
What Belongs to a Workspace
| Resource | Scoping |
|---|---|
| Clusters | Each cluster belongs to one workspace |
| Users | Each user belongs to exactly one workspace |
| Alert Rules | Configured per cluster (within a workspace's clusters) |
| Notification Routing | Configured per cluster and namespace |
| Investigations | Visible to users in the organization |
A user belongs to exactly one organization and one workspace. There is no multi-workspace membership and no per-workspace roles; roles (Admin, ReadOnly) are assigned at the user level.
Common Patterns
- By team: each team gets a workspace with their clusters.
- By environment: separate workspaces for production, staging, and development.
- Single workspace: small teams often use one workspace for everything.
Managing Workspaces
Workspaces are created and managed in the OpsWorker portal. Admins can create, rename, and delete workspaces. See Manage Workspaces for detailed instructions.