Roles
The built-in system roles and how to create, edit and delete custom roles with the permission matrix.
rolescustom rolessystem rolespermission matrix
System roles
The three built-in roles cover the most common needs and can be assigned as-is. They are locked — you can view their permissions but not edit or delete them, so there is always a known-good baseline.
| Role | Typical use |
|---|---|
| Admin | Team leads and platform owners who administer the organization. |
| Member | Engineers doing day-to-day observability work. |
| Viewer | Stakeholders, auditors, or anyone who should see but not change. |
Custom roles
When the built-in roles aren't a perfect fit, create your own — for example a role that can manage alerts and on-call but only view everything else.
Creating a role
- Go to Settings → Roles and Permissions and click Create role.
- Give the role a clear name and a short description.
- In the permission matrix, tick the permissions to grant. Each row is a module (Dashboards, Alerts, Network, …) and each column is an action (View, Manage, Use).
- Use the shortcuts to move faster: the checkbox at the top of a column selects that action for every module; the checkbox on a row selects every action for that module; All / None set everything at once; and the filter box narrows the matrix to a module by name.
- Click Create role. It's now available to assign.
Editing and deleting
- Open any custom role to adjust its name, description or permissions.
- Each role card shows a member count — how many people currently hold it.
- Deleting a role removes it from everyone who had it; they keep the permissions from their other roles. System roles can't be deleted.
Tip: Admin-only permissions are highlighted in the matrix. Granting any of them (for exampleusers.manageorbilling.manage) makes a role able to administer that sensitive area — reserve them for roles you truly intend to be administrative.