Summarize and explain queries with Davis CoPilot
- Latest Dynatrace
- Tutorial
- Published Mar 12, 2024
You can use Davis CoPilot in Dashboards and Notebooks to translate DQL into natural language. Davis CoPilot can provide a summary as well as a detailed explanation of any existing DQL queries.
Who this is for
This article is for any users who want to better understand or better DQL queries, or who want to familiarize themselves with DQL.
What you will learn
In this article, you'll learn how to use Davis CoPilot to summarize and explain DQL queries.
Before you begin
Davis CoPilot explanations are session-based and may vary in structure. This means that explanations don’t persist across sessions, so you’ll need to regenerate them after a session ends. While Davis CoPilot often provides line-by-line explanations, it may instead group related lines into meaningful chunks (for example, when multiple lines form a single command or function).
Prior knowledge
Prerequisites
- Dynatrace SaaS environment.
- You have the
ALLOW davis-copilot:dql2nl:execute;permission. To learn how to set up the permissions, see Permissions in Grail. - You have completed the Davis CoPilot setup described in Getting started with Davis CoPilot.
Explain queries with Davis CoPilot in Notebooks
- Go to
Notebooks and open a notebook you can edit. - Select a notebook section that contains a query you want to summarize or explain.
- Open the menu and select Explain query with AI. A summary followed by a detailed explanation is generated under the query input field.
Explain queries with Davis CoPilot in Dashboards
- Go to
Dashboards and open a dashboard you can edit. - Select a dashboard that contains a DQL query you want to summarize or explain.
- Select Edit to open the edit menu on the right.
- In the DQL section of the edit menu, select Explain query with AI. A summary followed by a detailed explanation is generated under Run.
Give feedback
To help us improve Davis CoPilot, you can provide feedback directly from your notebook or dashboard. Under the generated explanation box:
- Select
if Davis CoPilot has interpreted the query correctly and has generated an adequate explanation that meets your expectations. - Select
if Davis CoPilot has has incorrectly interpreted the DQL query or generated a query explanation that has failed to meet your expectations. Please provide additional context for us to understand how we can improve this functionality to meet your needs and expectations.
Do not share personal or confidential information in your feedback.