• Home
  • Manage
  • Dynatrace Configuration as Code
  • Dynatrace Configuration as Code via Monaco
  • Reference
  • Configuration types and access permissions

Configuration types and access permissions

Dynatrace Configuration as Code via Monaco (the Dynatrace Monaco CLI) supports the following configuration types:

  • All Settings 2.0
  • Most Configuration APIs
  • Dynatrace Platform Automation API

For details on how to define configuration types, see YAML configuration.

Settings 2.0

This type of configuration is available on the latest Dynatrace Platform and previous Dynatrace environments.

Configuration requires an API access token.

The Dynatrace Monaco CLI provides general support for any Settings 2.0 schema available in your environment.

  • For details on Settings 2.0 schemas, see Settings 2.0 - Available schemas.

  • To configure Settings 2.0 settings, your access token requires the following permissions:

    • Read settings (settings.read)
    • Write settings (settings.write)

Supported configuration API types

This type of configuration is available for the latest Dynatrace Platform and previous Dynatrace environments.

Note that most configuration APIs are deprecated in favor of Settings 2.0.

Configuration requires an API access token.

The Dynatrace Monaco CLI provides support for most Configuration APIs.

  • The supported configuration types, their API endpoints, and the access token permissions required for interacting with any endpoint are listed below.

  • If there's a link in the Configuration type column, be sure to follow it for important additional information about that configuration type.

Configuration typeEndpointAccess token permissions
alerting-profile
Non-Unique Name Configuration
Alerting profiles API - POST a profile
/api/config/v1/alertingProfiles
Read Configuration and Write Configuration
allowed-beacon-origins
Single Configuration Endpoint
Allowed beacon domains API - PUT configuration
/api/config/v1/allowedBeaconOriginsForCors
Read Configuration and Write Configuration
anomaly-detection-applications
Single Configuration Endpoint
Application anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/applications
Read Configuration and Write Configuration
anomaly-detection-aws
Single Configuration Endpoint
AWS anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/aws
Read Configuration and Write Configuration
anomaly-detection-database-services
Single Configuration Endpoint
Database anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/databaseServices
Read Configuration and Write Configuration
anomaly-detection-disksDisk events anomaly detection API - POST an event
/api/config/v1/anomalyDetection/diskEvents
Read Configuration and Write Configuration
anomaly-detection-hosts
Single Configuration Endpoint
Host anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/hosts
Read Configuration and Write Configuration
anomaly-detection-metrics
Non-Unique Name Configuration
Metric events anomaly detection API - POST an event
/api/config/v1/anomalyDetection/metricEvents
Read Configuration and Write Configuration
anomaly-detection-services
Single Configuration Endpoint
Services anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/services
Read Configuration and Write Configuration
anomaly-detection-vmware
Single Configuration Endpoint
VMware anomaly detection API - PUT configuration
/api/config/v1/anomalyDetection/applications
Read Configuration and Write Configuration
app-detection-rule
Non-Unique Name Configuration
Applications detection rules API - POST a rule
/api/config/v1/applicationDetectionRules
Read Configuration and Write Configuration
app-detection-rule-host
Single Configuration Endpoint
Applications detection rules API - PUT host detection headers
/api/config/v1/applicationDetectionRules/hostDetection
Read Configuration and Write Configuration
application-web
Non-Unique Name Configuration
Web application configuration API - POST a web application
/api/config/v1/applications/web
Read Configuration and Write Configuration
application-mobileMobile and custom app API - POST an app
/api/config/v1/applications/mobile
Read Configuration and Write Configuration
auto-tagAutomatically applied tags API - POST an auto-tag
/api/config/v1/autoTags
Read Configuration and Write Configuration
aws-credentials
Cannot be downloaded
AWS credentials API - POST new credentials
/api/config/v1/aws/credentials
Read Configuration and Write Configuration
azure-credentials
Cannot be downloaded
Azure credentials API - POST new credentials
/api/config/v1/azure/credentials
Read Configuration and Write Configuration
calculated-metrics-application-mobile
Special Name requirements
Mobile app metrics API - POST a metric
/api/config/v1/calculatedMetrics/mobile
Read Configuration and Write Configuration
calculated-metrics-application-web
Special Name requirements
Mobile app metrics API - POST a metric
/api/config/v1/calculatedMetrics/rum
Read Configuration and Write Configuration
calculated-metrics-log
Special Name requirements
Log Monitoring metrics API - PUT a metric
/api/config/v1/calculatedMetrics/log
Read Configuration and Write Configuration
calculated-metrics-service
Special Name requirements
Service metrics API - POST a metric
/api/config/v1/calculatedMetrics/service
Read Configuration and Write Configuration
calculated-metrics-synthetic
Special Name requirements
Synthetic metrics API - POST a metric
/api/config/v1/calculatedMetrics/synthetic
Read Configuration and Write Configuration
conditional-naming-hostConditional naming API - POST a new naming rule
/api/config/v1/conditionalNaming/host
Read Configuration and Write Configuration
conditional-naming-processgroupConditional naming API - POST a new naming rule
/api/config/v1/conditionalNaming/processGroup
Read Configuration and Write Configuration
conditional-naming-serviceConditional naming API - POST a new naming rule
/api/config/v1/conditionalNaming/service
Read Configuration and Write Configuration
content-resources
Single Configuration Endpoint
Content resources API - PUT configuration
/api/config/v1/contentResources
Read Configuration and Write Configuration
credential-vault
Cannot be downloaded
Credential vault API - POST a set of credentials
/api/config/v1/credentials
Read credential vault entries and Write credential vault entries
custom-service-javaCustom services API - POST a custom service rule
/api/config/v1/service/customServices/java
Read Configuration and Write Configuration
custom-service-dotnetCustom services API - POST a custom service rule
/api/config/v1/service/customServices/dotnet
Read Configuration and Write Configuration
custom-service-goCustom services API - POST a custom service rule
/api/config/v1/service/customServices/go
Read Configuration and Write Configuration
custom-service-nodejsCustom services API - POST a custom service rule
/api/config/v1/service/customServices/nodejs
Read Configuration and Write Configuration
custom-service-phpCustom services API - POST a custom service rule
/api/config/v1/service/customServices/php
Read Configuration and Write Configuration
dashboard
Non-Unique Name Configuration
Dashboards API - POST a dashboard
/api/config/v1/dashboards
Read Configuration and Write Configuration
data-privacy
Single Configuration Endpoint
Data privacy API - PUT configuration
/api/config/v1/dataPrivacy
Read Configuration, DataPrivacy
extension
Cannot be downloaded
Extensions API - POST an extension .zip file
/api/config/v1/extensions
Read Configuration and Write Configuration
extension-elasticsearch
Single Configuration Endpoint
Extensions API - POST an extension .zip file
/api/config/v1/extensions/dynatrace.python.elasticsearch/global
Read Configuration and Write Configuration
failure-detection-parametersetsFailure detection API - POST a parameter set
/api/config/v1/service/failureDetection/parameterSelection/parameterSets
Read Configuration and Write Configuration
failure-detection-rulesFailure detection API - POST a detection rule
/api/config/v1/service/failureDetection/parameterSelection/rules
Read Configuration and Write Configuration
frequent-issue-detection
Single Configuration Endpoint
Frequent issue detection API - PUT configuration
/api/config/v1/frequentIssueDetection
Read Configuration and Write Configuration
geo-ip-address-mappings
Single Configuration Endpoint
IP address mapping rules - PUT configuration
/api/config/v1/geographicRegions/ipAddressMappings
Read Configuration and Write Configuration
geo-ip-detection-headers
Single Configuration Endpoint
IP mapping header rules - PUT configuration
/api/config/v1/geographicRegions/ipDetectionHeaders
Read Configuration and Write Configuration
hosts-auto-update
Single Configuration Endpoint
OneAgent environment-wide configuration API - PUT auto-update configuration
/api/config/v1/hosts/autoupdate
Read Configuration and Write Configuration
kubernetes-credentials
Cannot be downloaded
Kubernetes credentials API - POST new credentials
/api/config/v1/kubernetes/credentials
Read Configuration and Write Configuration
maintenance-windowMaintenance windows API - POST a maintenance window
/api/config/v1/maintenanceWindows
Read Configuration and Write Configuration
management-zoneManagement zones API - POST a management zone
/api/config/v1/managementZones
Read Configuration and Write Configuration
notificationNotifications API - POST a notification configuration
/api/config/v1/notifications
Read Configuration and Write Configuration
reportsReports API - POST a report
/api/config/v1/reports
Read Configuration and Write Configuration
request-attributesRequest attributes API - POST a request attribute
/api/config/v1/service/requestAttributes
Read Configuration and Capture request data
request-naming-service
Non-Unique Name Configuration
Request naming API - POST a new request naming rule
/api/config/v1/service/requestNaming
Read Configuration and Write Configuration
sloService-level objectives API - POST an SLO
/api/v2/slo
Read SLO and Write SLO
service-detection-full-web-requestService detection API - POST a full web request rule
/api/config/v1/service/detectionRules/FULL_WEB_REQUEST
Read Configuration and Write Configuration
service-detection-full-web-serviceService detection API - POST a full web service rule
/api/config/v1/service/detectionRules/FULL_WEB_SERVICE
Read Configuration and Write Configuration
service-detection-opaque-web-requestService detection API - POST an opaque web request rule
/api/config/v1/service/detectionRules/OPAQUE_AND_EXTERNAL_WEB_REQUEST
Read Configuration and Write Configuration
service-detection-opaque-web-serviceService detection API - POST an opaque web service rule
/api/config/v1/service/detectionRules/OPAQUE_AND_EXTERNAL_WEB_SERVICE
Read Configuration and Write Configuration
service-resource-naming
Single Configuration Endpoint
Services configuration API
/api/config/v1/service/resourceNaming
Read Configuration and Write Configuration
synthetic-locationSynthetic locations API - POST a location
/api/v1/synthetic/locations
Access problem and event feed, metrics, and topology and Create and read synthetic monitors, locations, and nodes
synthetic-monitorSynthetic monitors API - POST a monitor
/api/v1/synthetic/monitors
Create and read synthetic monitors, locations, and nodes

For more information about each token permission, see Dynatrace API - Tokens and authentication.

Supported platform API types

Dynatrace Monaco CLI version 2.6.0+

The Dynatrace Monaco CLI provides support for the following Dynatrace platform API types.

To target platform APIs, you need to provide OAuth credentials.

Configuration typeEndpointOAuth client permissions
business-calendars/platform/automation/v1/business-calendarsautomation:calendars:read, automation:calendars:write
scheduling-rules/platform/automation/v1/scheduling-rulesautomation:rules:read, automation:rules:write
workflows/platform/automation/v1/workflowsautomation:workflows:read, automation:workflows:write