The dt-app CLI
One command to scaffold a new app:
node --version # Need 22+
npx dt-app@latest create --environment-url https://YOUR-ENV.apps.dynatrace.com
💡 Two official templates available: --template default (full starter with DQL) or --template empty (minimal skeleton). See Dynatrace/dt-app-templates.
AI Resources Manager (aimgr)
Dynatrace also provides aimgr for managing AI agent skills across tools:
# Install aimgr
curl -fsSL https://raw.githubusercontent.com/dynatrace-oss/ai-config-manager/main/scripts/install.sh | sh
# Install Dynatrace skills for your AI agent
aimgr repo add gh:dynatrace/dynatrace-for-ai
aimgr install skill/dt-dql-essentials
Project Structure
my-app/
├── ui/app/ ← React frontend
│ ├── App.tsx ← Root + routing
│ └── pages/ ← Page components
├── api/ ← Serverless functions
├── app.config.json ← Metadata, scopes, CSP
└── package.json
app.config.json
{
"environmentUrl": "https://abc12345.apps.dynatrace.com",
"app": {
"name": "My App",
"version": "0.0.1",
"id": "my.first.app",
"scopes": [
{ "name": "storage:metrics:read", "comment": "Read metrics" },
{ "name": "storage:entities:read", "comment": "Read entities" }
]
}
}
⚠️ Without the right scopes, DQL queries return empty results or errors.
Common Scopes
storage:metrics:read — DQL timeseries queries
storage:entities:read — DQL entity fetch
storage:logs:read — Log queries
storage:events:read — Event queries
app-engine:apps:run — Required for all apps
Dev Server
cd my-app && npx dt-app dev
💡 The dev server proxies API calls to your DT environment — useDql queries hit real data immediately. Hot reload built in.
🧠 Quick Check
What file defines your app's permissions and metadata?
What's Next
Module 2 — Write code: pages, Strato components, routing.