Merge pull request #9759 from v-albemi/dynatrace-troubleshoot

AB#8533: Dynatrace troubleshooting articles

Author: ryanberg-aquent

support/azure/partner-solutions/dynatrace/free-trial-errors.md

@@ -0,0 +1,45 @@
+---
+title: Dynatrace Free Trial Limitations on Azure
+description: Understand the limitations of Dynatrace free trial resources on Azure.
+author: agrimayadav
+ms.author: jarrettr 
+ms.reviewer: v-ryanberg
+manager: dcscontentpm
+ms.service: partner-services 
+ms.topic: troubleshooting-problem-resolution
+ms.date: 09/23/2025
+ai-usage: ai-assisted
+# customer intent: As an Azure administrator or user, I want to understand the limitations of using a Dynatrace free trial on Azure so that I can work around them and/or prepare for resource deletions.
+
+---
+
+# Free trial limitations
+
+This article helps you understand limitations that you might encounter when creating or managing Dynatrace free trial resources on Azure, including resource creation limits and resource deletion after trial expiration.
+ 
+## Symptoms
+
+- You get an error when attempting to create another Dynatrace free trial resource.
+- The Dynatrace free trial resource is missing or deleted after the trial period ends.
+
+## Cause
+
+- You can only create one Dynatrace resource during the trial period.
+- With the free trial plan, your Dynatrace resource on Azure will be deleted automatically after the trial expires unless you request an extension.
+
+## Solution 1: Unable to create another free trial resource
+
+Only one environment or resource can be created during the trial period. If you need additional environments, upgrade to a paid Dynatrace plan or wait until the trial expires and start a new trial (if eligible).
+
+## Solution 2: Prepare for automatic free trial resource deletion
+
+Be aware that free trial resources are deleted automatically after the trial period ends. If you require more time, [contact Dynatrace sales](mailto:[email protected]) to request a trial extension or discuss upgrade options.
+
+## Resources
+
+- [Dynatrace free trial documentation](https://www.dynatrace.com/trial/resources/)
+- [Contact Dynatrace sales](mailto:[email protected])
+
+[!INCLUDE [azure-help-support](~/includes/azure-help-support.md)]
+
+[!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

support/azure/partner-solutions/dynatrace/metrics-checkbox-disabled.md

@@ -0,0 +1,49 @@
+---
+title: Metrics Collection Checkbox for Dynatrace Is Unavailable  
+description: Resolve the issue in which the metrics collection checkbox is unavailable because the user lacks Owner permissions on the subscription.
+author: agrimayadav
+ms.author: jarrettr
+ms.reviewer: v-ryanberg
+manager: dcscontentpm
+ms.service: partner-services
+ms.topic: troubleshooting-problem-resolution
+ms.date: 09/22/2025
+ai-usage: ai-assisted
+
+# customer intent: As an Azure administrator or user, I want to enable the Metrics checkbox so that I can enable metrics collection for Dynatrace.
+
+---
+
+# Metrics collection checkbox is unavailable 
+
+This article helps you resolve the issue where the **Enable metrics collection** checkbox is unavailable in your Dynatrace integration because the signed-in account doesn't have [Owner role permissions](/azure/role-based-access-control/built-in-roles#owner) on the Azure subscription.
+
+## Prerequisites
+
+- Access to the [Azure portal](https://portal.azure.com/) and the subscription that contains the resource.
+
+## Symptoms
+
+- The **Enable metrics collection** checkbox is unavailable (grayed out) in the Dynatrace integration UI.
+- Attempting to enable metrics collection results in an error or no action.
+
+## Cause
+
+Enabling metrics collection requires Owner role permissions at the subscription scope. Users with Contributor or Reader role permissions can't enable metrics collection from the integration UI and the checkbox is unavailable.
+
+## Solution: Request Owner role permission
+
+1. In the Azure portal, go to the subscription that contains the resource.
+2. Select **Access control (IAM)**.
+3. Select **View my access** to see your current role at the subscription scope.
+
+If you don't have Owner role permissions, contact the subscription Owner or admin and request Owner role permissions or ask them to enable metrics collection for you. After the Owner or admin assigns the role, wait 5–15 minutes for role-based access control (RBAC) propagation and then retry enabling metrics collection in the Dynatrace integration.
+
+## Resource
+
+- [Azure role-based access control (RBAC)](/azure/role-based-access-control/)
+- [Assign Azure roles using the Azure CLI](/azure/role-based-access-control/role-assignments-cli)
+
+[!INCLUDE [azure-help-support](~/includes/azure-help-support.md)]
+
+[!INCLUDE [Third-party contact disclaimer](~/includes/third-party-contact-disclaimer.md)]

support/azure/partner-solutions/index.yml

@@ -49,6 +49,16 @@ landingContent:
           - text: Single sign-on doesn't work for the Confluent SaaS portal
             url: confluent/single-sign-on-does-not-work.md   
 
+# Card
+  - title: Dynatrace 
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Free trial limitations
+            url: dynatrace/free-trial-errors.md
+          - text: Metrics collection checkbox is unavailable 
+            url: dynatrace/metrics-checkbox-disabled.md
+
 # Card
   - title: Astro 
     linkLists:

support/azure/partner-solutions/toc.yml

@@ -55,10 +55,14 @@ items:
       href: diagnostic-settings-manual-update.md
     - name: Diagnostic settings not created
       href: diagnostic-settings.md
+    - name: Free trial limitations
+      href: dynatrace/free-trial-errors.md
     - name: Log forwarding persists
       href: log-forwarding-persists.md
     - name: Log limitations
       href: log-limitations.md
+    - name: Metrics checkbox is unavailable
+      href: dynatrace/metrics-checkbox-disabled.md
 - name: Elastic
   items:
     - name: Diagnostic settings manual update