Quickstart: Link to an existing Dynatrace environment

In this quickstart, you link an Azure subscription to an existing Dynatrace environment. After linking to the Dynatrace environment, you can monitor the linked Azure subscription and the resources in that subscription by using the Dynatrace environment.

When you use the integrated experience for Dynatrace in the Azure portal, your billing and monitoring for the following entities is tracked in the portal.

• Dynatrace resource on Azure. By using the Dynatrace resource, you can manage the Dynatrace environment on Azure. The resource is created in the Azure subscription and resource group that you select during the linking process.
• Dynatrace environment. The Dynatrace environment on Dynatrace SaaS. When you link an existing environment, a new Dynatrace resource is created in Azure. The Dynatrace environment and the Dynatrace resource must reside in the same region.
• Marketplace SaaS resource. The SaaS resource is used for billing purposes. The SaaS resource typically doesn't reside in the Azure subscription where the Dynatrace environment was first created.

Subscribe to Dynatrace

1. Go to the Azure portal and sign in.

2. Search for Marketplace.

   

3. In Azure Marketplace, search for Dynatrace, and select the Dynatrace – An Azure Native ISV Service tile.

4. On the Dynatrace – An Azure Native ISV Service page, select Subscribe.

   

Link to an existing Dynatrace environment

1. When you create a Dynatrace resource, you see two options: one to create a new Dynatrace environment, and another to link an Azure subscription to an existing Dynatrace environment.

2. If you're linking the Azure subscription to an existing Dynatrace environment, select Create under the Link Azure subscription to an existing Dynatrace environment option.

3. A new Dynatrace resource is created on Azure and linked to an existing Dynatrace environment that's hosted on Azure. A form opens for creating the resource.

   

4. Provide the following values.

   Property	Action
   Subscription	Select the Azure subscription that you want to use for creating the Dynatrace resource. This subscription will be linked to environment for monitoring purposes.
   Resource group	Specify whether you want to create a new resource group or use an existing one. A resource group is a container that holds related resources for an Azure solution.
   Resource name	Specify a name for the Dynatrace resource.
   Region	Select the Azure region where the Dynatrace resource should be created.
   Dynatrace environment	The Azure portal shows a list of existing environments that can be linked to. Select the environment that you want.

   Note

   Linking requires that the environment and the Dynatrace resource reside in the same Azure region. The user that's performing the linking action should have administrator permissions on the Dynatrace environment being linked to. If the environment that you want to link to doesn't appear in the dropdown list, check to ensure that these conditions are met.

5. Select Next: Metrics and logs.

Configure metrics and logs

1. The next step is to configure metrics and logs. When linking an existing Dynatrace environment, you can set up automatic log forwarding for two types of logs:

   

   • Subscription activity logs. These logs provide insight into the operations on your resources at the control plane. Updates on service-health events are also included. Use the activity log to get information about write operations (PUT, POST, DELETE). There's a single activity log for each Azure subscription.

   • Azure resource logs. These logs provide insight into operations that were taken on an Azure resource at the data plane. For example, getting a secret from a key vault is a data plane operation. Making a request to a database is also a data plane operation. The content of resource logs varies, depending on the Azure service and resource type.

2. To send Azure resource logs to Dynatrace, select Send Azure resource logs. The types of Azure resource logs are listed in Azure Monitor Resource Log categories.

   When the checkbox for Azure resource logs is selected, by default, logs are forwarded for all resources. To filter the set of Azure resources sending logs to Dynatrace, use inclusion and exclusion rules and set the Azure resource tags:

   • All Azure resources with tags defined in include rules send logs to Dynatrace.
   • Azure resources with tags defined in exclude rules don't send logs to Dynatrace.
   • If there's a conflict between an inclusion and exclusion rule, the exclusion rule applies.

   The logs sent to Dynatrace are charged by Azure. For more information, see the pricing of platform logs sent to Azure Marketplace partners.

   You can collect metrics for virtual machines and app services by installing the Dynatrace OneAgent after the Dynatrace resource is created and an existing Dynatrace environment is linked to it.

3. After you finish configuring metrics and logs, select Next: Single sign-on.

Configure single sign-on

Select Next: Tags.

Add tags

1. You can add tags for your new Dynatrace resource. Provide name/value pairs for the tags that you want to apply to the Dynatrace resource.

   

2. When you're done adding tags, select Next: Review+Create.

Review and create

1. Review your selections and the terms of use. After validation completes, select Create.

   

2. Azure deploys the Dynatrace resource. When the process completes, select Go to resource to see the resource.

Next steps

• Manage the Dynatrace resource

• Get started with Azure Native Dynatrace Service on:

  Azure portal

  Azure Marketplace