Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/dt-obs-extensions/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/dt-obs-extensions/

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

Similar skills

SKILL.md skills catalog →

From the same set40

The whole set →
dt-obs-network-devices dt-obs-network-devices is a Claude Code skill that analyzes SNMP devices and interfaces in Dynatrace. It helps inspect topology, spot saturated links, and investigate device events. CX Codex +1 1,200installs dt-obs-network-flows dt-obs-network-flows — a Dynatrace skill that reads network flows from three sources and answers who talks to whom and where connections break. CX Codex +1 1,200installs dt-setup-oneagent dt-setup-oneagent is a Claude Code skill that provides commands to install or remove Dynatrace OneAgent on servers, Kubernetes, and cloud targets. It does not run them. CX Codex +1 793installs dt-setup-openinference-migration The dt-setup-openinference-migration Claude Code skill moves a Python app from Traceloop/OpenLLMetry to OpenInference with GenAI semantic conventions enabled. It activates for migration requests. CX Codex +1 264installs dt-setup-genai The dt-setup-genai Claude Code skill selects an instrumentation approach for GenAI apps written in Python or TypeScript. It guides setup so gen_ai.* OTel spans reach Dynatrace. CX Codex +1 263installs dt-upgrade The dt-upgrade Claude Code skill assesses Dynatrace readiness for a move from classic features to the third-generation platform. It reviews usage and helps plan configuration migrations. CX Codex +1 226installs Dynatrace A remote MCP server that wires your coding agent into a Dynatrace environment: live queries, incident analysis, metrics and logs. CX Codex +1 ★ 186repo stars dynatrace Explore Dynatrace data with skills for DQL, logs, traces, and incident analysis. A bundled MCP server connects Claude Code to a live Dynatrace environment. ★ 186repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open