Workspaces
What is a Workspace
A workspace is the top-level organizational unit in OpsWorker. It groups clusters, users, alert rules, and notification configurations into a logical boundary that represents a team, environment, or organizational unit.
Every OpsWorker organization starts with one workspace. You 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
│ ├── Alert Rules: critical alerts only
│ └── Notifications: #platform-incidents
├── Workspace: "Application Team"
│ ├── Cluster: staging
│ ├── Alert Rules: all severities
│ └── Notifications: #app-alerts
What Belongs to a Workspace
| Resource | Scoping |
|---|---|
| Clusters | Each cluster belongs to one workspace |
| Users | Users can be assigned to one or more workspaces |
| Alert Rules | Configured per workspace/cluster |
| Notification Routing | Slack channels configured per workspace |
| Investigations | Visible to users with access to the workspace |
Common Patterns
- By team: Each team gets a workspace with their clusters and notification channels
- 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 under Account Settings. Admins can create, rename, and configure workspaces. See Manage Workspaces for detailed instructions.