Dataset restrictions are in public beta on the Honeycomb Enterprise plan.
groups:read or groups:write scope.
To learn more, visit Management Key Scopes.
To automate groups and restrictions, visit Manage Dataset Restrictions with the API.
Before you begin
You must be a Team Owner to view and manage user groups.Create a user group
Create a user group for each set of people who need the same access to restricted data. To create a user group:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Select New group.
- On the Create New Group page, enter a Group name and, optionally, a Group description. Group names must be unique within your team.
- In the Permissions section, select the group’s Dataset access for each environment. Optionally, in the Users section, select Add users, select the team members who belong to the group, and then select Add N users.
- Select Create group.
Grant a group access to restricted data
Grant access so group members can read restricted data; everyone on your team can already read unrestricted datasets. To grant a group access to restricted data:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Locate the group in the list, and select Edit.
- In the Permissions section, locate the environment in the table.
-
In the Dataset access column, select the group’s access:
- If you selected Custom, in the Customize access to restricted datasets dialog, select the restricted datasets the group can read, and then select Allow access to N restricted datasets. The datasets you chose appear in the Allowed restricted datasets column. To change them later, select Edit in that column.
- Select Update group.
Add users to a group
A person’s access is the combination of every group they belong to, so add them to each group whose access they need. To add users to a group:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Locate the group in the list, and select Edit.
- In the Users section, select Add users.
- Select the users to add, and then select Add N users.
- Select Update group.
Remove users from a group
Remove users from a group when they no longer need its access. They keep any access that their other groups grant. To remove users from a group:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Locate the group in the list, and select Edit.
- In the Users section, select the users to remove, and then select Remove users from group.
- In the confirmation dialog, select Remove N users.
- Select Update group.
Edit a user group
Edit a group when its name, description, permissions, or members no longer fit how your team uses it. To edit a user group:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Locate the group in the list, and select Edit.
- Make your changes.
- Select Update group.
Delete a user group
Delete a group when nobody needs its access anymore. Its members lose the access it granted, unless another group also grants that access. Deleting a group doesn’t remove any dataset or environment restrictions. To delete a user group:- Select Account from the navigation menu, and choose Team Settings.
- Select the User Groups view.
- Locate the group in the list, and select Delete.
- In the Delete user group? dialog, enter the group’s name to confirm.
- Select Delete group.
Troubleshooting
When access doesn’t match what you set up, check these common causes.A group member can’t read a dataset I granted access to
Group access is set separately for each environment, so start with the environment that holds the dataset.- If the group uses Custom, check that the dataset appears in the Allowed restricted datasets column for that environment.
- If someone changed Environment access for that environment, the group’s Dataset access was cleared. Set it again, and select Update group.
- If you set Dataset access to Allow all while the environment had no restricted datasets, Honeycomb saved no access, because there was nothing to grant. Edit the group, select Allow all again, and select Update group.
A restricted user can still get restricted data
Some access paths don’t depend on a person’s user groups.- Configuration Keys aren’t subject to dataset restrictions, so anyone with a key can read every dataset its permissions cover. Honeycomb hides an environment’s keys from people who can’t read every dataset in it, and hides team-wide keys from people who can’t read every dataset on the team.
- Some downloads, Canvas investigations, Findings, and Honeycomb MCP tools don’t check dataset restrictions. For the list, visit Limits and known limitations.