dt-obs-extensions — Claude Code skill for extension checks
The dt-obs-extensions Claude Code skill checks Dynatrace extension monitoring configurations and helps diagnose errors. It activates for status checks, startup failures, and extension error codes.
Apache-2.0 229 installs ★ 186 updated 2026-10-23
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-codeWhat dt-obs-extensions does
The skill checks monitoring configuration statuses and helps trace extension errors in Dynatrace. It uses DQL queries to inspect status and event data, then points to references/extensions-error-codes.md for DEC code details.
Statuses map to troubleshooting steps. For instance, HIGH_MEMORY calls for changing the Performance Profile in ActiveGate settings, while EXTENSION_VERIFICATION_ERROR points to the syntax of extension.yaml. For a DEC code, the skill looks up the matching entry instead of loading the entire reference file.
When an extension produces no data, the checks cover OK status, whether its monitoring configuration is enabled, and network access to the monitored system. A REST API port conflict calls for checking port use on the host.
What it helps with
- check an extension monitoring configuration status
- trace an error through event logs and its DEC code
- diagnose repeated extension restarts
- find why an extension produces no data
Example prompts for the agent
- Check Dynatrace monitoring configuration statuses and explain any extension errors.
- Look up this extension's DEC code from its event log.
- Find out why the extension keeps restarting and produces no data.
How to install dt-obs-extensions
1Skills CLI (Vercel)
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code2Manually: put the files in place
~/.claude/skills/dt-obs-extensions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/dt-obs-extensions/
1Skills CLI (Vercel)
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a codex2Manually: put the files in place
.agents/skills/dt-obs-extensions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a cursor2Manually: put the files in place
.cursor/skills/dt-obs-extensions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Dynatrace/dynatrace-for-ai skills/dt-obs-extensions2Manually: put the files in place
.github/skills/dt-obs-extensions/SKILL.md1Skills CLI (Vercel)
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a gemini-cli2Platform CLI
gemini skills install https://github.com/Dynatrace/dynatrace-for-ai --path skills/dt-obs-extensionsManually: put the files in place
.devin/skills/dt-obs-extensions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about dt-obs-extensions
How do I install dt-obs-extensions in Claude Code?
Run npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code. The skill file is placed at ~/.claude/skills/dt-obs-extensions/SKILL.md.
What does dt-obs-extensions do?
It checks Dynatrace extension monitoring statuses, examines event logs, and helps interpret extension errors.
How does the skill look up extension errors?
It matches status values with troubleshooting steps and searches references/extensions-error-codes.md for the relevant DEC entry.
Source text
SKILL.md · Apache-2.0
---
name: dt-obs-extensions
description: >-
Dynatrace extension status checks and troubleshooting. Use when checking extension monitoring
configuration status, diagnosing extension errors, or interpreting extension error codes.
Trigger: "extension status", "extension not working", "extension error", "monitoring configuration
status", "EEC error", "extension troubleshooting", "DEC error code", "extension startup failed",
"high memory extension", "extension verification error".
Do NOT use for explaining existing queries, product documentation questions,
or OneAgent/ActiveGate installation issues unrelated to extensions.
license: Apache-2.0
---
# Dynatrace Extensions Skill
## Overview
Dynatrace extensions allow you to extend the functionality of Dynatrace by integrating with external systems and custom data sources.
**When to use this skill:**
- Checking the status of installed extensions and their monitoring configurations
- Troubleshooting extension configuration issues using DQL queries and event logs
## Extensions lifecycle
Extensions are first installed, which brings assets (dashboards, alert templates, OpenPipeline rules etc). Once installed, each extension can have multiple activation - Monitoring Configurations. Configurations can run on ActiveGate or OneAgent, and can be enabled/disabled independently. Each configuration has its own status, which can be queried using this skill.
## Extensions Monitoring Configurations and Statuses
### Extensions Statuses
To check the status of an extension, you can run following DQL query:
```dql
timeseries count(dt.sfm.extension.config.status), by: {dt.extension.name, dt.extension.config.id, dt.extension.status}
```
- `dt.extension.name` — extension name
- `dt.extension.config.id` — monitoring configuration ID
- `dt.extension.status` — current status value
### 2. Retrieve Extension Event Logs
If a status is not `OK`, get detailed logs:
```dql
fetch dt.system.events
| filter dt.extension.name == "<extension_name>" AND dt.extension.config.id == "<config_id>"
```
Look for error codes in the `content` field. Error codes have the format `DEC:[A-Z0-9_]+`.
→ For error code meanings and remediation, search `references/extensions-error-codes.md` for the exact code (see [Error Code Reference](#error-code-reference)).
---
## Extension Status Reference
| Status | Meaning | Remediation |
|--------|---------|-------------|
| `OK` | Running without issues | None |
| `STARTUP` / `STARTUP_PENDING` / `STARTUP_SCHEDULED` | Extension is starting | Wait for startup to complete |
| `RESTART` / `TIMED_OUT_RESTART` | Extension restarting | Monitor; if recurring, check logs |
| `IDLE` | Working but no status produced | Usually transient |
| `WARNING` | Warning state | Check extension logs |
| `GENERIC_ERROR` | Error state | Check extension logs |
| `STARTUP_ERROR` | Error during startup | Check extension logs and configuration |
| `HIGH_CPU` / `HIGH_CPU_RESTART` | Excessive CPU usage | Switch Performance Profile in ActiveGate settings |
| `HIGH_MEMORY` / `HIGH_MEMORY_RESTART` | Excessive memory usage | Switch Performance Profile in ActiveGate settings |
| `EEC_HARD_LIMIT_REJECTION` / `EEC_HARD_LIMIT_RESTART` | Resource hard limit hit | Switch Performance Profile in ActiveGate settings |
| `EEC_RESTSERVER_ERROR` | REST API port conflict | Check for port conflicts on the host |
| `EXTENSIONS_CACHE_ERROR` | Cannot download extension | Check disk space on ActiveGate/OneAgent |
| `EXTENSION_VERIFICATION_ERROR` | Malformed extension.yaml | Validate extension.yaml syntax |
| `CUSTOM_CODE_EXTENSION_NOT_ALLOWED` | Custom code blocked | Update ActiveGate or OneAgent |
| `INCOMPATIBLE_API_ERROR` | API version mismatch | Update ActiveGate/OneAgent or check extension docs |
| `MAX_TASKS_LIMIT_REJECTION` | Too many tasks | Add ActiveGates to the group or split groups |
| `MISSING_BINARY` / `MISSING_DATASOURCE` | Malformed installation | Reinstall ActiveGate or OneAgent |
| `GROUP_NAME_CHANGE` | Temporary rebalancing | Wait for rebalancing to complete |
---
## Troubleshooting
### Common Issues
1. **Extension shows non-OK status**
- Run the status query above to identify the specific status code
- Check the status reference table for remediation
- If unclear, fetch event logs for the extension
2. **Error codes in event logs**
- Error codes follow the pattern `DEC:[A-Z0-9_]+`
- Search for the code in `references/extensions-error-codes.md` (see [Error Code Reference](#error-code-reference) below)
- If no error code is present, read the event `content` for details
3. **Extension keeps restarting**
- Check for `HIGH_CPU_RESTART`, `HIGH_MEMORY_RESTART`, or `TIMED_OUT_RESTART`
- Switch to a higher Performance Profile in ActiveGate settings
- Review extension configuration for excessive scope
4. **Extension not producing data**
- Verify status is `OK` (not `IDLE` or error state)
- Check that the monitoring configuration is enabled
- Verify network connectivity to the monitored system
---
## Error Code Reference
`references/extensions-error-codes.md` is a large generated file. Each entry follows this structure:
```
## Error Code DEC:<code>
### Error Description: <description>
### Suggestions:
1. ...
```
**Do not load the full file.** Search for the specific error code heading (e.g. `## Error Code DEC:1D6`) in `references/extensions-error-codes.md` and read the next ~50 lines. Stop at the next `## Error Code` header.
---
## References
- [extensions-error-codes.md](references/extensions-error-codes.md) — Complete list of DEC error codes with descriptions and troubleshooting steps
© Dynatrace · Apache-2.0 · Dynatrace/dynatrace-for-ai