Dynatrace Notebook Skill

How to Use This Skill

Notebooks and dashboards are structurally similar. Follow the dt-app-dashboards skill for all workflows (creating, modifying, querying, analyzing), applying the differences documented below.

Mandatory Create/Update Workflow

1. Load domain skills BEFORE generating queries — do not invent DQL
2. Validate ALL queries via dtctl query '<DQL>' --plain before adding to the notebook
3. Always set "autoSelectVisualization": true in visualizationSettings unless the user explicitly requests a specific visualization type
4. ALWAYS deploy via deploy_notebook.sh — never use dtctl apply directly:

   bash scripts/deploy_notebook.sh notebook.json
   

   The script validates the notebook first and blocks deployment on errors. Skipping it risks deploying broken notebooks. On successful deployment, the local file is deleted.
5. When updating an existing notebook: download first with dtctl get notebook <id> -o json --plain > notebook.json, modify, then deploy. Never reconstruct from scratch or inject an id manually.