Datadog Role Permissions

Docs > Account Management > Access Control > Datadog Role Permissions

Overview

Permissions define the type of access a user has to a given resource. Typically, permissions give a user the right to read, edit, or delete an object. Permissions underlie the access rights of all roles, including the three out-of-the-box roles and custom roles.

Out-of-the-box roles

By default, existing users are associated with one of the three out-of-the-box roles:

Datadog Admin
Datadog Standard
Datadog Read Only

All users with one of these roles can read all data types, except for individually read-restricted resources. Admin and Standard users have write permissions on assets. Admin users have additional read and write permissions for sensitive assets relating to user management, org management, billing, and usage.

Custom roles

Create a custom role to combine permissions into new roles. A custom role gives you the ability to define a persona, for example, a billing administrator, and then assign the appropriate permissions for that role. After creating a role, assign or remove permissions to this role directly by updating the role in Datadog, or through the Datadog Permission API.

Note: When adding a new custom role to a user, make sure to remove the out-of-the-box Datadog role associated with that user to enforce the new role permissions.

Permissions list

The following table lists the name, description, and default role for all available permissions in Datadog. Each asset type has corresponding read and write permissions.

Each out-of-the-box role inherits all of the permissions from the less powerful roles. Therefore, the Datadog Standard role has all of the permissions listed in the table with Datadog Read Only as the default role. Additionally, the Datadog Admin role contains all of the permissions from both the Datadog Standard and the Datadog Read Only role.

API and Application Keys

Find below the list of permissions for the api and application keys assets:

Name	Description	Default Role
`user_app_keys`	View and manage Application Keys owned by the user.	Datadog Standard Role
`org_app_keys_read`	View Application Keys owned by all users in the organization.	Datadog Standard Role
`org_app_keys_write`	Manage Application Keys owned by all users in the organization.	Datadog Admin Role
`api_keys_read`	List and retrieve the key values of all API Keys in your organization.	Datadog Standard Role
`api_keys_write`	Create and rename API Keys for your organization.	Datadog Admin Role
`client_tokens_read`	Read Client Tokens. Unlike API keys, client tokens may be exposed client-side in JavaScript code for web browsers and other clients to send data to Datadog.	Datadog Read Only Role
`client_tokens_write`	Create and edit Client Tokens. Unlike API keys, client tokens may be exposed client-side in JavaScript code for web browsers and other clients to send data to Datadog.	Datadog Standard Role
`api_keys_delete`	Delete API Keys for your organization.	Datadog Admin Role

APM

Find below the list of permissions for the apm assets:

Name	Description	Default Role
`apm_read`	Read and query APM and Trace Analytics.	Datadog Read Only Role
`apm_retention_filter_read`	Read trace retention filters. A user with this permission can view the retention filters page, list of filters, their statistics, and creation info.	Datadog Read Only Role
`apm_retention_filter_write`	Create, edit, and delete trace retention filters. A user with this permission can create new retention filters, and update or delete to existing retention filters.	Datadog Admin Role
`apm_service_ingest_read`	Access service ingestion pages. A user with this permission can view the service ingestion page, list of root services, their statistics, and creation info.	Datadog Read Only Role
`apm_service_ingest_write`	Edit service ingestion pages' root services. A user with this permission can edit the root service ingestion and generate a code snippet to increase ingestion per service.	Datadog Admin Role
`apm_apdex_manage_write`	Set Apdex T value on any service. A user with this permission can set the T value from the Apdex graph on the service page.	Datadog Admin Role
`apm_tag_management_write`	Edit second primary tag selection. A user with this permission can modify the second primary tag dropdown in the APM settings page.	Datadog Standard Role
`apm_primary_operation_write`	Edit the operation name value selection. A user with this permission can modify the operation name list in the APM settings page and the operation name controller on the service page.	Datadog Standard Role
`debugger_write`	Edit Dynamic Instrumentation configuration. Create or modify Dynamic Instrumentation probes that do not capture function state.	Datadog Admin Role
`debugger_read`	View Dynamic Instrumentation configuration.	Datadog Read Only Role
`apm_generate_metrics`	Create custom metrics from spans.	Datadog Standard Role
`apm_pipelines_write`	Add and change APM pipeline configurations.	Datadog Admin Role
`apm_pipelines_read`	View APM pipeline configurations.	Datadog Read Only Role
`apm_service_catalog_write`	Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.	Datadog Standard Role
`apm_service_catalog_read`	View service catalog and service definitions.	Datadog Read Only Role
`apm_remote_configuration_write`	Edit APM Remote Configuration.	Datadog Admin Role
`apm_remote_configuration_read`	View APM Remote Configuration.	Datadog Standard Role
`continuous_profiler_read`	View data in Continuous Profiler.	Datadog Read Only Role
`debugger_capture_variables`	Create or modify Dynamic Instrumentation probes that capture function state: local variables, method arguments, fields, and return value or thrown exception.	Datadog Admin Role

Access Management

Find below the list of permissions for the access management assets:

Name	Description	Default Role
`user_access_invite`	Invite other users to your organization.	Datadog Standard Role
`user_access_manage`	Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.	Datadog Admin Role
`service_account_write`	Create, disable, and use Service Accounts in your organization.	Datadog Admin Role
`org_management`	Edit org configurations, including authentication and certain security preferences such as configuring SAML, renaming an org, configuring allowed login methods, creating child orgs, subscribing & unsubscribing from apps in the marketplace, and enabling & disabling Remote Configuration for the entire organization.	Datadog Admin Role

Billing and Usage

Find below the list of permissions for the billing and usage assets:

Name	Description	Default Role
`billing_read`	View your organization's subscription and payment method but not make edits.	Datadog Admin Role
`billing_edit`	Manage your organization's subscription and payment method.	Datadog Admin Role
`usage_read`	View your organization's usage and usage attribution.	Datadog Admin Role
`usage_edit`	Manage your organization's usage attribution set-up.	Datadog Admin Role
`usage_notifications_read`	Receive notifications and view currently configured notification settings.	Datadog Admin Role
`usage_notifications_write`	Receive notifications and configure notification settings.	Datadog Admin Role

CI Visibility

Find below the list of permissions for the ci visibility assets:

Name	Description	Default Role
`ci_visibility_read`	View CI Visibility.	Datadog Read Only Role
`ci_visibility_write`	Edit flaky tests and delete Test Services.	Datadog Standard Role
`ci_provider_settings_write`	Edit CI Provider settings. Manage GitHub accounts and repositories for enabling CI Visibility and job logs collection.	Datadog Admin Role
`ci_visibility_settings_write`	Configure CI Visibility settings. Set a repository default branch, enable GitHub comments, and delete test services.	Datadog Standard Role
`intelligent_test_runner_activation_write`	Enable or disable Intelligent Test Runner.	Datadog Admin Role
`intelligent_test_runner_settings_write`	Edit Intelligent Test Runner settings, such as modifying ITR excluded branch list.	Datadog Standard Role
`ci_ingestion_control_write`	Edit CI Ingestion Control exclusion filters.	Datadog Admin Role
`ci_visibility_pipelines_write`	Create CI Visibility pipeline spans using the API.	Datadog Standard Role
`quality_gate_rules_read`	View Quality Gate Rules.	Datadog Read Only Role
`quality_gate_rules_write`	Edit Quality Gate Rules.	Datadog Admin Role

Case and Incident Management

Find below the list of permissions for the case and incident management assets:

Name	Description	Default Role
`incident_read`	View incidents in Datadog.	Datadog Read Only Role
`incident_write`	Create, view, and manage incidents in Datadog.	Datadog Standard Role
`incident_settings_read`	View Incident Settings.	Datadog Standard Role
`incident_settings_write`	Configure Incident Settings.	Datadog Standard Role
`incidents_private_global_access`	Access all private incidents in Datadog, even when not added as a responder.	None
`cases_read`	View Cases.	Datadog Read Only Role
`cases_write`	Create and update cases.	Datadog Standard Role
`incident_notification_settings_read`	View Incidents Notification settings.	Datadog Standard Role
`incident_notification_settings_write`	Configure Incidents Notification settings.	Datadog Standard Role

