dynatrace-kpi-dashboard-generator

Business Event Generator

An installable AI agent that, for any company you name, generates a Dynatrace Gen 3 KPI dashboard plus a 30‑minute BizEvents injector, deploys both with dtctl, and verifies events are flowing.

Works with Claude Code, GitHub Copilot, Cursor, or any agent runtime that respects AGENTS.md.

---

What you get for each company

dashboards/<Company>/
  <company>-dashboard-v1.json     # Gen 3 dashboard (logo, KPIs, charts, map)
  <company>-injector.js           # 30-min BizEvents injector
  README.md                       # IDs + deploy commands
  LEARNINGS.md                    # DQL/layout notes
  SALES-PITCH.md                  # 1-page value pitch

A single shared workflow 1.BizEvents Dashboard Generator runs every 30 minutes in your tenant. Each new company is added as a task inside that one workflow — the agent never creates a second injector workflow.

---

Quick start (macOS / Linux)

Three commands and you're done:

git clone https://github.com/SudoSmitty/dynatrace-kpi-dashboard-generator.git
cd dynatrace-kpi-dashboard-generator
./scripts/install.sh

The installer takes care of everything:

• Installs jq (if missing).
• Installs / updates dtctl.
• Installs the dtctl, dynatrace-for-ai, and dynatrace-kpi-dashboard-generator agent skills via npx skills add.
• If Claude Code (claude) is installed, it also installs the Claude plugin so /generate-kpi-dashboard works globally (any cwd) without any extra step.

Then authenticate dtctl to your tenant and verify:

dtctl auth login --context my-env --environment "https://<env>.apps.dynatrace.com"
./scripts/check-prereqs.sh

You're ready. Skip ahead to Use it.

Windows users: see Windows install below.

---

Use it

Once installed, you can invoke the agent from any directory — the skill is loaded globally.

Claude Code

/generate-kpi-dashboard Acme Corp

…or just ask in plain English: "Generate a KPI dashboard for Acme, they're a logistics company."

GitHub Copilot Chat (VS Code)

In agent mode:

Generate a KPI dashboard for Acme.

If you want a slash command in Copilot too, link the prompt file:

mkdir -p "$HOME/Library/Application Support/Code/User/prompts"   # macOS
ln -sfn "$PWD/.github/prompts/generate-kpi-dashboard.prompt.md" \
  "$HOME/Library/Application Support/Code/User/prompts/generate-kpi-dashboard.prompt.md"

Linux: ~/.config/Code/User/prompts/. Windows: %APPDATA%\Code\User\prompts\.

Any other agent

Point your agent at AGENTS.md. It is fully self‑contained.

---

What the agent does

1. Runs dtctl auth whoami and dtctl ctx current, shows you the tenant, and waits for confirmation before touching anything.
2. Asks for company name, industry (optional), logo URL (optional — it'll search if you don't provide one).
3. Researches 15–20 industry KPIs and matching event types.
4. Writes the dashboard JSON, injector JS, README, LEARNINGS, and SALES‑PITCH into dashboards/<Company>/.
5. dtctl apply the dashboard, captures the ID.
6. Adds a <company>_v1 task to the single shared injector workflow (1.BizEvents Dashboard Generator). Never creates a duplicate.
7. dtctl exec workflow <id> and waits for SUCCESS.
8. Verifies events landed:

   fetch bizevents
   | filter event.provider == "<company>.event.provider"
   | summarize total = count()
   

9. Tells you the dashboard URL, workflow ID, and task name.

Full spec: AGENTS.md.

---

Other install paths

The Quick Start covers 95% of cases. Use these if you need something different.

Already have dtctl + Dynatrace skills installed?

Just install this one skill (and, optionally, the Claude plugin):

npx skills add SudoSmitty/dynatrace-kpi-dashboard-generator

# Optional: also install the /generate-kpi-dashboard slash command in Claude Code
claude plugin marketplace add SudoSmitty/dynatrace-kpi-dashboard-generator
claude plugin install dynatrace-kpi-dashboard-generator@dynatrace-kpi-dashboard-generator

Updates: npx skills update and claude plugin update ….

Local‑only (developing the skill itself)

If you're editing this repo and want changes to show up immediately without re‑publishing, symlink the bundle into your global agent dirs:

mkdir -p ~/.agents/skills ~/.claude/commands
ln -sfn "$PWD/skills/dynatrace-kpi-dashboard-generator" \
  ~/.agents/skills/dynatrace-kpi-dashboard-generator
ln -sfn "$PWD/.claude/commands/generate-kpi-dashboard.md" \
  ~/.claude/commands/generate-kpi-dashboard.md

After editing AGENTS.md or .example/, regenerate the skill bundle:

./scripts/build-skill.sh

Windows install

The installer script doesn't run on Windows. Do it manually in PowerShell: