Skip to content

Commit

Permalink
Updates from review comments
Browse files Browse the repository at this point in the history
  • Loading branch information
flang-msft committed Jun 3, 2022
1 parent dd83598 commit df636c4
Show file tree
Hide file tree
Showing 8 changed files with 29 additions and 28 deletions.
12 changes: 6 additions & 6 deletions articles/partner-solutions/dynatrace/dynatrace-create.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,14 +17,14 @@ 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 Dyntrace 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 Dynatrace environment is created in the same Azure region in which you create the Dynatrace resource.
- **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.
- **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.
- **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.

## Find Offer
### Find Offer

Use the Azure portal to find Dynatrace for Azure application.

Expand Down Expand Up @@ -58,7 +58,7 @@ 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/azure-resource-manager/management/overview)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/azure-resource-manager/management/overview) 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.|
| Pricing plan | Select from the list of available plans. |
Expand Down Expand Up @@ -93,9 +93,9 @@ Use the Azure portal to find Dynatrace for Azure application.

### Configure single sign-on

1. You can establish single sign-on to Dynatrace from the Azure portal when your organization uses Azure Active Directory 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.
1. You can establish single sign-on to Dynatrace from the Azure portal when your organization uses Azure Active Directory 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.

:::image type="content" source="media/dynatrace-how-to-configure-prereqs/dynatrace-single-sign-on.png" alt-text="Screenshot showing options for single sign-on.":::
:::image type="content" source="media/dynatrace-create/dynatrace-single-sign-on.png" alt-text="Screenshot showing options for single sign-on.":::

1. To establish single sign-on through Azure Active directory, select the checkbox for **Enable single sign-on through Azure Active Directory**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,31 +10,31 @@ ms.date: 06/07/2022

# Configure pre-deployment

This article describes the pre-requisites that must be completed before you create the first instance of Dynatrace resource in Azure.
This article describes the prerequisites that must be completed before you create the first instance of Dynatrace resource in Azure.

## Access control

To set up the Azure Dynatrace integration, you must have **owner** or **contributor** access on the Azure subscription. [Confirm that you have the appropriate access](/azure/role-based-access-control/check-access) before starting the setup.
To set up the Azure Dynatrace integration, you must have **Owner** or **Contributor** access on the Azure subscription. [Confirm that you have the appropriate access](/azure/role-based-access-control/check-access) before starting the setup.

## Add enterprise application

To use the Security Assertion Markup Language (SAML) based single sign-on (SSO) feature within the Dynatrace resource, you must set up an enterprise application. To add an enterprise application, you need one of these roles: Global administrator, Cloud Application Administrator, or Application Administrator.

1. Go to Azure portal. Select **Azure Active Directory,** then **Enterprise App** and then **New Application**.

2. Under **Add from the gallery**, type in `Dynatrace`. Select the search result then select **Create**.
1. Under **Add from the gallery**, type in `Dynatrace`. Select the search result then select **Create**.

:::image type="content" source="media/dynatrace-how-to-configure-prereqs/dynatrace-gallery.png" alt-text="Screenshot of the Dynatrace service in the Marketplace gallery.":::

3. Once the app is created, go to properties from the side panel, and set the **User assignment required?** to **No**, then select **Save**.
1. Once the app is created, go to properties from the side panel, and set the **User assignment required?** to **No**, then select **Save**.

:::image type="content" source="media/dynatrace-how-to-configure-prereqs/dynatrace-properties.png" alt-text="Screenshot of the Dynatrace service properties.":::

4. Go to **Single sign-on** from the side panel. Then select **SAML**.
1. Go to **Single sign-on** from the side panel. Then select **SAML**.

:::image type="content" source="media/dynatrace-how-to-configure-prereqs/dynatrace-single-sign-on.png" alt-text="Screenshot of the Dynatrace single sign-on settings.":::

5. Select **Yes** when prompted to **Save single sign-on settings**.
1. Select **Yes** when prompted to **Save single sign-on settings**.

:::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.":::

Expand Down
17 changes: 9 additions & 8 deletions articles/partner-solutions/dynatrace/dynatrace-how-to-manage.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,9 +39,9 @@ If you select the **Monitoring** pane, you see a table with information about th

The columns in the table denote important information for your resource:

- **Resource type** - Azure resource type
- **Total resources** - Count of all resources for the resource type
- **Logs to Dynatrace** - Count of resources sending logs to Dynatrace through the integration
- **Resource type** - Azure resource type.
- **Total resources** - Count of all resources for the resource type.
- **Logs to Dynatrace** - Count of resources sending logs to Dynatrace through the integration.

## Reconfigure rules for logs

Expand All @@ -63,13 +63,13 @@ The column **Logs to Dynatrace** indicates whether the resource is sending logs

- _Resource doesn't support sending logs_ - Only resource types with monitoring log categories can be configured to send logs. See [supported categories](/azure/azure-monitor/essentials/resource-logs-categories).
- _Limit of five diagnostic settings reached_ - Each Azure resource can have a maximum of five diagnostic settings. For more information, see [diagnostic settings](/azure/azure-monitor/essentials/diagnostic-settings).
- _Error_ The resource is configured to send logs to Dynatrace, but is blocked by an error.
- _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.

## Monitor virtual machines using Dynatrace OneAgent

