Configuration API

Automation is the key to successful IT operations. Automation is also the key to successful monitoring and how you set up your monitoring environment or software intelligence platform.

Managing your configuration is critically important—you probably wouldn’t let anybody change the configuration of your production monitoring environment without proper staging tests.

Keeping track of all the changes within your configurations is another important aspect of what is commonly known as configuration as code.

Configuration as code introduces a strategy for managing your Dynatrace monitoring configurations just as you manage your source code. Managing your configurations should follow the same principles and rules that you apply to your critical, production source code. Configurations must be validated, tested, deployed, and versioned in a controlled and reproducible manner.

Without such rules, configuring your environments can result in chaos, with losses in flexibility, speed, and stability.

Dynatrace configuration API helps you keep track of your Dynatrace monitoring environment configurations. It provides the endpoints listed in the Endpoints section below.

Basics

Endpoints

API Explorer

You can access all Dynatrace API endpoints using the API Explorer. To access the API Explorer, open the User menu in the upper-right corner of the Dynatrace web UI, scroll down to Dynatrace API, and select the API section you're interested in.

Alternatively, you can access the API Explorer via a direct link:

• Dynatrace Managed https://{your-domain}/e/{your-environment-id}/rest-api-doc/
• Dynatrace SaaS https://{your-environment-id}.live.dynatrace.com/rest-api-doc/

Authentication in the API Explorer

Select the lock icon next to any end point to display information about the API tokens that secure that endpoint. Each endpoint requires a specific token type.

You can also unlock all endpoints by selecting Authorize. In the displayed dialog, you can then see which token permissions are necessary for each API endpoint. By entering your API token into the global Available authorizations dialog, you can unlock all related API endpoints.

Try out an API call

Once you've entered your API token, you can directly execute API calls within the API explorer. Just select Try it out to open the parameter section of the selected API endpoint, where you can enter additional parameters and modify the request payload before executing it by selecting Execute.