diff --git a/powerquery-docs/connectors/dynatrace-grail-dql.md b/powerquery-docs/connectors/dynatrace-grail-dql.md index 4de905a6d..bb10298e8 100644 --- a/powerquery-docs/connectors/dynatrace-grail-dql.md +++ b/powerquery-docs/connectors/dynatrace-grail-dql.md @@ -32,6 +32,11 @@ Follow the instructions to set up a Dynatrace SaaS environment. Make sure the en - Import mode only - Option to enter a DQL query when connecting—limited to a maximum of 1 million rows +- Advanced options + - Read data limit + - Record limit + - Result size limit + - Sampling ## Connection to Dynatrace Grail from Power BI Desktop @@ -45,43 +50,95 @@ To connect to a Dynatrace SaaS instance from Power Query Desktop, take the follo :::image type="content" source="./media/dynatrace-grail-dql/connector3-white.png" alt-text="Screenshot of the environment entry dialog box for the Dynatrace tenant to connect to."::: -3. Sign into your environment to authenticate your permissions. +3. If you want to use any **advance options**, select the option and enter the data to use with that option. More information: [Connect using advanced options](#connect-using-advanced-options) + +4. Sign into your environment to authenticate your permissions. :::image type="content" source="./media/dynatrace-grail-dql/connector4-white.png" alt-text="Screenshot of the Power Query authentication dialog when you sign in."::: -4. A browser window pops up that requires you to enter your credentials. +5. A browser window pops up that requires you to enter your credentials. :::image type="content" source="./media/dynatrace-grail-dql/connector5-white.png" alt-text="Screenshot of the Windows authenticated user account to select."::: -5. Once you successfully authenticate, the message shows that you're currently signed in. Select **Connect**. +6. Once you successfully authenticate, the message shows that you're currently signed in. Select **Connect**. :::image type="content" source="./media/dynatrace-grail-dql/connector6-white.png" alt-text="Screenshot of a successfully signed in dialog box."::: -6. The Navigator screen shows the record types available to select from Dynatrace Grail. +7. The Navigator screen shows the record types available to select from Dynatrace Grail. :::image type="content" source="./media/dynatrace-grail-dql/connector7-white.png" alt-text="Sample screenshot of record types available in Dynatrace Grail."::: -7. Selecting one of them logs in this example, and runs a fetch logs DQL query with a default 1000 row limit. You require permissions on the Dynatrace environment in order to run this query successfully. +8. Selecting one of them logs in this example, and runs a fetch logs DQL query with a default 1000 row limit. You require permissions on the Dynatrace environment in order to run this query successfully. :::image type="content" source="./media/dynatrace-grail-dql/connector8-white.png" alt-text="Sample screenshot of a resultant DQL log query from Dynatrace Grail." lightbox="./media/dynatrace-grail-dql/connector8-white.png"::: -8. The advanced editor shows the M code the connector is using. +9. The advanced editor shows the M code the connector is using. :::image type="content" source="./media/dynatrace-grail-dql/connector9-white.png" alt-text="Screenshot of the connector in Power Query M code."::: -9. An optional step when connecting is to type in a DQL query directly. The following example fetches logs (default last 2 hours) with a limit of 1,000 rows. +10. An optional step when connecting is to type in a DQL query directly. The following example fetches logs (default last 2 hours) with a limit of 1,000 rows. :::image type="content" source="./media/dynatrace-grail-dql/connector10-white.png" alt-text="Screenshot of a sample DQL query that can be used in the connector."::: -10. The resulting import into Power BI looks similar to this example. +11. The resulting import into Power BI looks similar to this example. :::image type="content" source="./media/dynatrace-grail-dql/connector11-white.png" alt-text="Screenshot of a sample set of Log rows imported into Power BI." lightbox="./media/dynatrace-grail-dql/connector11-white.png"::: +## Connect to Dynatrace Grail from Power Query Online + +To connect to Dynatrace Grail DQL from Power Query Online: + +1. Select the **Dynatrace Grail DQL** option in the get data experience. Different apps have different ways of getting to the Power Query Online get data experience. For more information, go to [Where to get data](../where-to-get-data.md). + + :::image type="content" source="./media/dynatrace-grail-dql/connector12-white.png" alt-text="Screenshot of the Get Data dialog in Power Query Online to connect to Dynatrace Grail."::: + +2. Enter your Dynatrace environment. This environment 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 built in queries. + + :::image type="content" source="./media/dynatrace-grail-dql/connector13-white.png" alt-text="Screenshot of the environment entry dialog box in Power Query Online for the Dynatrace tenant to connect to."::: + +3. If you want to use any **advance options**, select the option and enter the data to use with that option. More information: [Connect using advanced options](#connect-using-advanced-options) + +4. Sign into your environment to authenticate your permissions. **Sign in** with an organizational account. + +5. After you've successfully signed in, select **Next**. + +6. The Navigator screen shows the record types available to select from Dynatrace Grail. + + :::image type="content" source="./media/dynatrace-grail-dql/connector14-white.png" alt-text="Sample screenshot of record types available in Power Query Online in Dynatrace Grail."::: + +7. Selecting one of them logs in this example, and runs a fetch logs DQL query with a default 1000 row limit. You require permissions on the Dynatrace environment in order to run this query successfully. + + :::image type="content" source="./media/dynatrace-grail-dql/connector15-white.png" alt-text="Sample screenshot of a resultant DQL log query from Dynatrace Grail in Power Query Online." lightbox="./media/dynatrace-grail-dql/connector15-white.png"::: + +8. An optional step when connecting is to type in a DQL query directly. The following example fetches logs (default last 2 hours) with a limit of 50 rows. + + :::image type="content" source="./media/dynatrace-grail-dql/connector16-white.png" alt-text="Screenshot of a sample DQL query that can be used in the connector in Power Query Online."::: + +9. The resulting import into Power BI looks similar to this example. + + :::image type="content" source="./media/dynatrace-grail-dql/connector17-white.png" alt-text="Screenshot of a sample set of Log rows imported into Power Query Online." lightbox="./media/dynatrace-grail-dql/connector17-white.png"::: + +### Connect using advanced options + +Both Power Query Desktop and Power Query Online provide a set of advanced options that you can add to your query if needed. + +The following table lists all of the advanced options you can set in Power Query Desktop and Power Query Online. + + +| Advanced option | Description | +|-----------------------|--------------------------------------------------------------------------------| +| Read data limit | Limit in gigabytes for the amount of data that will be scanned during read. Note: Increasing this limit can increase associated costs. | +| Record limit | The maximum number of result records that this query will return. Note: Increasing the maximum can result in longer run times. | +| Result size limit | The maximum number of result bytes that this query will return. Note: Increasing the maximum can affect performance. | +| Sampling | Results in the selection of a subset of Log or Span records. | + + + ### 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 + - Connect to the environment + - Run DQL queries against the Dynatrace platform diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector10-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector10-white.png index b6d6eb68b..b1e331008 100644 Binary files a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector10-white.png and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector10-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector12-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector12-white.png new file mode 100644 index 000000000..6082d8f0d Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector12-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector13-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector13-white.png new file mode 100644 index 000000000..fd8dd3f1b Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector13-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector14-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector14-white.png new file mode 100644 index 000000000..09fdf2829 Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector14-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector15-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector15-white.png new file mode 100644 index 000000000..71784f38d Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector15-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector16-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector16-white.png new file mode 100644 index 000000000..6ec35af15 Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector16-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector17-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector17-white.png new file mode 100644 index 000000000..bbf19972a Binary files /dev/null and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector17-white.png differ diff --git a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector3-white.png b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector3-white.png index 9540ce6eb..fc07acfa9 100644 Binary files a/powerquery-docs/connectors/media/dynatrace-grail-dql/connector3-white.png and b/powerquery-docs/connectors/media/dynatrace-grail-dql/connector3-white.png differ