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.
Sensitive permissions
Some Datadog permissions provide access to more privileged functionality that is important to be aware of, such as:
- Access to change organization settings
- Access to read potentially sensitive data
- Access to perform privileged operations
Sensitive permissions are flagged in the Roles and Permissions interfaces to identify that they may need increased scrutiny. As a best practice, administrators configuring roles should pay special attention to these permissions, and confirm which of these permissions are assigned to their roles and users.
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 Admin 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 |
apm_api_catalog_write | Add, modify, and delete API catalog definitions. | Datadog Standard Role |
apm_api_catalog_read | View API catalog and API definitions. | Datadog Read Only Role |
continuous_profiler_pgo_read | Read and query Continuous Profiler data for Profile-Guided Optimization (PGO). | Datadog Read Only 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 |
org_connections_write | Control which organizations can query your organization's data. | Datadog Admin Role |
org_connections_read | View which organizations can query data from your organization. Query data from other organizations. | Datadog Read Only Role |
App Builder & Workflow Automation
Find below the list of permissions for the app builder & 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 |
apps_run | View and run Apps in App Builder. | Datadog Standard Role |
apps_write | Create, edit, and delete Apps in App Builder. | Datadog Standard Role |
on_prem_runner_read | View and search Private Action Runners for Workflow Automation and App Builder. | Datadog Read Only Role |
on_prem_runner_use | Attach a Private Action Runner to a connection. | Datadog Standard Role |
on_prem_runner_write | Create and edit Private Action Runners for Workflow Automation and App Builder. | Datadog Admin Role |
connection_groups_write | Create, delete and update connection groups. | Datadog Standard Role |
connection_groups_read | Read and use connection groups. | Datadog Read Only 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 |
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 |
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 |
security_monitoring_suppressions_read | Read Rule Suppressions. | Datadog Read Only Role |
security_monitoring_suppressions_write | Write Rule Suppressions. | 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 |
security_pipelines_read | View Security Pipelines. | Datadog Read Only Role |
security_pipelines_write | Create, edit, and delete Security Pipelines. | Datadog Standard 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 Sensitive Data Scanner configurations and scanning results. | Datadog Admin Role |
data_scanner_write | Edit Sensitive Data Scanner configurations. | Datadog Admin Role |
Containers
Find below the list of permissions for the containers assets:
Name | Description | Default Role |
---|
containers_generate_image_metrics | Create or edit trend metrics from container images. | Datadog Standard 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 PDF reports from a dashboard. | Datadog Standard Role |
Error Tracking
Find below the list of permissions for the error tracking assets:
Name | Description | Default Role |
---|
error_tracking_write | Edit Error Tracking issues. | Datadog Standard Role |
error_tracking_settings_write | Disable Error Tracking, edit inclusion filters, and edit rate limit. | Datadog Admin Role |
error_tracking_exclusion_filters_write | Add or change Error Tracking exclusion filters. | Datadog Admin 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 |
agent_upgrade_write | Upgrade Datadog Agents with Fleet Automation. | Datadog Admin Role |
fleet_policies_write | Create Fleet Automation Policies. | Datadog Admin Role |
Integrations
Find below the list of permissions for the integrations assets:
Name | Description | Default Role |
---|
aws_configurations_manage | Add or remove but not edit AWS integration configurations. | Datadog Standard Role |
azure_configurations_manage | Add or remove but not edit Azure integration configurations. | Datadog Standard Role |
gcp_configurations_manage | Add or remove but not edit GCP integration configurations. | Datadog Standard Role |
manage_integrations | Install, uninstall, and configure integrations. | Datadog Standard Role |
integrations_read | View integrations and their configurations. | Datadog Standard Role |
oci_configurations_manage | Add or remove but not edit Oracle Cloud integration configurations. | Datadog Standard Role |
aws_configuration_read | View but not add, remove, or edit AWS integration configurations. | Datadog Standard Role |
azure_configuration_read | View but not add, remove, or edit Azure integration configurations. | Datadog Standard Role |
gcp_configuration_read | View but not add, remove, or edit GCP integration configurations. | Datadog Standard Role |
oci_configuration_read | View but not add, remove, or edit Oracle Cloud integration configurations. | Datadog Standard Role |
aws_configuration_edit | Edit but not add or remove AWS integration configurations. | Datadog Standard Role |
azure_configuration_edit | Edit but not add or remove Azure integration configurations. | Datadog Standard Role |
gcp_configuration_edit | Edit but not add or remove GCP integration configurations. | Datadog Standard Role |
oci_configuration_edit | Edit but not add or remove Oracle Cloud integration configurations. | Datadog Standard Role |
LLM Observability
Find below the list of permissions for the llm observability assets:
Name | Description | Default Role |
---|
llm_observability_read | View LLM Observability. | Datadog Read Only 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 |
flex_logs_config_write | Manage your organization's flex logs configuration. | Datadog Admin Role |
Log Management RBAC also includes two legacy permissions, superseded by finer-grained and more extensive logs_read_data
permission:
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 monitors. 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 |
Network Device Monitoring
Find below the list of permissions for the network device monitoring assets:
Name | Description | Default Role |
---|
ndm_netflow_port_mappings_write | Write NDM Netflow port mappings. | Datadog Standard 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 |
Orchestration
Find below the list of permissions for the orchestration assets:
Name | Description | Default Role |
---|
orchestration_custom_resource_definitions_write | Enable, disable and update custom resource indexing. | Datadog Standard Role |
orchestration_workload_scaling_write | Enable, disable, and configure workload autoscaling. Apply workload scaling recommendations. | 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 |
rum_extend_retention | Extend the retention of Session Replays. | Datadog Admin 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 |
reference_tables_read | View Reference Tables. | Datadog Read Only 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 |
Software Delivery
Find below the list of permissions for the software delivery 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 |
static_analysis_settings_write | Edit Static Analysis settings. | Datadog Admin Role |
cd_visibility_read | View CD Visibility. | Datadog Read Only Role |
dora_settings_write | Edit the settings for DORA. | Datadog Standard Role |
code_analysis_read | View Code Analysis. | Datadog Read Only Role |
quality_gates_evaluations_read | Allow quality gates evaluations. | Datadog Read Only 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 |
Further reading
Additional helpful documentation, links, and articles:
*Log Rehydration is a trademark of Datadog, Inc.