| name | dtwiz |
| description | Deploy Dynatrace observability with dtwiz — analyze systems, get ranked recommendations, and install monitoring (OneAgent, Kubernetes, Docker, OTel, AWS, Azure, GCP). Use when the user wants to set up, manage, or ingest data into Dynatrace monitoring. Covers ingesting metrics, logs, and traces from AWS, Azure, GCP, Kubernetes, containers, or hosts into Dynatrace via dtwiz. |
Dynatrace Setup with dtwiz
Go CLI that detects your environment and deploys the best Dynatrace monitoring method automatically. Core principle: if we detect it, we enable monitoring for it — zero config, all defaults on.
Prerequisites
dtwiz installed (curl -sfL https://raw.githubusercontent.com/dynatrace-oss/dtwiz/main/scripts/install.sh | sh)- Dynatrace environment URL + API token
- Auth via flags or env vars:
export DT_ENVIRONMENT=https://<your-tenant-domain>
export DT_PLATFORM_TOKEN=dt0s16.****
Or pass per-command: --environment, --platform-token.
For environments where the access token is required, pass --access-token dt0c01.**** explicitly.
Recommended Initialization
At the start of a task, run these checks to establish context:
dtwiz status
dtwiz analyze --json
dtwiz recommend --json
CLI Commands
| Command | Description |
|---|
dtwiz setup | Interactive: analyze → recommend → pick → install |
dtwiz analyze [--json] | Detect platform, containers, K8s, agents, cloud, services |
dtwiz recommend [--json] | Ranked ingestion recommendations based on analysis |
dtwiz status | Connection status + system analysis |
dtwiz install <method> | Install a specific ingestion method |
dtwiz update <method> | Patch an existing method configuration |
dtwiz uninstall <method> | Remove an installed method |
dtwiz version | Print the dtwiz version |
All install, update, and uninstall commands support --dry-run.
Install Methods
| Method | Command | What it does |
|---|
| OneAgent | dtwiz install oneagent | Full-stack host monitoring |
| Kubernetes | dtwiz install kubernetes | Deploy Dynatrace Operator (cloudNativeFullStack) |
| Docker | dtwiz install docker | OneAgent for Docker containers |
| OTel | dtwiz install otel | OTel Collector + application instrumentation |
| OTel Collector | dtwiz install otel-collector | OTel Collector only (no app instrumentation) |
| OTel Java | dtwiz install otel-java | OpenTelemetry Java auto-instrumentation |
| OTel Python | dtwiz install otel-python | OpenTelemetry Python auto-instrumentation |
| AWS | dtwiz install aws | CloudFormation integration (all services, all regions) |
| Azure | dtwiz install azure | Azure Monitor integration |
| GCP | dtwiz install gcp | Google Cloud Platform integration |
Key Concepts
URL Families
Two URL families — using the wrong one causes 404s or auth errors:
| Family | Pattern | Auth header | Use for |
|---|
| Classic | <env-id>.<domain>/api/... | Api-Token dt0c01.* | /api/v1, /api/v2, OneAgent download, OTel ingest |
| Platform | <env-id>.apps.<domain>/platform/... | Bearer <token> | DQL/Grail queries, Platform APIs |
Token Types
| Prefix | Type | Auth header |
|---|
dt0c01.* | API token | Api-Token <token> |
dt0s16.* | Platform token | Bearer <token> |
Dry Run
Preview any install/update/uninstall without executing:
dtwiz install otel --dry-run
dtwiz uninstall oneagent --dry-run
Zero-Config Defaults
- OneAgent: full-stack mode
- Kubernetes:
cloudNativeFullStack
- AWS: all services + all regions
Common Workflows
dtwiz setup
dtwiz analyze
dtwiz install otel --dry-run
dtwiz install otel
dtwiz update otel
dtwiz uninstall oneagent
Common Issues
Cloud/K8s not detected:
- Kubernetes → connect to a cluster with
kubectl first
- AWS → sign in with
aws configure
- Azure → sign in with
az login
- GCP → sign in with
gcloud auth login
404 errors:
- Wrong URL family. Classic endpoints must not have
.apps. in the URL. Platform endpoints must.
403 errors:
- Wrong auth header. DQL/Platform endpoints need
Bearer auth, even for dt0c01.* tokens. Classic API endpoints need Api-Token auth.
Token prefix mismatch:
dt0c01.* = API token (Classic API)dt0s16.* = Platform token (new APIs)
Safety Reminders
- Use
--dry-run before destructive operations
- All installs show a preview and prompt
Apply? [Y/n] before executing
- Uninstall commands show what will be removed and require confirmation
