К основному содержанию
скилл CX Codex

dt-obs-extensions — скилл для Claude Code: проверка расширений

Скилл dt-obs-extensions для Claude Code проверяет статус конфигураций мониторинга Dynatrace и помогает разбирать ошибки расширений. Запускается при запросах о статусе, сбоях запуска и кодах DEC.

Apache-2.0 229 установок ★ 186 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code
Открыть на GitHub

Что делает dt-obs-extensions

Скилл проверяет статус конфигураций мониторинга Dynatrace и помогает найти причину ошибок расширений. Для проверки он использует DQL-запросы к статусам и журналам событий, а коды ошибок предлагает искать в references/extensions-error-codes.md.

Статус подсказывает следующий шаг: например, при HIGH_MEMORY нужно сменить Performance Profile в настройках ActiveGate, а при EXTENSION_VERIFICATION_ERROR — проверить синтаксис extension.yaml. Для событий с кодом DEC скилл ищет точную запись в справочнике, не загружая весь файл.

Если расширение не выдаёт данные, проверяются статус OK, включение конфигурации и сетевое подключение к системе мониторинга. При проблемах с портом REST API причина может быть в конфликте портов на хосте.

Какие задачи решает

  • проверить статус конфигурации мониторинга расширения
  • найти причину ошибки по журналу событий и коду DEC
  • разобрать повторные перезапуски расширения
  • выяснить, почему расширение не выдаёт данные

Примеры запросов агенту

  • Проверь статус конфигураций мониторинга Dynatrace и объясни ошибки.
  • Разбери код DEC из журнала событий расширения.
  • Выясни, почему расширение перезапускается и не выдаёт данные.

Как установить dt-obs-extensions

1Через Skills CLI (Vercel)

npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/dt-obs-extensions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dt-obs-extensions

Как установить dt-obs-extensions в Claude Code?

Выполни npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-extensions -a claude-code. Файл скилла появится по пути ~/.claude/skills/dt-obs-extensions/SKILL.md.

Что делает dt-obs-extensions?

Проверяет статусы конфигураций мониторинга Dynatrace, анализирует журналы событий и помогает интерпретировать ошибки расширений.

Как скилл разбирает ошибки расширений?

Он сопоставляет статус с рекомендацией по устранению проблемы, а для кода DEC ищет соответствующую запись в references/extensions-error-codes.md.

Исходный текст

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

Похожие скиллы

Каталог скиллов SKILL.md →
dtctl Dynatrace Скилл dtctl для Claude Code управляет Dynatrace через CLI и исследует инциденты, логи, трассировки и состояние сервисов. Выполняет DQL-запросы и работает с дашбордами. CX Codex +1 1 400установок chrome-extensions GoogleChrome Скилл chrome-extensions помогает создавать и публиковать расширения для Chrome по стандартам Manifest V3. Задаёт правила для фоновых скриптов, боковых панелей и разрешений. CX Codex +1 16 200установок shopify-polaris-admin-extensions Shopify Скилл shopify-polaris-admin-extensions по админ-расширениям Shopify для Claude Code. Сейчас он помечен как устаревший: вместо работы выдаёт инструкцию удалить себя и поставить shopify. CX Codex +1 9 700установок shopify-polaris-checkout-extensions Shopify Скилл shopify-polaris-checkout-extensions для Claude Code помогает создавать расширения интерфейса Shopify Checkout. Он помечен как устаревший и заменён скиллом shopify. CX Codex +1 9 600установок Dynatrace Expert официальный github Субагент Dynatrace Expert подключает наблюдаемость и безопасность Dynatrace прямо к рабочим процессам в репозитории. Он разбирает инциденты, валидирует релизы и ищет уязвимости по логам и спанам. CX Codex +1 ★ 41 430звёзд репо dynatrace-managed-mcp dynatrace-oss Подключает ассистента к Dynatrace Managed для поиска логов и событий, анализа метрик и разбора проблем. Помогает расследовать инциденты и просматривать исторические данные. CX Codex +1 ★ 35звёзд репо

Из того же набора40

Весь набор →
dt-obs-network-devices Скилл dt-obs-network-devices для Claude Code анализирует SNMP-устройства и интерфейсы в Dynatrace. Помогает найти перегруженные порты, изучить топологию и расследовать события. CX Codex +1 1 200установок dt-obs-network-flows Скилл dt-obs-network-flows для Dynatrace: разбирает сетевые потоки из трёх источников и отвечает, кто с кем говорит и где рвутся соединения. CX Codex +1 1 200установок dt-setup-oneagent Скилл dt-setup-oneagent подсказывает, как установить или удалить Dynatrace OneAgent на серверах, в Kubernetes и облачных средах. Он выдаёт команды, но сам их не запускает. CX Codex +1 793установок dt-setup-openinference-migration Скилл dt-setup-openinference-migration для Claude Code переносит Python-приложение с Traceloop/OpenLLMetry на OpenInference с включённой семантикой GenAI. Активируется по запросу о такой миграции. CX Codex +1 264установок dt-setup-genai Скилл dt-setup-genai для Claude Code определяет, как добавить трассировку GenAI-приложению на Python или TypeScript. Он помогает настроить передачу OTel-спанов gen_ai.* в Dynatrace. CX Codex +1 263установок dt-upgrade Скилл dt-upgrade для Claude Code оценивает готовность Dynatrace к переходу с классических функций на платформу третьего поколения. Он разбирает запросы использования и помогает спланировать миграцию конфигураций. CX Codex +1 226установок Dynatrace Удалённый MCP-сервер, который подключает агента к вашему окружению Dynatrace: живые запросы, разбор проблем, метрики и логи. CX Codex +1 ★ 186звёзд репо dynatrace Плагин помогает разбирать данные Dynatrace: писать DQL-запросы, изучать логи и искать причины проблем. Для живых запросов подключает MCP-сервер к вашей среде. ★ 186звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой