dt-app-notebooks

SKILL.md

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

Load domain skills BEFORE generating queries — do not invent DQL

Validate ALL queries via dtctl query '<DQL>' --plain before adding to the notebook

Always set "autoSelectVisualization": true in visualizationSettings unless the user explicitly requests a specific visualization type

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.

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.