Merge pull request #214368 from flang-msft/fxl---Dynatrace-review-of-partner-documentation-99706

Fxl---dynatrace review of partner documentation 99706

Author: jborsecnik

articles/partner-solutions/dynatrace/dynatrace-create.md

@@ -4,7 +4,7 @@ description: This article describes how to use the Azure portal to create an ins
 ms.topic: quickstart
 author: flang-msft
 ms.author: franlanglois
-ms.date: 08/24/2022
+ms.date: 10/12/2022
 
 ---
 
@@ -16,21 +16,21 @@ When you use the integrated Dynatrace experience in Azure portal, the following
 
 :::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.":::
 
-- **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 or linking process.
-- **Dynatrace environment** - This is the Dynatrace environment on Dynatrace SaaS. When you choose to create a new environment, the environment on Dynatrace SaaS is automatically created, in addition to the Dynatrace resource in Azure. The resource is created in the Azure subscription and resource group that you selected when you created the environment or linked to an existing environment.
+- **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.
+- **Dynatrace environment** - This is 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.
 - **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.
 
 ## Prerequisites
 
-Before creating your first instance of Dynatrace in Azure, configure your environment. These steps must be completed before continuing with the next steps in this quickstart.
+Before you link the subscription to a Dynatrace environment,[complete the pre-deployment configuration.](dynatrace-link-to-existing.md).
 
 ### Find Offer
 
 Use the Azure portal to find Dynatrace for Azure application.
 
 1. Go to the [Azure portal](https://portal.azure.com) and sign in.
 
-1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for *Marketplace*.
+1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for _Marketplace_.
 
     :::image type="content" source="media/dynatrace-create/dynatrace-search-marketplace.png" alt-text="Screenshot showing a search for Marketplace in the Azure portal.":::
 
@@ -58,9 +58,9 @@ Use the Azure portal to find Dynatrace for Azure application.
     | **Property** |   **Description** |
     |--------------|-------------------|
     | Subscription | Select the Azure subscription you want to use for creating the Dynatrace resource. You must have owner or contributor access.|
-    | 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. |
+    | 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. |
     | Resource name   | Specify a name for the Dynatrace resource. This name will be the friendly name of the new Dynatrace environment.|
-    | Location        | Select the region. Both the Dynatrace resource in Azure and Dynatrace environment will be created in the selected region.|
+    | Location        | Select the region. Select the region where the Dynatrace resource in Azure and the Dynatrace environment is created.|
     | Pricing plan    | Select from the list of available plans. |
 
 ### Configure metrics and logs
@@ -69,25 +69,24 @@ Use the Azure portal to find Dynatrace for Azure application.
 
     :::image type="content" source="media/dynatrace-create/dynatrace-metrics-and-logs.png" alt-text="Screenshot showing options for metrics and logs.":::
 
-    - **Subscription activity logs** - These 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.
+    - **Subscription activity logs** - These 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.
 
-    - **Azure resource logs** - These 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.
+    - **Azure resource logs** - These 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.
 
 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.
 
-   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-monitor/essentials/resource-logs-categories.md). To filter the set of Azure resources sending logs to Dynatrace, use inclusion and exclusion rules and set the Azure resource tags.
+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-monitor/essentials/resource-logs-categories.md).
 
-    Rules for sending resource logs:
-  
-    - When the checkbox for Azure resource logs is selected, by default, logs are forwarded for all resources.
-    - Azure resources with Include tags send logs to Dynatrace.
-    - Azure resources with Exclude tags don't send logs to Dynatrace.
-    - If there's a conflict between inclusion and exclusion rules, exclusion rule applies.
-  
-    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.
+   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:
 