Cloud Cost Management

Find below the list of permissions for the cloud cost management assets:

Name	Description	Default Role
`cloud_cost_management_read`	View Cloud Cost pages. This does not restrict access to the cloud cost data source in dashboards and notebooks.	Datadog Read Only Role
`cloud_cost_management_write`	Configure cloud cost accounts and global customizations.	Datadog Standard Role

Cloud Security Platform

Find below the list of permissions for the cloud security platform assets:

Name	Description	Default Role
`security_monitoring_rules_read`	Read Detection Rules.	Datadog Read Only Role
`security_monitoring_rules_write`	Create and edit Detection Rules.	Datadog Standard Role
`security_monitoring_signals_read`	View Security Signals.	Datadog Read Only Role
`security_monitoring_signals_write`	Modify Security Signals.	Datadog Standard Role
`security_monitoring_filters_read`	Read Security Filters.	Datadog Read Only Role
`security_monitoring_filters_write`	Create, edit, and delete Security Filters.	Datadog Admin Role
`appsec_event_rule_read`	View Application Security Management Event Rules.	Datadog Read Only Role
`appsec_event_rule_write`	Edit Application Security Management Event Rules.	Datadog Standard Role
`security_monitoring_notification_profiles_read`	Read Notification Rules.	Datadog Read Only Role
`security_monitoring_notification_profiles_write`	Create, edit, and delete Notification Rules.	Datadog Standard Role
`security_monitoring_cws_agent_rules_read`	Read Cloud Workload Security Agent Rules.	Datadog Read Only Role
`security_monitoring_cws_agent_rules_write`	Create, edit, and delete Cloud Workload Security Agent Rules.	Datadog Standard Role
`appsec_protect_read`	View blocked attackers.	Datadog Read Only Role
`appsec_protect_write`	Manage blocked attackers.	Datadog Standard Role
`appsec_activation_read`	View whether Application Security Management has been enabled or disabled on services via 1-click enablement with Remote Configuration.	Datadog Read Only Role
`appsec_activation_write`	Enable or disable Application Security Management on services via 1-click enablement.	Datadog Standard Role
`security_monitoring_findings_read`	View CSPM Findings.	Datadog Standard Role
`security_monitoring_findings_write`	Mute CSPM Findings.	Datadog Standard Role
`appsec_vm_write`	Update status or assignee of vulnerabilities.	Datadog Standard Role
`appsec_vm_read`	View vulnerabilities. This does not restrict access to the vulnerability data source through the API or inventory SQL.	Datadog Read Only Role

Compliance

Find below the list of permissions for the compliance assets:

Name	Description	Default Role
`audit_logs_read`	View Audit Trail in your organization.	Datadog Admin Role
`audit_logs_write`	Configure Audit Trail in your organization.	Datadog Admin Role
`data_scanner_read`	View Data Scanner configurations.	Datadog Admin Role
`data_scanner_write`	Edit Data Scanner configurations.	Datadog Admin Role

Cross-Product Features

Find below the list of permissions for the cross-product features assets:

Name	Description	Default Role
`saved_views_write`	Modify Saved Views across all Datadog products.	Datadog Standard Role
`facets_write`	Manage facets for products other than Log Management, such as APM Traces. To modify Log Facets, use Logs Write Facets.	Datadog Standard Role

Dashboards

Find below the list of permissions for the dashboards assets:

Name	Description	Default Role
`dashboards_read`	View dashboards.	Datadog Read Only Role
`dashboards_write`	Create and change dashboards.	Datadog Standard Role
`dashboards_public_share`	Generate public and authenticated links to share dashboards or embeddable graphs externally.	Datadog Standard Role
`generate_dashboard_reports`	Schedule custom reports from a dashboard. These reports will display any viewable data regardless of any granular restrictions (restriction queries, scoped indexes) applied to the report's creator.	Datadog Admin Role

