You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/partner-solutions/dynatrace/configure-prerequisites.md
+4-8Lines changed: 4 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,13 +37,9 @@ To use the Security Assertion Markup Language (SAML) based single sign-on (SSO)
37
37
38
38
:::image type="content" source="media/dynatrace-how-to-configure-prereqs/dynatrace-saml-sign-on.png" alt-text="Screenshot of the Dynatrace S A M L settings.":::
39
39
40
-
## Next steps
40
+
## Next step
41
41
42
-
-[Quickstart: Create a new Dynatrace environment](dynatrace-create.md)
43
-
- Get started with Azure Native Dynatrace Service on
42
+
> [!div class="nextstepaction"]
43
+
> [Quickstart: Create a new Dynatrace environment](dynatrace-create.md)
description: This article describes how to use the Azure portal to create an instance of Dynatrace.
4
4
5
5
ms.topic: quickstart
6
-
ms.date: 10/16/2023
6
+
ms.date: 03/13/2025
7
7
8
8
---
9
9
10
-
# QuickStart: Get started with Dynatrace
10
+
# Quickstart: Get started with Dynatrace
11
11
12
-
In this quickstart, you create a new instance of Azure Native Dynatrace Service. You can either create a new Dynatrace environment or [link to an existing Dynatrace environment](dynatrace-link-to-existing.md#link-to-existing-dynatrace-environment).
13
-
14
-
When you use the integrated Dynatrace experience in Azure portal, the following entities are created and mapped for monitoring and billing purposes.
15
-
16
-
:::image type="content" source="media/dynatrace-create/dynatrace-entities.png" alt-text="Flowchart showing three entities: Marketplace S A A S connecting to Dynatrace resource, connecting to Dynatrace environment.":::
17
-
18
-
-**Dynatrace resource in Azure** - Using the Dynatrace resource, you can manage the Dynatrace environment in Azure. The resource is created in the Azure subscription and resource group that you select during the create process or linking process.
19
-
-**Dynatrace environment** - The Dynatrace environment on Dynatrace _Software as a Service_ (SaaS). When you create a new environment, the environment on Dynatrace SaaS is automatically created, in addition to the Dynatrace resource in Azure.
20
-
-**Marketplace SaaS resource** - The SaaS resource is created automatically, based on the plan you select from the Dynatrace Marketplace offer. This resource is used for billing purposes.
12
+
In this quickstart, you create a new instance of Dynatrace.
21
13
22
14
## Prerequisites
23
15
24
-
Before you link the subscription to a Dynatrace environment, [complete the pre-deployment configuration](configure-prerequisites.md).
25
-
26
-
### Find Offer
27
-
28
-
Use the Azure portal to find Azure Native Dynatrace Service application.
29
-
30
-
1. Go to the [Azure portal](https://portal.azure.com) and sign in.
31
-
32
-
1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for _Marketplace_.
33
-
34
-
:::image type="content" source="media/dynatrace-create/dynatrace-search-marketplace.png" alt-text="Screenshot showing a search for Marketplace in the Azure portal.":::
35
-
36
-
1. In the Marketplace, search for _Dynatrace_.
37
-
:::image type="content" source="media/dynatrace-create/dynatrace-marketplace.png" alt-text="Screenshot showing the Azure Native Dynatrace Service offering.":::
38
-
39
-
1. Select **Subscribe**.
40
-
:::image type="content" source="media/dynatrace-create/dynatrace-subscribe.png" alt-text="Screenshot showing Dynatrace in the working pane to create a subscription.":::
41
-
42
-
## Create a Dynatrace resource in Azure
43
-
44
-
1. When creating a Dynatrace resource, you see two options: one to create a new Dynatrace environment, and another to link Azure subscription to an existing Dynatrace environment. If you want to create a new Dynatrace environment, select **Create** action under the **Create a new Dynatrace environment** option.
45
-
:::image type="content" source="media/dynatrace-create/dynatrace-create-new-link-existing.png" alt-text="Screenshot showing two options: new Dynatrace or existing Dynatrace.":::
- You must [configure your environment](configure-prerequisites.md).
18
+
- You must [subscribe to Dynatrace](overview.md#subscribe-to-dynatrace).
46
19
47
-
1. You see a form to create a Dynatrace resource in the working pane.
20
+
## Create a Dynatrace resource
48
21
49
-
:::image type="content" source="media/dynatrace-create/dynatrace-basic-properties.png" alt-text="Screenshot of basic properties needed for new Dynatrace instance.":::
> The steps in this article are for creating a new Dynatrace environment. See [link to an existing Dynatrace environment](link-to-existing-resources.md) if you have an existing Dynatrace environment you'd prefer to link your Azure subscription to.
52
26
53
-
|**Property**|**Description**|
54
-
|--------------|-------------------|
55
-
|**Subscription**| Select the Azure subscription you want to use for creating the Dynatrace resource. You must have owner or contributor access.|
56
-
|**Resource group**| Specify whether you want to create a new resource group or use an existing one. A [resource group](../../azure-resource-manager/management/overview.md) is a container that holds related resources for an Azure solution. |
57
-
|**Resource name**| Specify a name for the Dynatrace resource. This name will be the friendly name of the new Dynatrace environment.|
58
-
|**Location**| Select the region. Select the region where the Dynatrace resource in Azure and the Dynatrace environment is created.|
59
-
|**Pricing plan**| Select from the list of available plans. |
27
+
### Basics tab
60
28
61
-
1. Select **Next: Metrics and Logs**.
62
-
63
-
### Configure metrics and logs
64
-
65
-
66
-
1. Your next step is to configure metrics and logs for your resources. Azure Native Dynatrace Service supports the metrics for both compute and non-compute resources. Compute resources include VMs, app services and more. If you have an _owner role_ in the subscription, you see the option to enable metrics collection.
67
-
:::image type="content" source="media/dynatrace-create/dynatrace-contributor-UI.png" alt-text="Screenshot showing contributor view of metrics and logs.":::
68
-
69
-
-**Metrics for compute resources** – Users can send metrics for the compute resources, virtual machines and app services, by installing the Dynatrace OneAgent extension on the compute resources after the Dynatrace resource has been created.
70
-
-**Metrics for non-compute resources** – These metrics can be collected by configuring the Dynatrace resource to automatically query Azure monitor for metrics. To enable metrics collection, select the checkbox. If you have an **owner access** in your subscription, you can enable and disable the metrics collection using the checkbox. Proceed to the configuring logs. However, if you have contributor access, use the information in the following step.
71
-
72
-
73
-
1. If you have a _contributor role_ in the subscription, you don't see the option to enable metrics collection because in Azure a contributor can't assign a _monitoring reader_ role to a resource that is required by the metrics crawler to collect metrics.
29
+
The *Basics* tab has four sections:
74
30
75
-
:::image type="content" source="media/dynatrace-create/dynatrace-metrics-and-logs.png" alt-text="Screenshot showing options for metrics and logs.":::
76
-
77
-
78
-
79
-
Complete the resource provisioning excluding the metrics configuration and ask an owner to assign an appropriate role manually to your resource. If you have an _owner role_ in the subscription, you can take the following steps to grant a monitoring reader identity to a contributor user:
80
-
81
-
82
-
1. Go to the resource created by a contributor.
31
+
- Project details
32
+
- Azure resource details
33
+
- Dynatrace details
34
+
- User account information
83
35
84
-
1. Go to **Access control** in the resource menu on the left and select **Add** then **Add role assignment**.
85
-
:::image type="content" source="media/dynatrace-create/dynatrace-contributor-guide-1.png" alt-text="Screenshot showing the access control page.":::
86
-
87
-
1. In the list, scroll down and select on **Monitoring reader**. Then, select **Next**.
88
-
:::image type="content" source="media/dynatrace-create/dynatrace-contributor-guide-2.png" alt-text="Screenshot showing the process for selecting Monitoring reader role.":::
36
+
:::image type="content" source="media/create/basics-tab.png" alt-text="A screenshot of the Create a Dynatrace resource in Azure options inside of the Azure portal's working pane with the Basics tab displayed.":::
:::image type="content" source="media/dynatrace-create/dynatrace-contributor-guide-3.png" alt-text="Screenshot showing the process to assign a role to a managed identity.":::
38
+
There are required fields (identified with a red asterisk) that you need to fill out.
92
39
93
-
1. Select the **Subscription**. In **Managed identity**, select **Dynatrace** and the Dynatrace resource created by the contributor. After you select the resource, use **Select** to continue.
94
-
:::image type="content" source="media/dynatrace-create/dynatrace-contributor-select.png" alt-text="Screenshot showing the Dynatrace resource with a new contributor selected.":::
40
+
1. Enter the values for each required setting under *Project details*.
95
41
96
-
1. When you have completed the selection, select **Review + assign**
97
-
:::image type="content" source="media/dynatrace-create/dynatrace-review-and-assign.png" alt-text="Screenshot showing Add role assignment working pane with Review and assign with a red box around it.":::
| Subscription | Select a subscription from your existing subscriptions. |
45
+
| Resource group | Use an existing resource group or create a new one. |
98
46
99
-
1.When creating the Dynatrace resource, you can set up automatic log forwarding for three types of logs:
47
+
1.Enter the values for each required setting under *Azure Resource details*.
100
48
101
-
-**Send subscription activity logs** - Subscription activity logs provide insight into the operations on your resources at the [control plane](../../azure-resource-manager/management/control-plane-and-data-plane.md). Updates on service-health events are also included. Use the activity log to determine the what, who, and when for any write operations (PUT, POST, DELETE). There's a single activity log for each Azure subscription.
| Resource name | Specify a unique name for the resource. |
52
+
| Region | Select a region to deploy your resource. |
102
53
103
-
-**Send Azure resource logs for all defined sources** - Azure resource logs provide insight into operations that were taken on an Azure resource at the [data plane](../../azure-resource-manager/management/control-plane-and-data-plane.md). For example, getting a secret from a Key Vault is a data plane operation. Or, making a request to a database is also a data plane operation. The content of resource logs varies by the Azure service and resource type.
54
+
1. Enter the values for each required setting under *Dynatrace details*.
104
55
105
-
-**Send Microsoft Entra logs** – Microsoft Entra logs allow you to route the audit, sign-in, and provisioning logs to Dynatrace. The details are listed in [Microsoft Entra activity logs in Azure Monitor](../../active-directory/reports-monitoring/concept-activity-logs-azure-monitor.md). The administrator or security administrator for your Microsoft Entra tenant can enable Microsoft Entra logs.
1.To send subscription level logs to Dynatrace, select **Send subscription activity logs**. If this option is left unchecked, none of the subscription level logs are sent to Dynatrace.
61
+
1.Select **Next: Metrics and Logs**.
108
62
109
-
1. To send Azure resource logs to Dynatrace, select **Send Azure resource logs for all defined resources**. The types of Azure resource logs are listed in [Azure Monitor Resource Log categories](/azure/azure-monitor/essentials/resource-logs-categories).
63
+
### Metrics and logs tab (optional)
110
64
111
-
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:
65
+
If you wish, you can configure resources to send metrics/logs to Dynatrace.
112
66
113
-
- All Azure resources with tags defined in include Rules send logs to Dynatrace.
114
-
- All Azure resources with tags defined in exclude rules don't send logs to Dynatrace.
115
-
- If there's a conflict between an inclusion and exclusion rule, the exclusion rule applies.
67
+
- Select **Enable metrics collection** to set up monitoring of platform metrics.
68
+
- Select **Subscription activity logs** to send subscription-level logs to Dynatrace.
69
+
- Select **Azure resource logs** to send Azure resource lots to Dynatrace.
116
70
117
-
The logs sent to Dynatrace are charged by Azure. For more information, see the[pricing of platform logs](https://azure.microsoft.com/pricing/details/monitor/) sent to Azure Marketplace partners.
71
+
Select the **Next** button at the bottom of the page.
118
72
119
-
1. Once you have completed configuring metrics and logs, select **Next: Single sign-on**.
73
+
### Single sign-on tab (optional)
120
74
121
-
### Configure single sign-on
75
+
[!INCLUDE [sso](../includes/sso.md)]
122
76
123
-
1. You can establish single sign-on to Dynatrace from the Azure portal when your organization uses Microsoft Entra ID as its identity provider. If your organization uses a different identity provider or you don't want to establish single sign-on at this time, you can skip this section.
77
+
### Tags tab (optional)
124
78
125
-
:::image type="content" source="media/dynatrace-create/dynatrace-single-sign-on.png" alt-text="Screenshot showing options for single sign-on.":::
79
+
[!INCLUDE [tags](../includes/tags.md)]
126
80
127
-
1. To establish single sign-on through Microsoft Entra ID, select the checkbox for **Enable single sign-on through Microsoft Entra ID**.
81
+
### Review + create tab
128
82
129
-
The Azure portal retrieves the appropriate Dynatrace application from Microsoft Entra ID. The app matches the Enterprise app you provided in an earlier step.
0 commit comments