- Who can manage it: change its configuration and credentials, edit its access settings, or delete it.
- Who can query it: ask questions of it through the agent or MCP.
Who can manage a data source
Managing telemetry data sources requires the Manage telemetry data sources permission. By default this is granted to Admins and Owners, and you can grant it to other roles at Settings → Permissions → Account-level. Anyone who holds it account-wide can manage every data source. You can also hand management of a specific data source to the teams that own it:- Assign one or more managing teams on the data source (see Configuring access below).
- Create a team role granting the Manage telemetry data sources permission at Settings → Permissions → Team-level.
Who can query a data source
Every data source is in one of two query modes:- Anyone: anyone who can query telemetry can query this data source. This is the default, and querying telemetry is part of the View telemetry permission that all users hold out of the box.
- Restricted: only people with the Query restricted telemetry permission can query it. You can grant that permission account-wide through a role, or to specific teams by choosing query teams on the data source and granting the permission through a team role.
Investigations always have access. An investigation runs as the system, not as any one user, so restricting a data
source doesn’t stop investigations from querying it to diagnose an incident. The access settings show this alongside
your chosen teams and roles.
Configuring access
Open your telemetry settings, select a data source, and click Update in the Access section. From the drawer you can:- Choose teams that manage this data source. These teams can edit the data source, including its access settings.
- Choose who can query this data source: Anyone, or Restricted.
- Choose teams with query access, when restricted. Managing teams are always included and can’t be removed.
The team settings only appear if your plan includes team roles. The restricted query mode works on its own: you can
restrict a data source and control access purely through account-level roles.
Permissions reference
For API access, the equivalent API key permissions are Query restricted telemetry and Update telemetry data sources, both of which can be scoped to teams.
Audit log
On plans with audit logs, what happens to each telemetry data source is recorded alongside your other configuration changes:- Connection changes: connecting or removing a data source, and granting or revoking write access.
- Access changes: marking a data source restricted, or moving it back to open querying.
- Queries: who queried which data source, one entry per session per data source, plus a complete record with one entry per request we send.
- Denied queries: attempts against a restricted data source by someone without access, one entry per attempt, so you can see who tried to access what.
Related
Team roles
How team-based permissions work across incident.io.
User roles and permissions
Base roles, custom roles, and granting permissions.