Error Tracking

Find below the list of permissions for the error tracking assets:

Name	Description	Default Role
`error_tracking_write`	Edit Error Tracking settings.	Datadog Standard Role

Events

Find below the list of permissions for the events assets:

Name	Description	Default Role
`event_correlation_config_read`	Read Event Correlation Configuration data such as Correlation Rules and Settings.	Datadog Standard Role
`event_correlation_config_write`	Manage Event Correlation Configuration such as Correlation Rules and Settings.	Datadog Standard Role
`event_config_write`	Manage general event configuration such as API Emails.	Datadog Standard Role

Fleet Automation

Find below the list of permissions for the fleet automation assets:

Name	Description	Default Role
`agent_flare_collection`	Collect an Agent flare with Fleet Automation.	Datadog Standard Role

Integrations

Find below the list of permissions for the integrations assets:

Name	Description	Default Role
`manage_integrations`	Install, uninstall, and configure integrations.	Datadog Standard Role

Log Management

Find below the list of permissions for the log configuration assets and log data, along with the typical category of user you’d assign this permission to. See the recommendations on how to assign permissions to team members in the Logs RBAC guide.

Name	Description	Default Role
`logs_modify_indexes`	Read and modify all indexes in your account. This includes the ability to grant the Logs Read Index Data and Logs Write Exclusion Filters permission to other roles, for some or all indexes.	Datadog Standard Role
`logs_write_exclusion_filters`	Add and change exclusion filters for all or some log indexes. Can be granted in a limited capacity per index to specific roles via the Logs interface or API. If granted from the Roles interface or API, the permission has global scope.	Datadog Standard Role
`logs_write_pipelines`	Add and change log pipeline configurations, including the ability to grant the Logs Write Processors permission to other roles, for some or all pipelines.	Datadog Standard Role
`logs_write_processors`	Add and change some or all log processor configurations. Can be granted in a limited capacity per pipeline to specific roles via the Logs interface or API. If granted via the Roles interface or API the permission has global scope.	Datadog Standard Role
`logs_write_archives`	Add and edit Log Archives.	Datadog Admin Role
`logs_generate_metrics`	Create custom metrics from logs.	Datadog Standard Role
`logs_read_data`	Read log data. In order to read log data, a user must have both this permission and Logs Read Index Data. This permission can be restricted with restriction queries. Restrictions are limited to the Log Management product.	Datadog Read Only Role
`logs_read_archives`	Read Log Archives location and use it for rehydration.	Datadog Read Only Role
`logs_write_historical_view`	Rehydrate logs from Archives.	Datadog Standard Role
`logs_write_facets`	Create or edit Log Facets.	Datadog Standard Role
`logs_delete_data`	Delete data from your Logs, including entire indexes.	Datadog Admin Role
`logs_write_forwarding_rules`	Add and edit forwarding destinations and rules for logs.	Datadog Admin Role

Log Management RBAC also includes two legacy permissions, superseded by finer-grained and more extensive logs_read_data permission:

Name	Description	Default Role
`logs_live_tail`	Access the live tail feature	Datadog Read Only Role
`logs_read_index_data`	Read a subset log data (index based)	Datadog Read Only Role

Metrics

Find below the list of permissions for the metrics assets:

Name	Description	Default Role
`metric_tags_write`	Edit and save tag configurations for custom metrics.	Datadog Standard Role
`host_tags_write`	Add and change tags on hosts.	Datadog Standard Role
`metrics_metadata_write`	Edit metadata on metrics.	Datadog Standard Role

Monitors

Find below the list of permissions for the monitors assets:

Name	Description	Default Role
`monitors_read`	View monitors.	Datadog Read Only Role
`monitors_write`	Edit and delete individual monitors.	Datadog Standard Role
`monitors_downtime`	Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes.	Datadog Standard Role
`monitor_config_policy_write`	Create, update, and delete monitor configuration policies.	Datadog Admin Role

Notebooks

Find below the list of permissions for the notebooks assets:

Name	Description	Default Role
`notebooks_read`	View notebooks.	Datadog Read Only Role
`notebooks_write`	Create and change notebooks.	Datadog Standard Role

Observability Pipelines

Find below the list of permissions for the observability pipelines assets:

Name	Description	Default Role
`observability_pipelines_read`	View pipelines in your organization.	Datadog Read Only Role
`observability_pipelines_write`	Edit pipelines in your organization.	Datadog Standard Role
`observability_pipelines_delete`	Delete pipelines from your organization.	Datadog Admin Role
`observability_pipelines_deploy`	Deploy pipelines in your organization.	Datadog Admin Role

Processes

Find below the list of permissions for the processes assets:

Name	Description	Default Role
`processes_generate_metrics`	Create custom metrics from processes.	Datadog Standard Role

Real User Monitoring

Find below the list of permissions for the real user monitoring assets:

Name	Description	Default Role
`rum_apps_write`	Create, edit, and delete RUM applications. Creating a RUM application automatically generates a Client Token. In order to create Client Tokens directly, a user needs the Client Tokens Write permission.	Datadog Standard Role
`rum_apps_read`	View RUM Applications data.	Datadog Read Only Role
`rum_session_replay_read`	View Session Replays.	Datadog Read Only Role
`rum_generate_metrics`	Create custom metrics from RUM events.	Datadog Standard Role
`rum_delete_data`	Delete data from RUM.	Datadog Admin Role
`rum_playlist_write`	Create, update, and delete RUM playlists. Add and remove sessions from RUM playlists.	Datadog Standard Role

Reference Tables

Find below the list of permissions for the reference tables assets:

Name	Description	Default Role
`reference_tables_write`	Create or modify Reference Tables.	Datadog Standard Role

Service Level Objectives

Find below the list of permissions for the service level objectives assets:

Name	Description	Default Role
`slos_read`	View SLOs and status corrections.	Datadog Read Only Role
`slos_write`	Create, edit, and delete SLOs.	Datadog Standard Role
`slos_corrections`	Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.	Datadog Standard Role

Synthetic Monitoring

Find below the list of permissions for the synthetic monitoring assets:

Name	Description	Default Role
`synthetics_private_location_read`	View, search, and use Synthetics private locations.	Datadog Standard Role
`synthetics_private_location_write`	Create and delete private locations in addition to having access to the associated installation guidelines.	Datadog Admin Role
`synthetics_global_variable_read`	View, search, and use Synthetics global variables.	Datadog Standard Role
`synthetics_global_variable_write`	Create, edit, and delete global variables for Synthetics.	Datadog Standard Role
`synthetics_read`	List and view configured Synthetic tests and test results.	Datadog Read Only Role
`synthetics_write`	Create, edit, and delete Synthetic tests.	Datadog Standard Role
`synthetics_default_settings_read`	View the default settings for Synthetic Monitoring.	Datadog Standard Role
`synthetics_default_settings_write`	Edit the default settings for Synthetic Monitoring.	Datadog Standard Role

Teams

Find below the list of permissions for the teams assets:

Name	Description	Default Role
`teams_manage`	Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.	Datadog Standard Role

Watchdog

Find below the list of permissions for the watchdog assets:

Name	Description	Default Role
`watchdog_alerts_write`	Manage Watchdog Alerts.	Datadog Standard Role

Workflow Automation

Find below the list of permissions for the workflow automation assets:

Name	Description	Default Role
`workflows_read`	View workflows.	Datadog Read Only Role
`workflows_write`	Create, edit, and delete workflows.	Datadog Standard Role
`workflows_run`	Run workflows.	Datadog Standard Role
`connections_read`	List and view available connections. Connections contain secrets that cannot be revealed.	Datadog Read Only Role
`connections_write`	Create and delete connections.	Datadog Standard Role
`connections_resolve`	Resolve connections.	Datadog Standard Role