API VEGA

Dynatrace для AI

Все, что нужно AI-агентам для работы с Dynatrace, начиная с навыков.

Навыки — переносимые наборы знаний, следующих открытому формату Agent Skills. Они дают AI‑кодирующим агентам доменно‑специфический контекст для запросов, анализа и интерпретации данных Dynatrace. Они работают с Claude Code, GitHub Copilot, Cursor, OpenCode, Gemini CLI и более чем с 30 другими совместимыми инструментами.

Установка

Пакет навыков (skills.sh)

npx skills add dynatrace/dynatrace-for-ai

Работает с Claude Code, Cursor, Cline, GitHub Copilot, OpenCode и другими совместимыми агентами.

Плагин Claude Code

claude plugin marketplace add dynatrace/dynatrace-for-ai
claude plugin install dynatrace@dynatrace-for-ai

Плагин включает сервер MCP Dynatrace. Перед запуском Claude Code задайте переменные окружения, чтобы подключиться к вашей среде:

.apps.dynatrace.com # например https://abc12345.apps.dynatrace.com export DT_PLATFORM_TOKEN=">``` export DT_ENVIRONMENT=https://<env>.apps.dynatrace.com # например https://abc12345.apps.dynatrace.com export DT_PLATFORM_TOKEN=<ваш-платформенный-токен>


