dt-dql-essentials

Provide DQL syntax rules and pitfalls for logs, spans, and time-series data.

2|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/israel-salgado/dt-mcp-server --skill dt-dql-essentials-israel-salgado
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dt-dql-essentials
Source: https://github.com/israel-salgado/dt-mcp-server/tree/main/.agents/skills/dt-dql-essentials
Command: npx skills add https://github.com/israel-salgado/dt-mcp-server --skill dt-dql-essentials-israel-salgado

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides canonical DQL syntax, pitfalls, and patterns to help users write correct, safe queries and avoid common mistakes.

Core Features & Use Cases

  • DQL syntax rules and best practices for writing queries across logs, spans, and metrics.
  • Common pitfalls to avoid (e.g., improper field access, incorrect timeframes, and unsafe joins).
  • Guidance and references to workspace conventions and pattern examples to accelerate investigations.

Quick Start

Start with a basic DQL example to validate syntax and patterns.

Frequently Asked Questions about dt-dql-essentials

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

FAQPage Schema
What are the most common DQL pitfalls when querying logs and metrics in the Grail workspace?

Common DQL pitfalls include improper field access, incorrect timeframes, and unsafe joins. Avoiding these mistakes ensures correct query writing and safe, efficient investigations across logs, spans, and metrics in the Grail workspace.

How do I write safe DQL queries for time-series data?

To write safe DQL queries for time-series data, follow canonical syntax rules, enforce proper loading order, and align with workspace conventions. This guides safe, efficient investigations and prevents common mistakes.

Does this DQL reference cover best practices for querying spans and logs?

Yes, this reference provides canonical DQL syntax rules and best practices for writing queries across logs, spans, and time-series metrics. It recommends patterns from references to help accelerate your workspace investigations safely.

What is the correct loading order for DQL syntax in the Grail workspace?

Correct DQL loading order is enforced to ensure proper query execution and prevent syntax errors. Aligning with these workspace conventions and reference patterns guides safe, efficient investigations across your data.

Why is my DQL query failing due to improper field access or unsafe joins?

DQL queries often fail due to improper field access, incorrect timeframes, or unsafe joins. Using canonical syntax rules and recommended patterns helps avoid these common pitfalls and ensures correct, safe query writing.