Skip to content

dynatrace-oss/batch-configurator

Batch Configurator

A Dynatrace App that lets you save and apply settings configurations to multiple Hosts and Process Groups at once.


What It Does

Batch Configurator lets you apply Dynatrace entity settings in bulk instead of one entity at a time:

  1. Select a target type — choose to configure Hosts or Process Groups.
  2. Pick entities — select targets using a point-and-click entity picker or write a custom DQL query.
  3. Configure settings — enable, disable, or tune any combination of supported settings categories for all selected entities at once.
  4. Review and apply — name the configuration, review a summary of all changes, and apply in a single bulk operation.
  5. Save history — every applied configuration is stored as a BizEvent in Grail, giving you a searchable audit trail and the ability to re-open any past configuration as a reference.

Getting Started

Prerequisites

Install

npm install

Run Locally

You do not need to deploy the app to use it. Running it locally connects to whichever Dynatrace tenant is configured in app.config.json.

npm run start

This opens the app in your browser with hot reload enabled. All data is fetched live from your configured Dynatrace environment.

Deploy to Dynatrace

npm run deploy

Builds and deploys the app directly to the environment URL in app.config.json.


Configuration

All configuration lives in app.config.json at the project root. There are no .env files — the Dynatrace SDK handles auth context.

Update environmentUrl to point at your own tenant before running or deploying.

The app blocks rendering at startup until all required OAuth scopes are confirmed. If any scope is missing, an error screen is shown instead of the app.


Architecture & Design

For a full breakdown of the system architecture, component structure, data flow, and required OAuth scopes, see the Architecture Document.


Routes

The app is served under the base path /ui.

Route Page
/ui/ Home — list of saved configurations, wizard to create new ones

Tech Stack

Layer Technology
Framework React 18, React Router 7
Language TypeScript 5.9
State & Data Fetching React Context, TanStack Query 5
UI Components Dynatrace Strato Components + Design Tokens
Build Tool Dynatrace App Toolkit (dt-app)
i18n React-Intl
Backend Dynatrace SDK clients (no standalone server)

Limitations

  • Platform-locked — the app runs inside the Dynatrace browser shell. It cannot be deployed as a standalone web server.
  • Permission-gated — the entire UI is blocked until all required OAuth scopes are verified. Missing any scope shows an error instead of the app.
  • Node.js >=22 required for local development.

This repository is archived and is no longer maintained.

No bug fixes, feature updates, or pull requests will be accepted. The code is provided as-is for reference only. For supported Dynatrace app development resources, visit the Dynatrace Developer Portal.

About

save & apply configurations to multiple entities

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors