1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | dt-dql-essentials |
| 作者/维护者 | Dynatrace（GitHub 官方组织，纽约证券交易所上市可观测性厂商） |
| 来源链接 | https://github.com/Dynatrace/dynatrace-for-ai/tree/main/skills/dt-dql-essentials |
| 许可证 | Apache-2.0（GitHub API 获取） |
| GitHub Stars / Forks | 115 / 23（GitHub API 获取；为 dynatrace-for-ai 技能合集仓库整体数据，非本子技能个体数据，详见第 7 章前说明） |
| 最新版本 | v5.0.0（2026-07-07 发布，GitHub Releases 获取） |
| 安装方式 | npx skills add dynatrace/dynatrace-for-ai，或 Claude Code 插件市场一键安装，或手动复制技能目录 |
2. 功能介绍与亮点
DQL（Dynatrace Query Language）是一种管道式查询语言，语法与 SQL 差异较大。dt-dql-essentials 是 Dynatrace 官方技能合集里明确标注“写任何 DQL 前必须加载”的基础参考技能，核心内容包括：
- fetch 命令、字段命名空间、数据模型与时间对齐规则
- 实体/Smartscape 拓扑导航、指标发现模式
- 查询优化技巧：提前过滤、桶过滤、缩短时间范围、字段裁剪、采样与基数控制——直接降低查询扫描量与消耗成本
- 一份结构化的 DQL 命令/函数参考索引（聚合、数组、位运算、类型转换、字符串、时间等分类齐全）
技能本身完全由 Markdown 文档与参考资料构成，不含可执行脚本；遵循开放的 Agent Skills 规范（agentskills.io），并非 Dynatrace 私有格式。自 2026-04 首个公开版本以来三个月内发布五个大版本，持续新增 Kubernetes、云平台、安全态势、成本分析等配套子技能。
3. 适用场景
固定分类：DevOps 与基础设施
- 已在使用 Dynatrace 监控云基础设施、Kubernetes、应用服务或安全态势的 DevOps/SRE 工程师，在用 Claude Code 等 Agent 编写 DQL 查询时加载
- 需要排查现有 DQL 查询报错，或降低查询扫描量与费用的团队
- 熟悉 Dynatrace 平台功能但不熟悉 DQL 语法细节的初中级用户，借助 Agent + 本技能减少试错
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——仓库提供
.claude-plugin目录、插件市场安装命令，并内置 MCP Server 配置 - Codex：❓ 未验证——README 声明遵循 agentskills.io 开放规范并适配“30+ 工具”，但未见明确点名 Codex 的证据
- OpenClaw：❓ 未验证——同上，未见明确点名
- Hermes Agent：❓ 未验证——同上，未见明确点名
（仅基于已抓取的 README 与仓库结构判断，未为兼容性单独发起搜索）
5. 推荐理由
Dynatrace 官方出品的 DQL 查询语法与省成本参考，减少 Agent 查询语法错误与消耗。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Dynatrace 为纽约证券交易所上市的一线可观测性厂商官方出品；该子技能自身有独立版本迭代记录，且有外部开发者通过 Issue/PR 参与扩展 |
| 可用性 | 8 | 一条命令安装，文档详尽且含明确的“何时加载/何时不用”路由说明，最近一次内容更新在近两周内；但需拥有 Dynatrace 平台账号与 API Token 才能实际执行查询，并非零门槛 |
| 安全性 | 9 | SKILL.md 与全部 references 均为纯 Markdown 参考资料，无脚本、无自动联网；凭据仅用于用户自愿另行连接的官方 MCP Server；仓库 Apache-2.0 完全开源可审计，未发现可疑指令 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令及权限范围 | 本子技能不含任何脚本或 shell 命令 |
| ② 联网外发数据 | 技能内容本身不发起网络请求；仅用户另行连接官方 MCP Server 时才查询自己的租户，行为透明 |
| ③ API key/凭据 | 通过标准环境变量提供，用于官方 MCP Server，非阅读本技能内容所必需 |
| ④ 可疑指令 | 通读全文及多个参考文件，未发现越权操作或隐蔽外发指令 |
| ⑤ 作者信誉 | Dynatrace 为上市公司官方 GitHub 组织，多名具名员工持续提交 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 维护时间 | 最近一次仓库更新在近一天内，抓取当下仍在活跃迭代 |
7. 跟同类 Skills 相比的优势
（dynatrace-for-ai 是多技能合集仓库，仓库整体 115 stars 代表全部 25 个子技能的合计热度，不代表 dt-dql-essentials 单个子技能的个体热度）
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| Datadog dd-apm | Datadog 官方 APM 排查技能 | 聚焦 Datadog 平台的 APM/追踪排查流程，不涉及某个查询语言本身的语法教学 |
| Grafana OSS | Grafana 开源可视化平台官方技能 | 面向仪表盘搭建与开源查询生态，不覆盖 Dynatrace 专有的 DQL 语法体系 |
| HashiCorp Terraform Style Guide | IaC 代码规范类技能 | 关注基础设施代码书写规范，不涉及可观测性数据查询 |
| AWS Core | AWS 云资源操作技能 | 覆盖 AWS 云服务管理操作，而非特定可观测性平台的查询语言细节 |
现有同类技能多聚焦“如何操作平台功能”，dt-dql-essentials 则专门补齐“平台专有查询语言语法与省成本技巧”这一层知识，二者互补而非替代。
8. 用户评价
GitHub 用户 agardnerIT 在实际使用中记录了排查 Dynatrace Workflows 集成 action 命名错误的完整过程，并据此向仓库提出新增配套子技能的详细提案（含 YAML 结构、常见 action 速查表），随后提交了对应 Pull Request，体现出真实生产场景下的深度参与和反馈闭环。
9. 其他补充
仓库文档以英文为主；技能合集当前覆盖 25 个细分领域（Kubernetes、AWS/Azure/GCP、移动端、安全态势、成本分析、GenAI 可观测性等）；接受社区 Pull Request 贡献；版本历史显示三个月内五次迭代，每次均新增实质性覆盖范围。
10. 安装使用方式
方式一（推荐）：Skills Package
npx skills add dynatrace/dynatrace-for-ai适配 Claude Code、Cursor、Cline、GitHub Copilot、OpenCode 等。
方式二：Claude Code 插件市场
claude plugin marketplace add dynatrace/dynatrace-for-ai
claude plugin install dynatrace@dynatrace-for-ai安装后如需让配套 MCP Server 连接真实租户，需设置环境变量 DT_ENVIRONMENT 与 DT_PLATFORM_TOKEN；仅使用 dt-dql-essentials 本身的查询语法知识则无需任何凭据。更新命令：
claude plugin marketplace update && claude plugin update dynatrace@dynatrace-for-ai方式三：手动安装
将 skills/dt-dql-essentials 目录复制到 .claude/skills/、.cursor/skills/ 等 Agent 技能目录。
11. 注意事项
- 本技能提供的是查询语法与优化知识，不包含执行查询的能力；要连接自己的 Dynatrace 环境实际运行查询，需另行拥有 Dynatrace 平台账号与 API Token
- 内容专精于 DQL 本身；仓库中还有另外 24 个更细分的子技能（如 Kubernetes、安全态势、成本分析等），按需搭配加载效果更佳
- 跨 Agent 兼容性除 Claude Code 外均未验证，Codex / OpenClaw / Hermes Agent 用户请自行测试后使用