Added Dynatrace Grail DQL md file and images

powerquery-docs/connectors/dynatrace-grail-dql.md

@@ -0,0 +1,126 @@
+---
+title: Connect PowerBI to Dynatrace Grail
+description: The connector allows PowerBI users to access a Dynatrace environment on which they have the necessary permissions to run DQL queries.
+author: gordon-dt
+ms.date: 
+ms.author: 
+---
+
+# Microsoft documentation to connect PowerBI to Dynatrace Grail.
+
+The following connector article is provided by Dynatrace, the owner of
+this connector and a member of the Microsoft Power Query Connector
+Certification Program. If you have questions regarding the content of
+this article or have changes you would like to see made to this article,
+visit the Dynatrace website and use the support channels there.
+
+|Item|                                Description|
+------|----------------------------------------------------------------
+|Release State|                       Pre-Release|
+|Products|                            PowerBI (Semantic Models)|
+|Authentication Types Supported|      Windows (Power BI Desktop)|
+|Function Reference Documentation|    Source|
+
+## Prerequisites
+
+### Dynatrace environment
+
+It is assumed that a Dynatrace environment is already configured for
+connection from PowerBI Desktop.
+
+On Microsoft Azure that can be done through the Marketplace and
+searching for: **Azure Native Dynatrace Service**
+
+Follow the instruction to set up a Dynatrace SaaS environment and make
+sure the environment is set to the new version and not previous classic
+as the latest version contains a Grail data lakehouse and is set up for
+the authentication requirements for the connector.
+
+### Setting up the connector
+
+Please follow the steps below to set up the Dynatrace Grail DQL
+Connector for the Power BI Desktop.
+
+Installing the MEZ file requires lowering security on PowerBI Desktop.
+To achieve the same without lowering the security you would need the
+"Dynatrace Grail DQL.pqx" file and the registry thumbprint which is
+available on request from Dynatrace.
+
+1.  Copy the connector file ("Dynatrace Grail DQL.mez") to the folder
+    \\Documents\\Power BI Desktop\\Custom Connectors. Create folders if
+    needed.
+
+2.  In Power BI Desktop, go to Options. On the Security tab, change Data Extensions to Not Recommended, as in the picture below.
+
+![Security setting](./media/dynatrace-grail-dql/sec1.png)
+
+--------------------------------------------------------
+## Capabilities Supported
+
+| Number | Capability                                  |
+| ------ | ------------------------------------------- |
+| 1      | Import mode only                            |
+| 2      | Option to enter a DQL query when connecting - limited to a maximum of 1 million rows. |
+--------------------------------------------------------
+
+## Connection to Dynatrace Grail from PowerBI Desktop
+
+To connect to a Dynatrace SaaS instance from Power Query Desktop, take
+the following steps:
+
+1) Select **Dynatrace Grail DQL** in the get data experience.
+
+![get data](./media/dynatrace-grail-dql/connector1_white.png)
+
+2) While the connector is being certified you will need to accept this notification of a 3rd party service.
+
+![third party](./media/dynatrace-grail-dql/connector2_white.png)
+
+3) Enter your Dynatrace environment. Note that this needs to be the latest Dynatrace version with Grail enabled. The DQL query is optional at this point, but should be used for more complex queries outside of the default queries built in.
+
+![dt environment](./media/dynatrace-grail-dql/connector3_white.png)
+
+4) The next screen will require you to sign into your environment to authenticate your permissions.
+
+![authenticate](./media/dynatrace-grail-dql/connector4_white.png)
+
+5) A browser window will pop up requiring your credentials.
+
+![credentials](./media/dynatrace-grail-dql/connector5_white.png)
+
+6) Once you have successfully authenticated, the message will show that you are currently signed in.Click Connect.
+
+![connect](./media/dynatrace-grail-dql/connector6_white.png)
+
+7) The Navigator screen will show the record types available to select from Dynatrace Grail.
+
+![records](./media/dynatrace-grail-dql/connector7_white.png)
+
+8. Selecting one of them, Logs in this example, will run a fetch logs DQL query with a default 1000 row limit. Note that you will require permissions on the Dynatrace environment in order to be able to run this query successfully.
+
+![logs](./media/dynatrace-grail-dql/connector8_white.png)
+
+1) The Advanced Editor shows the M code the connector is using.
+
+![connector](./media/dynatrace-grail-dql/connector9_white.png)
+
+10)  An optional step when connecting is to type in a DQL query directly. In this example fetch logs (default last 2 hours) with a limit of 1000 rows.
+
+![dql](./media/dynatrace-grail-dql/connector10_white.png)
+
+11) The resulting import into PowerBI will look similar to this.
+
+![show](./media/dynatrace-grail-dql/connector11_white.png)
+
+### Troubleshooting
+
+-   The latest version ("New" not "Classic") of Dynatrace SaaS is
+    required.
+
+-   The correct permissions outlined in [Dynatrace
+    documentation](https://docs.dynatrace.com/docs/platform/grail/data-model/assign-permissions-in-grail)
+    are required to be able to:
+
+    -   Connect to the environment
+
+    -   Run DQL queries against the Dynatrace platform

powerquery-docs/connectors/index.md

@@ -106,6 +106,7 @@ The connectors are listed in alphabetical order in separate tables for each lett
 | :::image type="content" border="false" source="media/index/dynamics365-64.png" alt-text="Dynamics 365 (Dataverse)." link="./dataverse.md"::: [<br/>**Dynamics 365 (Dataverse)**](./dataverse.md)<br/>By Microsoft                                                                                          | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Excel":::                    | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynamics 365 (Dataverse) in Power BI (Semantic models)":::                    | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Power BI (Dataflows)":::                    | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Fabric (Dataflow Gen2)":::                    | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Power Apps (Dataflows)":::                    | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Customer Insights (Dataflows)":::                    | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 (Dataverse) in Analysis Services":::                    |
 | :::image type="content" border="false" source="media/index/dynamics365-64.png" alt-text="Dynamics 365 Online (legacy).":::<br/>**Dynamics 365<br/>Online (legacy)**<br/>By Microsoft                                                                                                                       | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynamics 365 Online (legacy) in Excel":::                   | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynamics 365 Online (legacy) in Power BI (Semantic models)":::                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 Online (legacy) in Power BI (Dataflows)":::                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 Online (legacy) in Fabric (Dataflow Gen2)":::                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 Online (legacy) in Power Apps (Dataflows)":::                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics 365 Online (legacy) in Customer Insights (Dataflows)":::                | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynamics 365 Online (legacy) in Analysis Services":::                   |
 | :::image type="content" border="false" source="media/index/dynamics-nav-64.png" alt-text="Dynamics NAV.":::<br/>**Dynamics NAV**<br/>By Microsoft                                                                                                                                                          | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Excel":::                                | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynamics NAV in Power BI (Semantic models)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Power BI (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Fabric (Dataflow Gen2)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Power Apps (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Customer Insights (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynamics NAV in Analysis Services":::                                |
+| :::image type="content" border="false" source="media/index/dynatracegray64.png" alt-text="Dynatrace Grail DQL":::<br/>**Dynatrace Grail DQL**<br/>By Dynatrace                                                                                                                                                          | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Excel":::                                | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Dynatrace Grail DQL in Power BI (Semantic models)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Power BI (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Fabric (Dataflow Gen2)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Power Apps (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Customer Insights (Dataflows)":::                                | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Dynatrace Grail DQL in Analysis Services":::                                |
 
 ## E
 

powerquery-docs/toc.yml

@@ -395,6 +395,8 @@ items:
         href: connectors/digital-construction-works-insights.md
       - name: "Dynamics 365 Online (legacy)"
         href: connectors/dynamics-365-online.md
+      - name: "Dynatrace Grail DQL"
+        href: connectors/dynatrace-grail-dql.md
       - name: "Eduframe (Beta)"
         href: connectors/eduframe.md
       - name: "Emplifi Metrics (Deprecated)"