Monitoring
Plugin
dtctl
Your Dynatrace platform, one command away. dtctl is a CLI for the Dynatrace platform. Manage workflows, dashboards, queries, and more from your terminal or let AI agents do it for you.
Plugin Signal61/100Solid
maintained100
capable14
documented75
adopted48
Install
$ npx -y skills add dynatrace-oss/dtctl --agent claude-code
Stats
176
Stars
63
Forks
Active
Maintenance
Go
Language
Apache-2.0
License
3d ago
Last commit
7mo ago
Created
Repo: dynatrace-oss/dtctl
What's inside
Badges
README
dtctl
Your Dynatrace platform, one command away.
dtctl is a CLI for the Dynatrace platform. Manage workflows, dashboards, queries, and more from your terminal or let AI agents do it for you. Its predictable verb-noun syntax (inspired by kubectl) makes it easy for both humans and AI agents to operate.
dtctl get workflows # List all workflows
dtctl query "fetch logs | limit 10" # Run DQL queries
dtctl apply -f workflow.yaml --set env=prod # Declarative configuration
dtctl get dashboards -o json # Structured output for automation
dtctl exec copilot nl2dql "error logs from last hour"
Early Development: This project is in active development. If you encounter any bugs or issues, please file a GitHub issue. Contributions and feedback are welcome!
Documentation · Installation · Quick Start · Command Reference
Install
# Homebrew (macOS/Linux)
brew install dynatrace-oss/tap/dtctl
# Shell script (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/dynatrace-oss/dtctl/main/install.sh | sh
# PowerShell (Windows)
irm https://raw.githubusercontent.com/dynatrace-oss/dtctl/main/install.ps1 | iex
Binary downloads, building from source, shell completion setup, and more in the Installation Guide.
Authenticate
# OAuth login (recommended, no token management needed)
dtctl auth login --context my-env --environment "https://abc12345.apps.dynatrace.com"
# Verify everything works
dtctl doctor
Token-based authentication and multi-environment configuration are covered in the Quick Start.
Why dtctl?
- Familiar CLI conventions:
get,describe,edit,apply,delete. If you (or your AI) knowkubectl, you already know dtctl. - Built for AI agents: Structured output (
--agent), machine-readable command catalog (dtctl commands), environment data discovery (dtctl inventory), and a bundled Agent Skill that teaches AI assistants how to operate Dynatrace - Multi-environment: Switch between dev/staging/prod with a single command; safety levels prevent accidental changes
- Watch mode: Real-time monitoring with
--watchfor all resources - DQL passthrough: Execute queries directly, with template variables and file-based input
- NO_COLOR support: Respects
NO_COLOR,FORCE_COLOR=1, and auto-detects TTY
Supported Resources
| Resource | Operations |
|---|---|
| Workflows | get, describe, create, edit, delete, apply, execute, logs, history, restore, diff, watch |
| Dashboards & Notebooks | get, describe, create, edit, delete, apply, share, history, restore, diff, watch |
| Documents & Trash | get, describe, create, edit, delete, share, history, restore |
| DQL Queries | execute, verify, template variables, live mode, filter segments, wait conditions, spill large results to a file + local inspect (rows/schema/stats) |
| SLOs | get, describe, create, edit, delete, apply, evaluate, watch |
| Settings | get schemas, get/create/update/delete objects |
| Buckets | get, describe, create, delete, apply, watch |
| Segments | get, describe, create, edit, delete, apply, watch |
| Lookup Tables | get, describe, create, delete, apply (CSV auto-detection) |
| Anomaly Detectors | get, describe, create, edit, delete, apply |
| Extensions 2.0 | get, describe, apply monitoring configs |
| Hub Extensions | get, describe, list releases, filter by keyword |
| App Functions & Intents | get, describe, execute, find, open (deep linking) |
| Analyzers & CoPilot | statistical analyzers, CoPilot chat, NL-to-DQL, document search |
| Cloud Integrations | AWS, Azure & GCP connections and monitoring (get, describe, create, delete, apply, update, enable) |
| EdgeConnect | get, describe, create, delete |
| Notifications | get, describe, delete, watch |
| Users & Groups | get, describe |
| Live Debugger | breakpoints, workspace filters, snapshot decoding |
| Platform Tokens | account create/list/delete token (dt0s16.* via Account Management API) |
See the Command Reference for the full list of verbs, flags, resource types, and aliases.
AI Agent Skills
dtctl ships with an Agent Skill that teaches AI coding assistants how to use dtctl. Agents can also bootstrap at runtime with dtctl commands, which prints a compact minimal overview of verbs, resources, and subcommands (defaults to TOON); add --brief or --full for progressively more detail. Where dtctl commands answers "what can I run?", dtctl inventory answers "what is there to query?" — it probes the current environment (read-only, budgeted) for fetchable data objects, buckets, filter segments, a live entity-type census, and capabilities present or absent, with the evidence cited for every absent one. The capability set is customizable via --definitions (see docs/dev/examples/inventory-definitions.example.yaml).
# Install via skills.sh
npx skills add dynatrace-oss/dtctl
# Or install with dtctl itself
dtctl skills install # Auto-detects your AI agent
dtctl skills install --for claude # Or specify explicitly
dtctl skills install --global # User-wide installation
# Or copy manually
cp -r skills/dtctl ~/.agents/skills/ # Cross-client (any agent)
Compatible with GitHub Copilot, Claude Code, OpenAI Codex CLI, Cursor, Kiro, Junie, OpenCode, OpenClaw, and other Agent Skills-compatible tools. See the AI Agent Mode docs for details on the structured JSON envelope and agent auto-detection.
Dynatrace domain skills
For deeper Dynatrace domain knowledge (DQL syntax, observability patterns, dashboards, logs, Kubernetes, and more) install the skills from Dynatrace/dynatrace-for-ai:
npx skills add dynatrace/dynatrace-for-ai
These skills provide the domain context (e.g., how to write DQL queries, which metrics to use for service health, how to navigate distributed traces) while dtctl provides the operational tool to act on it. Together they give AI agents everything they need to work with Dynatrace effectively.
Observability
dtctl supports W3C Trace Context propagation and OTLP span export via the OpenTelemetry SDK. See docs/OBSERVABILITY.md for full details on distributed tracing, environment variables, and CI/CD pipeline integration.
Documentation
Full documentation is available at dynatrace-oss.github.io/dtctl:
- Installation: Homebrew, shell script, binary download, build from source, shell completion
- Quick Start: Authentication, first commands, common patterns
- Configuration: Contexts, credentials, safety levels, aliases
- Command Reference: All verbs, flags, resource types, and examples
- Output Formats: Table, JSON, YAML, CSV, charts
- AI Agent Mode: Structured envelope, auto-detection, agent skill
- Token Scopes: Required API token scopes per safety level
Resource-specific guides: DQL Queries · Workflows · Dashboards · SLOs · Settings · Extensions · Analyzers · CoPilot · and more...
Contributing
See CONTRIBUTING.md for guidelines.
License
Apache License 2.0. See LICENSE.
File tree
dynatrace-oss/dtctlView on GitHub
.agents/
skills/
dtctl-release/
SKILL.md
pr-review/
SKILL.md
.devcontainer/
devcontainer.json
.gitattributes
.github/
CODEOWNERS
dependabot.yml
GITHUB_SETUP_QUICK_REFERENCE.md
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
OSS_QUALITY_CHECKLIST.md
pull_request_template.md
REPOSITORY_SETUP.md
workflows/
build.yml
lint-docs-templates.yml
lint.yml
makefile.yml
pages.yml
release.yml
sdk.yml
security.yml
test.yml
.gitignore
.golangci.yml
.goreleaser.yaml
.integrationtests.env.example
.markdownlint.yml
.release-please-manifest.json
.specstory/
.gitignore
AGENTS.md
ai.package.yaml
CITATION.cff
CLAUDE.md
cmd/
account_gate_test.go
account_login_test.go
account_login.go
account_status.go
account_token_test.go
account_token.go
account.go
agent_helpers_test.go
agent_helpers.go
alias_resolve_test.go
alias_resolve.go
alias_test.go
alias.go
apply_extension_configs.go
apply_test.go
apply.go
auth_session_status_test.go
auth_test.go
auth.go
breakpoint_helpers_test.go
breakpoint_helpers.go
breakpoint_output_golden_test.go
breakpoint_output_test.go
breakpoint_output.go
check_scopes_test.go
check_scopes.go
commands_test.go
commands.go
completion.go
config_custom_test.go
config_init_test.go
config_test.go
config.go
create_anomalydetector.go
create_aws.go
create_azure_test.go
create_azure.go
create_breakpoints_test.go
create_breakpoints.go
create_buckets.go
create_documents_helpers_test.go
create_documents_labels_test.go
create_documents.go
create_edgeconnects.go
create_extensions_test.go
create_extensions.go
create_gcp.go
create_lookups.go
create_providers.go
create_segments.go
create_settings_test.go
create_settings.go
create_slos.go
create_workflows.go
create.go
ctx_test.go
ctx.go
delete_aws.go
delete_breakpoints_test.go
delete_breakpoints.go
delete_gcp.go
delete_settings_test.go
delete.go
describe_analyzers_test.go
describe_analyzers.go
describe_anomalydetector.go
describe_apps.go
describe_aws.go
describe_breakpoints_test.go
describe_breakpoints.go
describe_buckets.go
describe_documents.go
describe_edgeconnects.go
describe_extension_configs.go
describe_extensions_integration_test.go
describe_extensions_test.go
describe_extensions.go
describe_function.go
describe_gcp.go
describe_helpers_test.go
describe_hub_extensions.go
describe_iam.go
describe_intent.go
describe_lookups.go
describe_segments_test.go
describe_segments.go
describe_settings.go
describe_slos.go
describe_workflows_test.go
describe_workflows.go
describe.go
diff.go
disable_aws.go
disable_azure.go
disable_gcp.go
disable_providers.go
disable.go
doctor_test.go
doctor.go
download_test.go
download.go
edit_anomalydetector.go
edit_aws.go
edit_azure.go
edit_documents.go
edit_gcp.go
edit_segments.go
edit_settings_test.go
edit_settings.go
edit_workflows.go
edit.go
enable_aws.go
enable_azure.go
enable_gcp.go
enable_providers.go
enable_test.go
enable.go
exec_analyzers.go
exec_copilot.go
exec_dql.go
exec_forward_unix.go
exec_forward_windows.go
exec_functions.go
exec_preview_processor_test.go
exec_preview_processor.go
exec_slos_test.go
exec_slos.go
exec_workflows_test.go
exec_workflows.go
exec.go
find_intents.go
find.go
flags_test.go
get_analyzers.go
get_anomalydetector.go
get_apps.go
get_aws.go
get_azure.go
get_buckets.go
get_documents_test.go
get_documents.go
get_edgeconnects.go
get_extensions.go
get_functions.go
get_gcp.go
get_hub_extensions.go
get_iam.go
get_intents.go
get_lookups.go
get_notifications.go
get_providers.go
get_segments.go
get_settings.go
get_slos.go
get_snapshots.go
get_wfe_task_result_test.go
get_wfe_task_result.go
get_workflows_test.go
get_workflows.go
get.go
help_topics.go
history.go
inspect_list_test.go
inspect_list.go
inspect_output.go
inspect_spill.go
inspect_test.go
inspect.go
inventory_test.go
inventory.go
logs.go
open_intent.go
open.go
plugin_dispatch_test.go
plugin_dispatch.go
plugin.go
preview_notice.go
profile_test.go
profile.go
query_test.go
query.go
restore.go
root_test.go
root.go
safety_test.go
share.go
skills_test.go
skills.go
spill_test.go
spill.go
testdata/
golden/
breakpoint-output/
agent.golden
json.golden
table.golden
yaml.golden
describe/
extension-description-no-metrics-json.golden
extension-description-no-metrics-yaml.golden
extension-description-with-metrics-json.golden
extension-description-with-metrics-yaml.golden
inventory/
agent.golden
human.golden
json.golden
yaml.golden
testutil/
fixtures.go
golden_test.go
golden.go
helpers.go
mocks.go
testdata/
golden/
describe-segment/
table-minimal.golden
table.golden
translate_classic_pipelines_test.go
translate_classic_pipelines.go
translate_lql_to_dql_test.go
translate_lql_to_dql.go
translate.go
update_aws.go
update_azure.go
update_breakpoints_test.go
update_breakpoints.go
update_documents_test.go
update_documents.go
update_gcp.go
update_providers.go
update_settings_test.go
update.go
verify_analyzer_test.go
verify_analyzer.go
verify_openpipeline_dql_processor_test.go
verify_openpipeline_dql_processor.go
verify_openpipeline_matcher_test.go
verify_openpipeline_matcher.go
verify_query_test.go
verify_query.go
verify.go
version.go
wait.go
CODE_OF_CONDUCT.md
CONTRIBUTING.md
docs/
assets/
dtctl-1.gif
dev/
agent-schema-command.md
ALIAS_DESIGN.md
ANOMALY_DETECTORS_DESIGN.md
API_DESIGN.md
APPLY_TYPE_DETECTION.md
ARCHITECTURE.md
COMMAND_PROFILES_DESIGN.md
CONFIG_CONTRACT.md
context-safety-levels.md
DESCRIBE_ANALYZER_DESIGN.md
DIFF_COMMAND_DESIGN.md
DOCUMENT_TRASH_DESIGN.md
examples/
inventory-definitions.example.yaml
FILTER_AST_PLAN.md
FUTURE_FEATURES.md
GENERIC_DOCUMENTS_DESIGN.md
HOMEBREW_DISTRIBUTION.md
IMPLEMENTATION_STATUS.md
OUTPUT_IMPROVEMENTS.md
PLUGIN_CONVENTIONS.md
PRE_APPLY_HOOK_DESIGN.md
README.md
SEGMENTS_DESIGN.md
WATCH_MODE_DESIGN.md
EXTENSIONS.md
INSTALLATION.md
LIVE_DEBUGGER.md
OAUTH_IMPLEMENTATION.md
OBSERVABILITY.md
QUICK_START.md
sdk-migration.md
site/
_config.yml
_docs/
ai-agent-mode.md
analyzers.md
anomaly-detectors.md
apps.md
buckets.md
cloud-integrations.md
command-profiles.md
command-reference.md
configuration.md
copilot.md
dashboards.md
documents.md
dql-queries.md
extensions.md
installation.md
inventory.md
live-debugger.md
lookups.md
output-formats.md
quick-start.md
segments.md
settings.md
skills.md
slos.md
token-scopes.md
workflows.md
_includes/
docs-nav.html
_layouts/
default.html
docs.html
assets/
css/
style.scss
Gemfile
Gemfile.lock
index.md
TOKEN_SCOPES.md
WINDOWS.md
examples/
aws_connection.yaml
aws_monitoring_config.yaml
azure_connection_clientSecret.yaml
azure_connection_federatedIdentityCredential.yaml
azure_monitoring_config.yaml
config-example.yaml
errors.dql
logs-by-host.dql
flake.lock
flake.nix
go.mod
go.sum
install.ps1
install.sh
LICENSE
main.go
makefile
NOTICE
pkg/
aidetect/
detect_test.go
detect.go
apply/
applier_test.go
applier.go
apply_anomaly_detector.go
apply_aws.go
apply_azure.go
apply_bucket.go
apply_document_custom_test.go
apply_document_labels_test.go
apply_document.go
... 765 moreFAQ
dtctl is a Claude Code plugin with 1 hand-picked skill for monitoring work, indexed on Flowy. Install it with the command on its page. It includes dtctl. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is dtctl?
- Your Dynatrace platform, one command away. dtctl is a CLI for the Dynatrace platform. Manage workflows, dashboards, queries, and more from your terminal or let AI agents do it for you.
- How do I install dtctl?
- Run these in Claude Code: npx -y skills add dynatrace-oss/dtctl --agent claude-code. Then prompt normally.
- Does dtctl auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is dtctl free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.