Skip to main content

Dynatrace

Integrate Dynatrace with Cloudaware to ingest accounts and environments into the CMDB for monitoring coverage and reporting.

info
  • Audience: Cloudaware administrators, SRE/DevOps
  • Outcome: The Dynatrace account is connected, and Dynatrace objects are available in the CMDB for monitoring coverage, environment inventory, and reporting

Capabilities​

The integration supports:

  • Read-only discovery of Dynatrace accounts and environments in the CMDB
  • Dynatrace context on related AWS Account and AWS EC2 Instance CMDB objects when AWS is connected
  • Monitoring coverage and environment reporting using CMDB Navigator, CMDB list views, and reports

Prerequisites​

Before you begin, make sure you have:

  • Access to a Cloudaware account.
  • A user with access to the Admin Console and permissions to manage cloud accounts, organizations, and integrations (Cloudaware Administrator).
  • Dynatrace environment URL, for example, https://<environment-id>.live.dynatrace.com.
  • Dynatrace Account URN in the format urn:dtaccount:<account-uuid>.
  • Dynatrace Client Secret.
  • OAuth client permissions for account-env-read, environment-api:oneagents:read, and storage:smartscape:read.
note

Save the Account URN and Client Secret in a secure location when creating the Dynatrace OAuth client. They cannot be retrieved after the initial creation screen is closed.

Add a Dynatrace Account to Cloudaware​

To connect your Dynatrace account to Cloudaware:

  1. In Cloudaware, go to Admin.
  2. Find Dynatrace, then click + ADD.
  3. Enter the following values:
    • Name: A display name for this connection.
    • URN: The Account URN in the format urn:dtaccount:<account-uuid>.
    • Client ID: The Dynatrace OAuth client ID.
    • Client Secret: The Dynatrace OAuth client secret.
  4. Click CHECK, then click SAVE.
  5. Confirm that the integration status indicator is green.
tip

Allow the initial discovery cycle to complete after enabling the integration.

View Dynatrace Data in CMDB​

To browse discovered Dynatrace resources:

  1. In Cloudaware, open CMDB Navigator.
  2. In the left pane, select DYNATRACE.
  3. Open an object list, e.g., Dynatrace Accounts or Dynatrace Environments, to view records.

Supported Objects​

Cloudaware ingests the following Dynatrace objects:

Dynatrace ObjectCMDB Object API Name
Dynatrace AccountCA10D__CaDynatraceAccount__c
Dynatrace EnvironmentCA10D__CaDynatraceEnvironment__c

Supported Fields​

Dynatrace-related fields may appear on AWS objects in Cloudaware:

CMDB ObjectCMDB Field
AWS AccountDynatrace: Account URN
AWS AccountDynatrace: Acquisition Status
AWS AccountDynatrace: Environment ID
AWS AccountDynatrace: Lifetime Start
AWS EC2 InstanceDynatrace: Account URN
AWS EC2 InstanceDynatrace: Acquisition Status
AWS EC2 InstanceDynatrace: Agent Auto Update Settings
AWS EC2 InstanceDynatrace: Agent Availability State
AWS EC2 InstanceDynatrace: Agent Configured Monitoring
AWS EC2 InstanceDynatrace: Environment ID
AWS EC2 InstanceDynatrace: Lifetime Start

Troubleshooting​

note

Initial data collection may take time to complete.

Authentication Fails or Integration Shows Red Status​

  • Confirm that the Dynatrace account is active and accessible.
  • Verify that the URN value uses the format urn:dtaccount:<account-uuid>.
  • Confirm that the OAuth client has the required read permissions.
  • Re-enter the Client ID and Client Secret, then click CHECK again.

Check Fails in Cloudaware​

  • Verify that the Dynatrace environment URL is correct and uses HTTPS.
  • Check whether egress to the Dynatrace API endpoint is blocked by firewall, proxy, or allowlist rules.
  • Confirm that the client secret has not been rotated or revoked in Dynatrace.

No Data Appears After a Successful Save​

  • Allow the initial discovery cycle to complete.
  • Confirm that Dynatrace contains the environments and monitored entities you expect.
  • In CMDB Navigator, verify that you are viewing the DYNATRACE section and related resources.

Dynatrace Fields Do Not Appear on AWS Objects​

  • Confirm that the AWS account and EC2 instances are discovered in CMDB. See AWS Setup Guide.
  • Confirm that Dynatrace is monitoring the expected hosts or services.
  • Wait for the next synchronization cycle for field enrichment to appear.

Access Error Message Is Displayed for Some Objects​

  • Read the error message to identify which objects or scopes are not accessible.
  • Review the OAuth client permissions and grant any missing read permissions for the affected scope.

Still stuck? Contact Cloudaware Support at support@cloudaware.com with the integration name and a brief description of the issue.

Reconfigure or Remove the Integration​

warning

To rotate credentials, edit the existing integration instead of deleting and re-creating it.

Update the Integration Details​

  1. Go to Admin.
  2. Select Dynatrace.
  3. Select the specific integration.
  4. Open the three-dot menu (⋮), then click Edit.
  5. Update the required fields.
  6. Click Save.

Remove the Integration from Cloudaware​

  1. Go to Admin.
  2. Select Dynatrace.
  3. Select the specific integration.
  4. Open the three-dot menu (⋮), then click Delete.
  5. Confirm the deletion if prompted.

Security Notes​

  • Use a dedicated Dynatrace OAuth client for Cloudaware discovery.
  • Grant only the minimum read permissions required for account, environment, OneAgent, and Smartscape discovery.
  • Store the client secret securely and limit access to administrators who manage integrations.
  • Rotate the client secret according to your organization's credential-rotation policy.
  • Update the Cloudaware integration immediately if the client secret is revoked or regenerated in Dynatrace.