Пожалуйста, ознакомьтесь с [документацией сервера MCP Dynatrace](https://docs.dynatrace.com/docs/shortlink/dynatrace-mcp-server) для полного списка необходимых прав доступа для использования MCP Server с Platform Token.

Обновление через `claude plugin marketplace update && claude plugin update dynatrace@dynatrace-for-ai`.

Встроенный сервер MCP подключается к вашей среде Dynatrace. Подробности обработки данных см. в [Политике конфиденциальности Dynatrace](https://www.dynatrace.com/company/trust-center/privacy/).

### Руководство

Скопируйте директории навыков в путь навыков вашего агента (`.agents/skills/`, `.claude/skills/`, `.cursor/skills/` и т. п.).

## Подключение к Dynatrace

Навыки содержат только знания. Чтобы выполнять живые запросы и управлять вашей средой, соединяйте их с инструментом.

### Dynatrace CLI (dtctl)

**[dtctl](https://github.com/dynatrace-oss/dtctl)** — интерфейс командной строки в стиле kubectl для платформы Dynatrace. Он поставляется с собственным [Agent Skill](https://github.com/dynatrace-oss/dtctl/tree/main/skills/dtctl), который обучает агентов работать с ним.

.authenticate через Dynatrace

Аутентификация

dtctl auth login --environment "https://<env>.apps.dynatrace.com" --context my-env

npx skills add dynatrace-oss/dtctl # Установить навык dtctl dtctl doctor # Проверка настройки


Или установите навык dtctl напрямую через dtctl: `dtctl skills install`

### Dynatrace MCP Server

**[Dynatrace MCP server](https://docs.dynatrace.com/docs/shortlink/dynatrace-mcp-server)** предоставляет доступ к Dynatrace API через MCP. Плагин Claude Code автоматически включает конфигурацию MCP сервера — просто задайте `DT_ENVIRONMENT` и `DT_PLATFORM_TOKEN`, как выше. Для других агентов, поддерживающих MCP нативно, смотрите документацию к [MCP server](https://docs.dynatrace.com/docs/shortlink/dynatrace-mcp-server).

MCP server удалён — Dynatrace размещает его, поэтому ничего устанавливать не требуется. Выпуски публикуются в [официальный MCP-регистроф](https://registry.modelcontextprotocol.io) как `io.github.Dynatrace/dynatrace-for-ai`, чтобы MCP‑хосты, читающие реестр, могли добавить его по названию.

## Навыки

### DQL & Язык запросов

| Навык | Описание |
| --- | --- |
| dt-dql-essentials | Правила синтаксиса DQL, распространённые ловушки и типовые паттерны запросов. Загружайте этот навык перед написанием любых DQL-запросов. |

### Наблюдаемость

| Навык | Описание |
| --- | --- |
| dt-obs-services | Метрики RED сервисов и телеметрия времени выполнения для .NET, Java, Node.js, Python, PHP и Go. |
| dt-obs-frontends | Real User Monitoring, Web Vitals, сессии пользователей, сбои мобильных устройств и ошибки на фронтенде. |
| dt-obs-tracing | Распределённые трассы, зависимости сервисов и детекция сбоев. |
| dt-obs-hosts | Метрики хостов и процессов: CPU, память, диск, сеть и контейнеры. |
| dt-obs-kubernetes | Kubernetes-кластеры, поды, ноды, нагрузки, лейблы и взаимосвязи ресурсов. |
| dt-obs-aws | Ресурсы AWS: EC2, RDS, Lambda, ECS/EKS, VPC, балансировщики и оптимизация затрат. |
| dt-obs-azure | Ресурсы Azure: VM, VMSS, SQL Database, Storage, AKS, App Service, Functions, VNet, Event Hubs, Container Apps, Key Vault. |
| dt-obs-gcp | Ресурсы GCP: Compute Engine, GKE, Cloud Run, Pub/Sub, VPC, DNS, IAM, Secret Manager. |
| dt-obs-logs | Запросы к логам, фильтрация, анализ шаблонов и корреляция логов. |
| dt-obs-problems | Сущности проблем, анализ корневой причины, оценка влияния и корреляция проблем. |
| dt-obs-predictive-analytics | Прогнозирование временных рядов, планирование насыщения ёмкости и обнаружение тенденций/аномалий по хостам, сервисам и инфраструктуре. |
| dt-alerting | Конец‑в‑конца жизненного цикла оповещений: настройка детекторов аномалий, события оповещений в Grail, группировка проблем и маршрутизация уведомлений. |
| dt-obs-analytics | Анализ панелей Dynatrace и ноутбуков с использованием анализаторов Davis: обнаружение аномалий, оценка новизны и корреляция метрик. |
| dt-obs-ext-monitors | Импорт результатов внешних тестов и мониторингов в Dynatrace Grail через API входа событий платформы. |
| dt-obs-genai | Анализ сигналов наблюдаемости из GenAI‑приложений: «золотые» сигналы, аналитика затрат/за токен LLM, поведение вызовов инструментов агента и результаты оценки. |
| dt-obs-log-semantic-mapping | Предложение и проверка семантических соответствий словарей для интеграции аудиторских логов, с использованием payload поставщиков или живых событий. |

### Безопасность

| Навык | Описание |
| --- | --- |
| dt-sec-insights | Запросы и анализ данных безопасности в security.events: Runtime Vulnerability Analytics, Runtime Application Protection, Automated Detections (MITRE ATT&CK), и Security Posture Management (KSPM/CSPM). |
| dt-sec-contextualization | Соединение сигналов безопасности и совпадений IoC с рантайм‑сущностями, сопряжение находок на разных уровнях топологии через общую рантайм‑сущность. |
| dt-sec-ioc-hunting | Поиск индикаторов компрометации в логах и трассах, формирование рейтинга угроз. |
| dt-sec-semantic-mapping | Предложение и проверка семантических соответствий словарей для новых интеграций безопасности, с использованием примеров API поставщиков или живых событий. |

### Мобильная инструментализация

| Навык | Описание |
| --- | --- |
| dt-obs-android | Инструментирование существующего проекта Android (Kotlin или Java) с Dynatrace Mobile Agent: плагин Gradle, конфигурация агента и выбор пользователя по приватности. |
| dt-obs-flutter | Интеграция Dynatrace Flutter Plugin: настройка зависимостей, конфигурация, загрузка SDK, трекинг навигации и проверка. |
| dt-obs-ios | Подключение Dynatrace iOS SDK через Swift Package Manager: зависимость SPM, Dynatrace.plist, opt-in приватности и проверка сборки в Xcode. |
| dt-obs-react-native | Интеграция Dynatrace React Native Plugin для bare React Native и Expo: настройка зависимостей, dynatrace.config.js, регистрация Babel, трекинг навигации и проверка. |

### Платформа

| Навык | Описание |
| --- | --- |
| dt-app-dashboards | Создание, изменение и анализ Dynatrace dashboards: плитки, макеты, переменные и визуализация. |
| dt-app-notebooks | Создание, изменение и анализ Dynatrace notebooks: разделы, запросы DQL и аналитические рабочие процессы. |
| dt-js-runtime | Серверный рантайм Dynatrace на JavaScript: контракт функций, лимиты рантайма, Web APIs, модули Node.js и каталог @dynatrace-sdk/*. |
| dt-platform-costs | Запрос и анализ фактических данных по биллингу и использованию в арендаторе Dynatrace с использованием DQL: развернение потребления DPS, ранги затрат, chargeback/showback, драйверы затрат и детализация затрат на сущности. |

### Миграция

| Навык | Описание |
| --- | --- |
| dt-migration | Перевод классической DQL и навигации topology на эквиваленты Smartscape. |

## Промпты

**Промпты** — повторяемые шаблоны задач для типовых рабочих процессов Dynatrace. Их можно копировать из директории `/prompts/` и вставлять напрямую в любой AI‑чат. Для пользователей VS Code/GitHub Copilot скопируйте промпты в `.github/prompts/`, чтобы использовать их как команды с косой чертой (например, `/troubleshoot-problem`).

Каждый промпт ссылается на соответствующие выше навыки — загрузите их сначала для достижения наилучших результатов.

| Промпт | Описание |
| --- | --- |
| dt-daily-standup | Сформировать дневной стендап по одному или нескольким сервисам. |
| dt-health-check | Проверка состояния сервиса в продакшене. |
| dt-incident-response | Реагирование на активный инцидент в продакшене: этапы разборa, коренная причина и отчёт, который можно поделиться. |
| dt-investigate-error | Расследование последних ошибок через Davis Problems как точку входа (проблемы → логи → трассы). |
| dt-performance-regression | Анализ, вызвал ли недавний релиз регрессию производительности. |
| dt-troubleshoot-problem | Поиск причин проблемы в Dynatrace с помощью структурированного анализа логов и трасс. |

## Как работают навыки

Навыки следуют спецификации [Agent Skills](https://agentskills.io/specification) и применяют постепенное раскрытие информации:

- **Каталог** — агенты загружают только `name` и `description` (~100 токенов на навык), чтобы понять, что доступно.

- **Инструкции** — при необходимости загружается полный `SKILL.md` (<5000 токенов).

- **Ресурсы** — подробные справочные файлы в `references/` загружаются по требованию.

Устанавливайте все навыки без штрафа. Агенты загружают только то, что им нужно.

## Вклад

Контент навыков (`skills/`) поддерживается внутри Dynatrace и периодически публикуется здесь. **PR, в которых изменяются файлы навыков, приниматься не будут** — пожалуйста, [сообщите об этом через issue](https://github.com/Dynatrace/dynatrace-for-ai/blob/main/../../issues/new), чтобы предложить изменения. См. [CONTRIBUTING.md](https://github.com/Dynatrace/dynatrace-for-ai/blob/main/CONTRIBUTING.md) для подробностей того, что можно внести непосредственно.

## Лицензия

Apache-2.0