Datadog Role Permissions

After creating a role, assign or remove permissions to this role directly by updating the role in Datadog, or through the Datadog Permission API. Find below a list of available permissions.

Overview

General permissions

General permissions provide the base level of access for your role. Advanced Permissions are explicitly defined permissions that augment the base permissions.

NameDescriptionScopable
adminDeprecated. Privileged Access (also known as Admin permission) has been replaced by more specific permissions: Access Management, Org Management, Billing Read/Write, Usage Read/Write.false
standardView and edit components in your Datadog organization that do not have explicitly defined permissions. This includes configuring some integrations (from the UI), events, most facets, and saved views. In order to configure integrations from the UI, a user must also have Integrations API.false

Note: There is no read-only permission as it is defined by the lack of the standard permission for a role.

Advanced permissions

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 can read all data types. Admin and Standard users have write permissions on assets.

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 in order to enforce the new role permissions.

In addition to the general permissions, you can define more granular permissions for specific assets or data types. Permissions can be either global or scoped to a subset of elements. Find below the details of these options and the impact they have on each available permission.

API and Application Keys

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

NameDescriptionScopable
user_app_keysView and manage Application Keys owned by the user.false
org_app_keys_readView Application Keys owned by all users in the organization.false
org_app_keys_writeManage Application Keys owned by all users in the organization.false
api_keys_readList and retrieve the key values of all API Keys in your organization.false
api_keys_writeCreate, rename, and revoke API Keys for your organization.false

APM

Find below the list of permissions for the apm assets:

NameDescriptionScopable
apm_readRead and query APM and Trace Analytics.false
apm_retention_filter_readRead trace retention filters. A user with this permission can view the retention filters page, list of filters, their statistics, and creation info.false
apm_retention_filter_writeCreate, edit, and delete trace retention filters. A user with this permission can create new retention filters, and update or delete to existing retention filters.false
apm_service_ingest_readAccess service ingestion pages. A user with this permission can view the service ingestion page, list of root services, their statistics, and creation info.false
apm_service_ingest_writeEdit 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.false
apm_apdex_manage_writeSet Apdex T value on any service. A user with this permission can set the T value from the Apdex graph on the service page.false
apm_tag_management_writeEdit second primary tag selection. A user with this permission can modify the second primary tag dropdown in the APM settings page.false
apm_primary_operation_writeEdit 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.false
apm_generate_metricsCreate custom metrics from spans.false
apm_pipelines_writeAdd and change APM pipeline configurations.false
apm_pipelines_readView APM pipeline configurations.false

Access Management

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

NameDescriptionScopable
user_access_inviteInvite other users to your organization.false
user_access_manageDisable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.false
service_account_writeCreate, disable, and use Service Accounts in your organization.false
org_managementEdit 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.false

Billing and Usage

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

NameDescriptionScopable
billing_readView your organization's subscription and payment method but not make edits.false
billing_editManage your organization's subscription and payment method.false
usage_readView your organization's usage and usage attribution.false
usage_editManage your organization's usage attribution set-up.false
usage_notifications_readReceive notifications and view currently configured notification settings.false
usage_notifications_writeReceive notifications and configure notification settings.false

Cloud Security Platform

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

NameDescriptionScopable
security_monitoring_rules_readRead Detection Rules.false
security_monitoring_rules_writeCreate and edit Detection Rules.false
security_monitoring_signals_readView Security Signals.false
security_monitoring_signals_writeModify Security Signals.false
security_monitoring_filters_readRead Security Filters.false
security_monitoring_filters_writeCreate, edit, and delete Security Filters.false
appsec_event_rule_readView Application Security Event Rules.false
appsec_event_rule_writeEdit Application Security Event Rules.false
security_monitoring_notification_profiles_readRead Notification Rules.false
security_monitoring_notification_profiles_writeCreate, edit, and delete Notification Rules.false

Compliance

Find below the list of permissions for the compliance assets:

NameDescriptionScopable
audit_logs_readView Audit Trail in your organization.false
audit_logs_writeConfigure Audit Trail in your organization.false
data_scanner_readView Data Scanner configurations.false
data_scanner_writeEdit Data Scanner configurations.false

Dashboards

Find below the list of permissions for the dashboards assets:

NameDescriptionScopable
dashboards_readView dashboards.false
dashboards_writeCreate and change dashboards.false
dashboards_public_shareGenerate public and authenticated links to share dashboards externally.false
generate_dashboard_reportsSchedule custom reports from a dashboard (available in beta). These reports will display any viewable data regardless of any granular restrictions (restriction queries, scoped indexes) applied to the report's creator.false

Incidents

Find below the list of permissions for the incidents assets:

NameDescriptionScopable
incident_readView incidents in Datadog.false
incident_writeCreate, view, and manage incidents in Datadog.false
incident_settings_readView Incidents settings.false
incident_settings_writeConfigure Incidents settings.false
incidents_private_global_accessAccess all private incidents in Datadog, even when not added as a responder.false

Integrations

Find below the list of permissions for the integrations assets:

NameDescriptionScopable
integrations_apiUse the Integrations APIs to configure integrations. In order to configure integrations from the UI, a user must also have Standard Access.false

Log Management

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

NameDescriptionScopable
logs_modify_indexesRead 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.false
logs_write_exclusion_filtersAdd 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.true
logs_write_pipelinesAdd and change log pipeline configurations, including the ability to grant the Logs Write Processors permission to other roles, for some or all pipelines.false
logs_write_processorsAdd 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.true
logs_write_archivesAdd and edit Log Archives.false
logs_generate_metricsCreate custom metrics from logs.false
logs_read_dataRead 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.true
logs_read_archivesRead Log Archives location and use it for rehydration.true
logs_write_historical_viewRehydrate logs from Archives.false
logs_write_facetsCreate or edit Log Facets.false

Metrics

Find below the list of permissions for the metrics assets:

NameDescriptionScopable
metric_tags_writeEdit and save tag configurations for custom metrics.false

Monitors

Find below the list of permissions for the monitors assets:

NameDescriptionScopable
monitors_readView monitors.false
monitors_writeEdit, mute, and delete individual monitors.false
monitors_downtimeSet downtimes to suppress alerts from any monitor in an organization. The ability to write monitors is not required to set downtimes.false

Notebooks

Find below the list of permissions for the notebooks assets:

NameDescriptionScopable
notebooks_readView notebooks.false
notebooks_writeCreate and change notebooks.false

Observability Pipelines

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

NameDescriptionScopable
observability_pipelines_readView pipeline configurations.false
observability_pipelines_writeCreate, edit, and delete pipeline configurations.false

Real User Monitoring

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

NameDescriptionScopable
rum_apps_writeCreate, edit, and delete RUM Applications.false
rum_apps_readView RUM Applications data.false
rum_session_replay_readView Session Replays.false
rum_generate_metricsCreate custom metrics from RUM events.false

Service Level Objectives

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

NameDescriptionScopable
slos_readView SLOs and status corrections.false
slos_writeCreate, edit, and delete SLOs.false
slos_correctionsApply, 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.false

Synthetic Monitoring

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

NameDescriptionScopable
synthetics_private_location_readView, search, and use in tests the list of available private locations.false
synthetics_private_location_writeCreate and delete private locations as well as seeing the associated installation guidelines.false
synthetics_global_variable_readView, search, and use in tests the list of global variables available for Synthetics.false
synthetics_global_variable_writeCreate, edit, and delete global variables for Synthetics.false
synthetics_readList and view configured Synthetic tests.false
synthetics_writeCreate, edit, and delete Synthetic tests.false
synthetics_default_settings_readView default settings for Synthetics Monitoring.false
synthetics_default_settings_writeEdit default settings for Synthetics Monitoring.false

Logs

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.

NameDescriptionScopable

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

NameDescriptionScopable
logs_live_tailAccess the live tail featurefalse
logs_read_index_dataRead a subset log data (index based)true

Further reading


*Log Rehydration is a trademark of Datadog, Inc.