dt-app-notebooks

Create, modify, query, and analyze Dynatrace notebook JSON documents with DQL sections.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/ricardojjulia/ESACompanion --skill dt-app-notebooks-ricardojjulia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dt-app-notebooks
Source: https://github.com/ricardojjulia/ESACompanion/tree/main/.github/skills/dt-app-notebooks
Command: npx skills add https://github.com/ricardojjulia/ESACompanion --skill dt-app-notebooks-ricardojjulia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Working with Dynatrace notebooks requires understanding a specific JSON document structure with ordered sections, DQL queries, and visualization settings. This Skill guides the creation, modification, querying, and analysis of notebook documents while enforcing validation rules that prevent common errors like overwriting user edits or deploying invalid queries. ## Core Features & Use Cases - Notebook Creation & Updates: Follows a mandatory 7-step workflow including DQL validation with dtctl, downloading existing notebooks before updates, and deploying with dtctl apply. - Notebook Analysis: Extracts queries, titles, visualizations, and thresholds from notebook JSON, and identifies notebook purpose from section content. - Visualization Guidance: Documents required field types for each visualization (lineChart, categoricalBarChart, singleValue, honeycomb, maps, and more) plus per-visualization settings references. - Use Case: A site reliability engineer needs a service health notebook with RED metrics. The Skill loads domain knowledge first, validates each DQL query against the tenant, builds the section JSON, and deploys it with a shareable URL. ## Quick Start Ask the assistant to create a Dynatrace notebook showing error counts and response times for your services using validated DQL queries.

Frequently Asked Questions about dt-app-notebooks

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

FAQPage Schema
How do I create a Dynatrace notebook with DQL queries?▼

Define the notebook purpose, load relevant domain skills, validate every DQL query with dtctl query, then build the JSON with markdown and dql sections and deploy using dtctl apply. Validation runs automatically during deployment.

How do I update an existing Dynatrace notebook without losing changes?▼

Always download the current notebook first with dtctl get notebook <id> -o json --plain, modify that downloaded file, and redeploy it. Building fresh JSON or injecting an id manually silently overwrites UI edits made since the last deployment.

Which visualization types do Dynatrace notebooks support?▼

Notebooks support time-series charts (lineChart, areaChart, barChart, bandChart), categorical charts (categoricalBarChart, pieChart, donutChart), singleValue, table, histogram, honeycomb, geographic maps, heatmap, and scatterplot. Each requires specific field types in the query result.

Why does my notebook section render blank or fail validation?▼

The query result field types do not match the visualization requirements. For example, barChart needs a timestamp axis, so summarize by category without a time field fails; use categoricalBarChart instead. Setting autoSelectVisualization to true avoids most mismatches.

Can I use hardcoded time filters in notebook DQL queries?▼

Yes, hardcoded time filters are allowed in notebook queries. The notebook default timeframe is set in content.defaultTimeframe, and each section can override it via section.state.input.timeframe.