-    > [!NOTE]
-    > Metrics for virtual machines and App Services can be collected by installing the Dynatrace OneAgent after the Dynatrace resource has been created.
+    - All Azure resources with tags defined in include Rules send logs to Dynatrace.
+    - All 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](https://azure.microsoft.com/pricing/details/monitor/) sent to Azure Marketplace partners.
+
+   > [!NOTE]
+   > Metrics for virtual machines and App Services can be collected by installing the Dynatrace OneAgent after the Dynatrace resource has been created.
 
 1. Once you have completed configuring metrics and logs, select **Next: Single sign-on**.
 
@@ -103,4 +102,4 @@ Use the Azure portal to find Dynatrace for Azure application.
 
 ## Next steps
 
-- [Manage the Dynatrace resource](dynatrace-how-to-manage.md)
+- [Manage the Dynatrace resource](dynatrace-how-to-manage.md)

articles/partner-solutions/dynatrace/dynatrace-how-to-configure-prereqs.md

@@ -4,17 +4,17 @@ description: This article describes how to complete the prerequisites for Dynatr
 ms.topic: conceptual
 author: flang-msft
 ms.author: franlanglois
-ms.date: 08/24/2022
+ms.date: 10/12/2022
 
 ---
 
 # Configure pre-deployment
 
-This article describes the prerequisites that must be completed before you create the first instance of Dynatrace resource in Azure.
+This article describes the prerequisites that must be completed in your Azure subscription or Azure Active Directory before you create your first Dynatrace resource in Azure.
 
 ## Access control
 
-To set up the Dynatrace for Azure, you must have **Owner** or **Contributor** access on the Azure subscription. [Confirm that you have the appropriate access](../../role-based-access-control/check-access.md) before starting the setup.
+To set up Dynatrace for Azure, you must have **Owner** or **Contributor** access on the Azure subscription. First, [confirm that you have the appropriate access](/azure/role-based-access-control/check-access) before starting the setup.
 
 ## Add enterprise application
 
@@ -40,4 +40,4 @@ To use the Security Assertion Markup Language (SAML) based single sign-on (SSO)
 
 ## Next steps
 
-- [Quickstart: Create a new Dynatrace environment](dynatrace-create.md)
+- [Quickstart: Create a new Dynatrace environment](dynatrace-create.md)

articles/partner-solutions/dynatrace/dynatrace-how-to-manage.md

@@ -5,7 +5,7 @@ author: flang-msft
 
 ms.topic: conceptual
 ms.author: franlanglois
-ms.date: 08/24/2022
+ms.date: 10/12/2022
 
 ---
 
@@ -34,7 +34,7 @@ At the bottom, you see two tabs:
 - **Get started tab** also provides links to Dynatrace dashboards, logs and Smartscape Topology.
 - **Monitoring tab** provides a summary of the resources sending logs to Dynatrace.
 
-If you select the **Monitoring** pane, you see a table with information about the Dynatrace resource.
+If you select the **Monitoring** pane, you see a table with information about the Azure resources sending logs to Dynatrace.
 
 :::image type="content" source="media/dynatrace-how-to-manage/dynatrace-monitoring.png" alt-text="Screenshot of overview working pane showing monitoring.":::
 
@@ -62,8 +62,8 @@ You can filter the list of resources by resource type, resource group name, regi
 
 The column **Logs to Dynatrace** indicates whether the resource is sending logs to Dynatrace. If the resource isn't sending logs, this field indicates why logs aren't being sent. The reasons could be:
 
-- _Resource doesn't support sending logs_ - Only resource types with monitoring log categories can be configured to send logs. See [supported categories](../../azure-monitor/essentials/resource-logs-categories.md).
-- _Limit of five diagnostic settings reached_ - Each Azure resource can have a maximum of five diagnostic settings. For more information, see [diagnostic settings](../../azure-monitor/essentials/diagnostic-settings.md).
+- _Resource doesn't support sending logs_ - Only resource types with monitoring log categories can be configured to send logs. See [supported categories](/azure-monitor/essentials/resource-logs-categories.md).
+- _Limit of five diagnostic settings reached_ - Each Azure resource can have a maximum of five diagnostic settings. For more information, see [diagnostic settings](/azure-monitor/essentials/diagnostic-settings.md).
 - _Error_ - The resource is configured to send logs to Dynatrace, but is blocked by an error.
 - _Logs not configured_ - Only Azure resources that have the appropriate resource tags are configured to send logs to Dynatrace.
 - _Agent not configured_ - Virtual machines without the Dynatrace OneAgent installed don't emit logs to Dynatrace.
@@ -78,14 +78,14 @@ For each virtual machine, the following info is displayed:
 |------------|------------|
 | **Resource Name** | Virtual machine name |
 | **Resource Status** | Indicates whether the virtual machine is stopped or running. Dynatrace OneAgent can only be installed on virtual machines that are running. If the virtual machine is stopped, installing the Dynatrace OneAgent will be disabled. |
-| **Agent status** | Whether the Dynatrace OneAgent is running on the virtual machine |
-| **Agent version** | The Dynatrace OneAgent version number |
+| **OneAgent status** | Whether the Dynatrace OneAgent is running on the virtual machine |
+| **OneAgent version** | The Dynatrace OneAgent version number |
 | **Auto-update** | Whether auto-update has been enabled for the OneAgent |
-| **Log analytics** | Whether log monitoring option was selected when OneAgent was installed |
+| **Log monitoring** | Whether log monitoring option was selected when OneAgent was installed |
 | **Monitoring mode** | Whether the Dynatrace OneAgent is monitoring hosts in [full-stack monitoring mode or infrastructure monitoring mode](https://www.dynatrace.com/support/help/how-to-use-dynatrace/hosts/basic-concepts/get-started-with-infrastructure-monitoring) |
 
 > [!NOTE]
-> If a virtual machine shows that an agent has been configured, but the options to manage the agent through extension are disabled, it means that the agent has been configured through a different Dynatrace resource in the same Azure subscription.
+> If a virtual machine shows that an OneAgent is installed, but the option Uninstall extension is disabled, then the agent was configured through a different Dynatrace resource in the same Azure subscription. To make any changes, please go to the other Dynatrace resource in the Azure subscription.
 
 ## Monitor App Services using Dynatrace OneAgent
 
@@ -98,8 +98,8 @@ For each app service, the following information is displayed:
 | **Resource name** | App service name |
 | **Resource status** | Indicates whether the App service is running or stopped. Dynatrace OneAgent can only be installed on app services that are running. |
 | **App Service plan** | The plan configured for the app service |
-| **Agent version** | The Dynatrace OneAgent version |
-| **Agent status** | status of the agent |
+| **OneAgent version** | The Dynatrace OneAgent version |
+| **OneAgent status** | status of the agent |
 
 To install the Dynatrace OneAgent, select the app service and select **Install Extension.** The application settings for the selected app service are updated and the app service is restarted to complete the configuration of the Dynatrace OneAgent.
 
@@ -125,8 +125,8 @@ Select **Overview** in Resource menu. Then, select **Delete**. Confirm that you
 
 If only one Dynatrace resource is mapped to a Dynatrace environment, logs are no longer sent to Dynatrace. All billing through Azure Marketplace stops for Dynatrace.
 
-If more than one Dynatrace resource is mapped to the Dynatrace environment using the link Azure subscription option, deleting the Dynatrace resource only stops sending logs for that Dynatrace resource. However, since other Dynatrace environment may be linked to other Dynatrace resources, billing continues through the Azure Marketplace.
+If more than one Dynatrace resource is mapped to the Dynatrace environment using the link Azure subscription option, deleting the Dynatrace resource only stops sending logs for Azure resources associated to that Dynatrace resource. However, since this one Dynatrace environment might still be linked to other Dynatrace resources, billing continues through the Azure Marketplace.
 
 ## Next steps
 
-For help with troubleshooting, see [Troubleshooting Dynatrace integration with Azure](dynatrace-troubleshoot.md).
+For help with troubleshooting, see [Troubleshooting Dynatrace integration with Azure](dynatrace-troubleshoot.md).