How do I add a Dynatrace environment to Davis?

Find out what you need to do to add your environment to Davis.

Enable Dynatrace SaaS environments

Dynatrace SaaS environments associated with your Dynatrace account are automatically added to Davis. The only required step is to enter an API token. For details, see How do I get started with Dynatrace Davis?

Add Dynatrace Managed environments

Managed environments must be manually added. Note that only Dynatrace users with administrative privileges can add API tokens. Managed environments require that all additional users be added based on their email address' domain name or through manual entry.

An API token is required for each Dynatrace environment. The environment wizard will appear if the selected environment has an invalid or no API token (skip to step 2). If there's no SaaS environments associated with the user, a form for adding a Managed environment will appear in the wizard. Users with at least one SaaS environment that has had a valid API token added to Davis can add Managed environments within the Dynatrace environments section in Account settings.

  1. Go to Sign in with your Dynatrace Managed credentials.

  2. Enter your Managed environment URL into the associated input.

Note: If the environment wizard doesn't appear, you can still add a Managed environment by navigating to Account settings > Dynatrace environments > Add Managed environment.

  1. Follow the Get token link provided in the API token input's label.

  2. Type a name for the token and click the Generate button.

  3. Click the Edit button of the newly created token to reveal the token settings.

  4. Click the Copy button to copy the token to your clipboard.

  5. Return to the Dynatrace Davis setup page. Paste the copied API token into the API token input.

  6. Click Save.

Note: Each environment's API token can also be set within the Dynatrace environments section in Account settings and that Dynatrace Managed users must first enter a valid environment URL before entering an API token.

Add users to a Dynatrace Managed environment

Due to differences in the information available to Davis from Managed and SaaS environments, Managed environment administrators must add other users manually. Note that the User accounts section in Account settings only appears if the active environment is a Managed environment and you're a Davis administrator. The active environment can be changed in the User profile menu in the top-right corner of the window.

  1. Go to Sign in with your Dynatrace Managed credentials.

  2. Click on the User profile button (icon) in the top-right corner. Ensure that a Dynatrace Managed environment is selected in the User profile menu, go to the User accounts section within Account settings.

  3. Optionally, administrators can enable domain name based user addition. This option allows all users with a domain name in their email address that matches an administrator's email address domain name to automatically add an associated Managed environment. Enable this option by clicking on the switch input above the Users tab.

  4. Click the Add user tab and enter the user's Dynatrace associated email address.

  5. Check the Administrator checkbox if the user should have administrative privileges.

  6. Click the Add button.

Server-side caching is used in Davis to improve response times and reduce Dynatrace API calls. Closed problems are cached for 30 days. Open problems aren't cached. Application, service, host, and process-group data is cached for 10 minutes. Other data accessed through the Dynatrace API is cached for less than a minute.

Interaction history is stored in local storage in the Davis web application. This data can be cleared by clicking Clear interaction history within the User profile menu in the top-right corner of the Davis web user interface. Interaction history is cleared from local storage after signing out through Davis.

Required IP addresses and port numbers for Dynatrace Managed environments

Davis administrators can determine which IP addresses and port numbers are required to be accessible to Davis under the Add managed environment tab in the Dynatrace environments section in Account settings.

Dynatrace Security Gateway for Dynatrace Managed environments

Security Gateway works as a proxy between Dynatrace OneAgent and Dynatrace Server. Security Gateway collects monitoring data, aggregates the data, and sends the data to Dynatrace Server using an encrypted HTTPS connection. Security Gateway is the only Dynatrace software component in your data center that requires full Internet access.