dt-dql-essentials

Clarify and enforce correct DQL syntax for Dynatrace Grail queries.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/virtualrussel/dynatrace-ai-workspace --skill dt-dql-essentials-virtualrussel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dt-dql-essentials
Source: https://github.com/virtualrussel/dynatrace-ai-workspace/tree/main/.agents/skills/dt-dql-essentials
Command: npx skills add https://github.com/virtualrussel/dynatrace-ai-workspace --skill dt-dql-essentials-virtualrussel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

DQL users frequently struggle with syntax, patterns, and common pitfalls, and this skill provides authoritative guidance to prevent errors and improve query quality.

Core Features & Use Cases

  • Comprehensive DQL syntax rules and reference patterns
  • Practical examples and best-practice patterns for time series, arrays, and lookups
  • A ready-to-use quick-start prompt to accelerate safe DQL experimentation

Quick Start

Run a simple DQL query to fetch logs from the last hour and apply a safe filter.

Frequently Asked Questions about dt-dql-essentials

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a basic DQL query to fetch Dynatrace logs from the last hour?

To fetch logs with DQL, you apply a time range filter to the last hour and use safe syntax patterns to query your Dynatrace Grail data, preventing common query mistakes.

What are the most common DQL syntax mistakes when querying Dynatrace Grail data?

Common DQL syntax mistakes often involve incorrect patterns for time series, arrays, and lookups, which you can prevent by following canonical syntax rules and best-practice references.

Can I use DQL to query spans, metrics, and smartscape data during incident triage?

Yes, DQL applies to Dynatrace Grail users querying logs, spans, metrics, and smartscape data across development, testing, and incident triage scenarios using correct syntax patterns.

What is the best way to filter time series data in DQL without causing query errors?

The best way to filter time series data in DQL is to use established best-practice patterns and canonical syntax rules, ensuring safe query experimentation and preventing errors.

How do DQL lookup patterns work when joining data in Dynatrace?

DQL lookup patterns work by applying specific reference syntax to join and enrich your Dynatrace Grail data, with practical examples available to guide correct usage and prevent errors.