You can install Dynatrace OneAgent on virtual machines as an extension. Select **Virtual Machines** under **Dynatrace environment config** in the Resource menu on the left. In the working pane, you see a list of all virtual machines in the subscription.
You can install Dynatrace OneAgent on virtual machines as an extension. Select **Virtual Machines** under **Dynatrace environment config** in the Resource menu. In the working pane, you see a list of all virtual machines in the subscription.

For each virtual machine, the following info is displayed:

Expand All @@ -81,14 +81,14 @@ For each virtual machine, the following info is displayed:
| **Agent 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 |
| **Monitoring mode** | Whether the Dynatrace OneAgent is monitoring hosts in [full-stack monitoring mode or infrastructure monitoring mode{.underline}](https://www.dynatrace.com/support/help/how-to-use-dynatrace/hosts/basic-concepts/get-started-with-infrastructure-monitoring) |
| **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.
## Monitor App Services using Dynatrace OneAgent

You can install Dynatrace OneAgent on App Services as an extension. Select **App Services** in the Resource menu on the left. In the working pane, you see This screen a list of all App Services in the subscription.
You can install Dynatrace OneAgent on App Services as an extension. Select **App Services** in the Resource menu. In the working pane, you see This screen a list of all App Services in the subscription.

For each app service, the following information is displayed:

Expand Down Expand Up @@ -118,7 +118,8 @@ To establish single sign-on or change the application, select **Enable single si

## Delete Dynatrace resource

Select **Overview** in Resource menu on the left. Then, select **Delete**. Confirm that you want to delete the Dynatrace resource. Select **Delete**.
Select **Overview** in Resource menu. Then, select **Delete**. Confirm that you want to delete the Dynatrace resource. Select **Delete**.

:::image type="content" source="media/dynatrace-how-to-manage/dynatrace-delete.png" alt-text="Screenshot showing overview in resource menu with a box around delete.":::

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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ When you use the integrated experience for Dynatrace in the Azure portal, your b

Before you link the subscription to a Dynatrace environment, [complete pre-deployment configuration](dynatrace-how-to-configure-prereqs.md).

## Find Offer
### Find Offer

1. Use the Azure portal to find Dynatrace.

Expand Down Expand Up @@ -58,7 +58,7 @@ Before you link the subscription to a Dynatrace environment, [complete pre-deplo
|**Property** | **Description** |
|---------|---------|
| Subscription | Select the Azure subscription 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](/azure/azure-resource-manager/management/overview#resource-groups) 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/azure-resource-manager/management/overview#resource-groups) 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 | The Azure portal displays a list of existing environments that can be linked. Select the desired environment from the available options. |
Expand Down
4 changes: 2 additions & 2 deletions articles/partner-solutions/dynatrace/dynatrace-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@ Dynatrace for Azure provides the following capabilities:

- **Unified billing** - Get a single bill for all the resources you consume on Azure, including Dynatrace.

- **Single-Sign on to Dynatrace** - You need not sign-up or login separately to Dynatrace. Login once in the Azure portal and seamlessly transition to Dynatrace portal when needed.
- **Single-Sign on to Dynatrace** - You need not sign up or sign in separately to Dynatrace. Sign in once in the Azure portal and seamlessly transition to Dynatrace portal when needed.

- **Log forwarder** - Enables automated forwarding of subscription activity and resource logs to Dynatrace

- **Easily manage Dynatrace OneAgent on VMs and App Services** - Provides a single pane of glass to install and uninstall Dynatrace OneAgent on virtual machines and App Services.
- **Manage Dynatrace OneAgent on VMs and App Services** - Provides a single experience to install and uninstall Dynatrace OneAgent on virtual machines and App Services.

## Dynatrace Links

Expand Down
6 changes: 3 additions & 3 deletions articles/partner-solutions/dynatrace/index.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
### YamlMime:Landing

title: Dynatrace for Azure
summary: Dynatrace for Azure from the Azure Marketplace enables you to create and manage Dynatrace environments using the Azure portal with a integrated experience.
summary: Dynatrace for Azure provides a native integrated experience that enables you to create and manage Dynatrace environments from Azure.

metadata:
title: Dynatrace for Azure documentation
Expand All @@ -15,7 +15,7 @@ metadata:

landingContent:
# Card (optional)
- title: About Dynatrace with Azure
- title: About Dynatrace for Azure
linkLists:
- linkListType: overview
links:
Expand All @@ -25,7 +25,7 @@ landingContent:
links:
- text: Complete the prerequisites for Dynatrace
url: dynatrace-how-to-configure-prereqs.md
- text: Manage the Dynatrace for Azure resource with the portal
- text: Manage the Dynatrace resource with the portal
url: dynatrace-how-to-manage.md

# Card
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion bread/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -316,7 +316,7 @@
topicHref: /azure/partner-solutions/logzio/overview
- name: Dynatrace
tocHref: /azure/partner-solutions/dynatrace/
topicHref: /azure/partner-solutions/nginx/dynatrace-overview
topicHref: /azure/partner-solutions/dynatrace/dynatrace-overview
- name: NGINX
tocHref: /azure/partner-solutions/nginx/
topicHref: /azure/partner-solutions/nginx/nginx-overview
Expand Down

0 comments on commit df636c4

Please sign in to comment.