Skip to content

Commit 90d0db0

Browse files
authored
Merge pull request #309675 from TimShererWithAquent/us540458-06
AquentLiftr: Add FAQ content: Dynatrace
2 parents e00b61a + fdc742f commit 90d0db0

3 files changed

Lines changed: 159 additions & 0 deletions

File tree

Lines changed: 155 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,155 @@
1+
### YamlMime:FAQ
2+
metadata:
3+
title: Azure Native Dynatrace Service FAQ
4+
description: Answers to common questions about using Azure Native Dynatrace Service in Azure, including prerequisites, setup, and management.
5+
ms.service: partner-services
6+
ms.subservice: dynatrace
7+
ai-usage: ai-generated
8+
ms.topic: faq
9+
ms.date: 12/17/2025
10+
11+
title: Azure Native Dynatrace Service frequently asked questions (FAQ)
12+
summary: |
13+
This FAQ covers common questions about onboarding, linking existing environments,
14+
configuring metrics and logs, setting up single sign-on (SSO), monitoring with Dynatrace OneAgent,
15+
billing, data residency, the free trial, and troubleshooting for Azure Native Dynatrace Service.
16+
17+
sections:
18+
- name: Getting started
19+
questions:
20+
- question: What is Azure Native Dynatrace Service?
21+
answer: |
22+
Azure Native Dynatrace Service is a jointly developed and managed offering from Microsoft and Dynatrace that provides deep cloud observability, AIOps, and continuous runtime application security for Azure workloads. It delivers a seamless, integrated experience in the Azure portal to procure, create, configure, and manage Dynatrace environments. For an overview, see [Azure Native Dynatrace Service overview](overview.md).
23+
24+
- question: Where can I find the service?
25+
answer: |
26+
You can find Azure Native Dynatrace Service in the [Azure portal](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Dynatrace.Observability%2Fmonitors) and on [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/dynatrace.dynatrace_portal_integration?tab=Overview).
27+
28+
- question: What gets created for billing and monitoring?
29+
answer: |
30+
When you use the integrated experience, three entities are mapped:
31+
- **Dynatrace resource in Azure:** Created in the subscription and resource group you select; used to manage the environment.
32+
- **Dynatrace environment (SaaS):** Created on Dynatrace SaaS when you create a new environment, or linked when you connect an existing environment.
33+
- **Marketplace SaaS resource:** Created based on the plan you select; used for billing.
34+
For details, see [Overview](overview.md#billing).
35+
36+
- name: Setup and access
37+
questions:
38+
- question: What permissions are required to create or manage a Dynatrace resource?
39+
answer: |
40+
To set up the service, you need **Owner** or **Contributor** access on the Azure subscription. Confirm your access before starting setup. See [Configure pre-deployment](configure-prerequisites.md#access-control).
41+
42+
- question: Do I need to complete any prerequisites before creating a resource?
43+
answer: |
44+
Yes. Complete the pre-deployment steps in your Azure subscription and Microsoft Entra ID (formerly Azure AD), including optional setup for SAML-based SSO. See [Configure pre-deployment](configure-prerequisites.md).
45+
46+
- question: How do I create a new Dynatrace resource?
47+
answer: |
48+
Use the Azure portal quickstart to create a resource, choose a plan, and configure optional metrics and logs, tags, and SSO. See [Quickstart: Get started with Dynatrace](create.md).
49+
50+
- name: Linking an existing environment
51+
questions:
52+
- question: Can I link my Azure subscription to an existing Dynatrace environment?
53+
answer: |
54+
Yes. Choose the option to link an Azure subscription to an existing environment. A new Dynatrace resource is created in Azure and linked to your Dynatrace SaaS environment. The environment and Dynatrace resource must reside in the same Azure region, and the linking user should have admin permissions on the target environment. See [Link to an existing Dynatrace environment](link-to-existing-resources.md).
55+
56+
- question: Can I set up SSO during linking?
57+
answer: |
58+
No. SSO setup isn’t available during linking. You can configure or reconfigure SSO after the resource is created. See [Manage: Reconfigure single sign-on](manage.md#reconfigure-single-sign-on).
59+
60+
- name: Metrics and logs
61+
questions:
62+
- question: What can I send to Dynatrace?
63+
answer: |
64+
You can enable platform metrics collection, subscription activity logs, and Azure resource logs. Resource log categories vary by service; see [Azure Monitor resource log categories](/azure/azure-monitor/essentials/resource-logs-categories). Configure these options when creating or managing the resource. See [Create: Metrics and logs](create.md#metrics-and-logs-tab-optional) and [Manage settings](manage.md#reconfigure-rules-for-metrics-and-logs).
65+
66+
- question: Why aren’t logs being emitted, or why do I see a limit message?
67+
answer: |
68+
- Only resource types with monitoring log categories can send logs. Verify support in [resource log categories](/azure/azure-monitor/essentials/resource-logs-categories).
69+
- Each Azure resource can have a maximum of five diagnostic settings. Remove other destinations if needed. See [Diagnostic settings](/azure/azure-monitor/essentials/diagnostic-settings?tabs=portal).
70+
71+
- question: Are metrics exported via diagnostic settings supported?
72+
answer: |
73+
Export of metrics data via Azure Monitor diagnostic settings isn’t currently supported by partner solutions. You can still enable metrics collection at creation and use Dynatrace OneAgent for deeper metrics on supported resources. See [Troubleshooting](troubleshoot.md#logs-not-being-emitted-or-limit-reached-issue).
74+
75+
- question: Why do diagnostic settings persist after I disable the resource or change tag rules?
76+
answer: |
77+
A delete lock on the resource or resource group can prevent cleanup of diagnostic settings. To stop forwarding, remove the lock. If the lock is removed after the Dynatrace resource is deleted, clean up diagnostic settings manually. See [Troubleshooting](troubleshoot.md#diagnostic-settings-are-active-even-after-disabling-the-dynatrace-resource-or-applying-necessary-tag-rules).
78+
79+
- name: Monitoring with Dynatrace OneAgent
80+
questions:
81+
- question: Which Azure services support Dynatrace OneAgent from the Azure portal?
82+
answer: |
83+
You can install and manage OneAgent for **Virtual machines**, **App Service**, **Azure Kubernetes Service (AKS)**, and **Azure Arc Machines** from the Dynatrace resource. See [Manage: Monitor resources using Dynatrace OneAgent](manage.md#monitor-resources-using-dynatrace-oneagent).
84+
85+
- question: Why can’t I install OneAgent on a virtual machine?
86+
answer: |
87+
OneAgent installation is disabled if the virtual machine is stopped. Start the virtual machine and try again. If a virtual machine shows OneAgent installed and **Uninstall extension** is disabled, another Dynatrace resource configured the agent; make changes from that resource. See the virtual machine tab in [Manage](manage.md#monitor-resources-using-dynatrace-oneagent).
88+
89+
- question: AKS installation or uninstallation options are inactive. What should I do?
90+
answer: |
91+
If AKS installation or uninstallation is inactive, see [AKS agent installation/uninstallation not available](https://go.microsoft.com/fwlink/?linkid=2331926).
92+
93+
- name: Multiple subscriptions
94+
questions:
95+
- question: Can I monitor multiple subscriptions with one Dynatrace resource?
96+
answer: |
97+
Yes. You can link up to **20 subscriptions**. Separate tag rules per subscription aren’t supported. Diagnostic settings are automatically added to resources that match defined tag rules. See [Manage: Monitor multiple subscriptions](manage.md#monitor-multiple-subscriptions).
98+
99+
- question: How do I avoid duplicate data and charges when adding subscriptions?
100+
answer: |
101+
If a subscription already has a Dynatrace resource linked to the same environment, delete that resource before adding the subscription to avoid duplicate data and double charges. See [Manage](manage.md#monitor-multiple-subscriptions).
102+
103+
- name: Single sign-on (SSO)
104+
questions:
105+
- question: How do I set up SAML-based single sign-on?
106+
answer: |
107+
In Microsoft Entra ID, add the **Dynatrace** enterprise application from the gallery, set **Assignment required?** to **No**, and select **SAML** for single sign-on. Save the single sign-on setting when prompted. See [Configure pre-deployment](configure-prerequisites.md#add-an-enterprise-application).
108+
109+
- question: Why can’t I save SSO settings?
110+
answer: |
111+
Another enterprise app might already be using the Dynatrace SAML identifier. In **Basic SAML configuration**, select **Edit** to find the app using the identifier. Either disable the other app or use it as the enterprise app for SAML SSO. See [Troubleshooting](troubleshoot.md#single-sign-on-errors).
112+
113+
- question: Why doesn’t my app appear on the single sign-on settings page?
114+
answer: |
115+
Search by application ID. If no result is shown, verify that the app has correct SAML settings; only apps with valid SAML settings are listed. See [Troubleshooting](troubleshoot.md#single-sign-on-errors).
116+
117+
- name: Free trial
118+
questions:
119+
- question: How do I start a free trial?
120+
answer: |
121+
A 30-day free trial is available from Azure Marketplace. Ensure your subscription is enabled for Marketplace purchases, then choose the free trial plan when you subscribe. See [Start a free trial](free-trial.md#subscribe-to-a-free-trial).
122+
123+
- question: What are the free trial limitations and what happens at expiration?
124+
answer: |
125+
During the trial, a Dynatrace account can have only **one environment**, so you can create only one Dynatrace resource. At trial expiry, the Dynatrace resource on Azure is deleted and data flow stops. You can upgrade to a paid plan from the Azure portal or contact Dynatrace for a custom offer. See [Free trial upgrade and expiration](free-trial.md#free-trial-upgrade-and-expiration).
126+
127+
- name: Billing and data residency
128+
questions:
129+
- question: Where is customer data stored and processed?
130+
answer: |
131+
Customer data is stored and processed only in the region where Azure Native Dynatrace Service was deployed. No data is stored outside that region. See [Overview](overview.md).
132+
133+
- question: How is billing handled?
134+
answer: |
135+
Billing is unified through Azure. The Marketplace SaaS resource created when you subscribe is used for billing. See [Overview](overview.md#billing).
136+
137+
- name: Troubleshooting and support
138+
questions:
139+
- question: Why can’t I create a Dynatrace resource?
140+
answer: |
141+
Ensure you have **Owner** or **Contributor** access on the subscription. Creation can also fail if the user profile in Microsoft Entra ID lacks a **Last Name** value. Ask your tenant admin to update the profile and try again. See [Troubleshooting](troubleshoot.md#unable-to-create-dynatrace-resource).
142+
143+
- question: How do I get support?
144+
answer: |
145+
Contact [Dynatrace support](https://support.dynatrace.com/). You can also request support from the **Support + Troubleshooting** section of your Dynatrace resource in the Azure portal. See [Manage: Get support](manage.md#get-support).
146+
147+
additionalContent: |
148+
## Related content
149+
150+
- [Azure Native Dynatrace Service overview](overview.md)
151+
- [Quickstart: Get started with Dynatrace](create.md)
152+
- [Link to an existing Dynatrace environment](link-to-existing-resources.md)
153+
- [Manage settings for your Dynatrace resource](manage.md)
154+
- [Start a free trial](free-trial.md)
155+
- [Troubleshooting](troubleshoot.md)

articles/partner-solutions/dynatrace/index.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ landingContent:
2121
links:
2222
- text: What is Azure Native Dynatrace Service?
2323
url: overview.md
24+
- text: FAQ
25+
url: faq.yml
2426
- linkListType: how-to-guide
2527
links:
2628
- text: Complete the prerequisites for Dynatrace

articles/partner-solutions/dynatrace/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ items:
55
items:
66
- name: What is Azure Native Dynatrace Service?
77
href: overview.md
8+
- name: FAQ
9+
href: faq.yml
810
- name: Quickstarts
911
expanded: true
1012
items:

0 commit comments

Comments
 (0)