Get started with configuration deployment for Monaco

Latest Dynatrace
Getting started guide
2-min read
Published Feb 26, 2026

This guide shows you how to deploy a Dynatrace configuration for Monaco resources.

What will you learn?

You'll learn how to deploy a Dynatrace configuration file and verify your setup.

Before you begin

Prerequisites

Install Monaco and make the executable available in your PATH. The correct permissions depend on which APIs you use. For more info, see the API documentation or IAM policy reference.
Dynatrace environment and permissions to create an authentication token/credentials. For more information on using a Dynatrace trial client, see Dynatrace trial.
Create an platform token with the following permissions:
- slo:slos:read
- slo:slos:write
- slo:objective-templates:read

Get started with deploying a Dynatrace configuration

To deploy the Dynatrace configuration, follow the steps below.

Deploy a new configuration with Monaco

To deploy a Dynatrace configuration, you need to have the respective config.yaml, template.json, and manifest.yaml files in place. If you don't have them yet, see Get started with Dynatrace configuration for Monaco.

To apply your configuration with the monaco deploy command, provide the name of the deployment file as an argument.

Run the following command.

monaco deploy manifest.yaml

Expected result

A successful deployment will return output similar to that shown in the code block below.

time=2025-09-01T09:08:23.506+02:00 level=INFO msg="Monaco version 2.24.0"
time=2025-09-01T09:08:23.507+02:00 level=INFO msg="Loading manifest \"{your full path to the file}\manifest.yaml\". Restrictions: groups=[], environments=[]" manifestPath="{your full path to the file}\manifest.yaml"
time=2025-09-01T09:08:23.535+02:00 level=INFO msg="Projects to be deployed (1):"
time=2025-09-01T09:08:23.536+02:00 level=INFO msg="  - my-slo-project"
time=2025-09-01T09:08:23.536+02:00 level=INFO msg="Environments to deploy to (1):"
time=2025-09-01T09:08:23.537+02:00 level=INFO msg="  - development-environment"
time=2025-09-01T09:08:23.537+02:00 level=INFO msg="Deploying configurations to environment \"development-environment\"..." environment.name=default environment.group=group
time=2025-09-01T09:08:23.556+02:00 level=INFO msg="Deploying config" deploymentStatus=deploying environment.name=development-environment environment.group=group coordinate.reference=my-slo-project:slo-v2:my-sample-slo coordinate.project=my-slo-project coordinate.type=slo-v2 coordinate.configId=my-sample-slo gid=0
time=2025-09-01T09:08:23.557+02:00 level=INFO msg="Deployment successful" deploymentStatus=deployed environment.name=development-environment environment.group=group coordinate.reference=my-slo-project:slo:my-sample-slo coordinate.project=my-slo-project coordinate.type=slo-v2 coordinate.configId=my-sample-slo gid=0
time=2025-09-01T09:08:23.557+02:00 level=INFO msg="Deployment successful for environment 'development-environment'" environment.group=group environment.name=development-environment environment.name=development-environment environment.group=group
time=2025-09-01T09:08:23.557+02:00 level=INFO msg="Deployment finished without errors"

If your configuration fails to deploy, refer to the error description in the output. Your files may contain syntax errors, or your platform token may require additional permissions.

To verify that your Dynatrace configuration was created in your Dynatrace environment:

Log in to your Dynatrace environment.
Go to Settings > Analyze and alert > Site reliability > Service-level objectives (SLOs).
Search for mySampleSLO.

Congratulations!

Well done, you have successfully deploy your SLO configuration in your environment.

You've learned how to create a Monaco project, including configuration files, validate the syntax and deploy it to a target environment.

Next steps

Learn how to delete the configuration.