Каталог MCP
TANTIOPE/datadog-mcp-server

TANTIOPE/datadog-mcp-server

Name: TANTIOPE/datadog-mcp-server
Availability: InStock
Author: tantiope

MCP сервер для AI-ассистентов, открывающий полный доступ к Datadog: поиск логов, фильтрация APM-трейсов, запрос метрик, управление мониторами и дашбордами. Помогает SRE и разработчикам быстро разбирать инциденты, не переключаясь между инструментами.

Github NPM Сайт сервера

README

23 инструмента

Версии

Установить сервер

Datadog MCP Server

DISCLAIMER: This is a community-maintained project and is not officially affiliated with, endorsed by, or supported by Datadog, Inc. This MCP server utilizes the Datadog API but is developed independently.

MCP server providing AI assistants with full Datadog observability access. Features grep-like log search, APM trace filtering with duration/status/error queries, smart sampling modes for token efficiency, and cross-correlation between logs, traces, and metrics. Supports both stdio (local) and http (remote/Kubernetes) transports.

Quick Start

Minimal Claude Desktop / VS Code / Cursor config — just the two required keys:

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": ["-y", "datadog-mcp"],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

With optional tuning (EU site, custom default limits, longer log windows):

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": ["-y", "datadog-mcp"],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key",
        "DD_SITE": "datadoghq.eu",
        "MCP_DEFAULT_LIMIT": "50",
        "MCP_DEFAULT_LOG_LINES": "200",
        "MCP_DEFAULT_METRIC_POINTS": "1000",
        "MCP_DEFAULT_TIME_RANGE": "24"
      }
    }
  }
}

Инструменты были проиндексированы: 18.10.2026

auth

Проверяет учетные данные API Datadog. Используется для проверки того, что API key и App key настроены правильно, перед выполнением других операций.

Параметры

actionenumобязательный
Проверяет, действительны ли API-ключ и ключ приложения.

dashboards

Предоставляет доступ к дашбордам и визуализациям Datadog. Действия: - list: Фильтрует дашборды по имени/тегам - get: Получает полную конфигурацию дашборда, включая виджеты (полезно для изучения шаблонов) - create: Создаёт новый дашборд - update: Изменяет существующий дашборд - delete: Удаляет дашборд - validate: Проверяет конфигурацию дашборда без создания (помогает отлаживать определения виджетов) Поддерживаемые форматы виджетов: - Простой: { "type": "timeseries", "requests": [{ "q": "avg:metric{*}" }] } - Расширенный: { "type": "timeseries", "requests": [{ "queries": [...], "formulas": [...] }] } Теги должны использовать формат key:value (например, ["team:ops", "env:prod"]).

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация дашборда (для создания/обновления)
idstring
Идентификатор панели управления (обязателен для получения, обновления или удаления)
limitnumber
Максимальное количество возвращаемых дашбордов (по умолчанию: 50)
namestring
Фильтровать по имени
tagsstring[]
Фильтр по тегам

downtimes

Управляет запланированными простоями Datadog для окон обслуживания. Действия: list, get, create, update, cancel, listByMonitor. Используется для: планирования обслуживания, предотвращения ложных оповещений во время развертываний, управления повторяющимися окнами обслуживания.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация периода простоя (для создания/обновления). Должна включать область и расписание.
currentOnlyboolean
Возвращает только активные даунтаймы (для списка).
idstring
Downtime ID (требуется для get/update/cancel)
limitnumber
Максимальное количество возвращаемых даунтаймов (по умолчанию: 50)
monitorIdnumber
Monitor ID (требуется для listByMonitor)

events

Отслеживает события Datadog. Действия: list, get, create, search, aggregate, top, timeseries, incidents, discover, histogram. Для оповещений монитора используйте теги: ["source:alert"]. ВАЖНО — переоценка vs переход: - События source:alert ВКЛЮЧАЮТ повторные уведомления и переоценки (каждая переоценка Datadog оповещающего монитора порождает событие). Вопрос «сколько раз сработал монитор X», отвеченный только с source:alert, завышает количество. - Чтобы ограничиться реальными переходами состояний, передайте transitionType (например, ["alert","alert recovery"]). Это добавляет @monitor.transition.transition_type:(...) к запросу и соответствует живой проверке в дизайне. - Для числового подсчёта только срабатываний, привязанного к одному ID монитора, отдайте предпочтение более высокоуровневому примитиву monitors action=history — он возвращает {transitions, count, meta} с уже применённым тем же фильтром. transitionType: Необязательный массив типов переходов монитора (alert, alert recovery, warning, warning recovery, no data, no data recovery, renotify). Пустой массив считается неопределённым. top: Общая группировка событий по любым полям (параметр groupBy). Возвращает группы, отсортированные по количеству, с возможной разбивкой по контексту. - Пример: {groupBy: ["service"], message: "...", service: "api", total_count: 50, by_context: [{context: "queue:X", count: 30}]} - Используйте для развёртываний, конфигураций, пользовательских событий или оповещений монитора - Возвращает поле "message" (заголовок события), НЕ имя монитора (используйте инструмент monitors для получения настоящих имён) - total_count включает повторные уведомления, когда используется source:alert без transitionType — смотрите monitors action=history для подсчёта только срабатываний discover: Возвращает доступные префиксы тегов из событий. aggregate: Пользовательская группировка groupBy, возвращает ключи, разделённые вертикальной чертой. search: Полные детали события. timeseries: Тренды с разбивкой по временным интервалам. incidents: Дедублицирует оповещения с помощью dedupeWindow. histogram: Группирует события по локальному часу дня / дню недели / дню месяца в указанном часовом поясе IANA (с учётом перехода на летнее время). Передайте bucket_by (обязательно) и опционально timezone (по умолчанию…)

Параметры

actionenumобязательный
Выполняемое действие.
alertTypeenum
Тип оповещения (для создания)
bucket_byenum
Измерение сегмента для действия гистограммы: час_дня (0-23), день_недели (0=Вс..6=Сб), день_месяца (1-31).
contextTagsstring[]
Префиксы тегов для разбивки контекста в действии top (по умолчанию: queue, service, ingress, pod_name, kube_namespace, kube_container_name)
cursorstring
Курсор пагинации из предыдущего ответа
dedupeWindowstring
Окно дедупликации для инцидентов: 5м, 15м, 1ч (по умолчанию: 5м)
enrichboolean
Обогащает события метаданными монитора (медленнее, но добавляет детали мониторинга)
fieldsstring[]
Действие поиска: возвращать только эти поля события. Допустимые значения: id, title, message, timestamp, priority, source, tags, alertType, host, monitorId, monitorInfo, monitorMetadata (заполняется только при enrich=true). По умолчанию: полное событие.
fromstring
Время начала (ISO 8601, относительное значение, например «1h», или Unix timestamp)
groupBystring[]
Поля для группировки (для агрегирующих и топ-действий). Для топ: пользовательские поля, например ["service"], ["user"]. Для агрегирования: monitor_name, priority, alert_type, source. По умолчанию для топ: ["monitor_id"].
idstring
Идентификатор события (для действия получения)
intervalstring
Интервал временного бакета для временных рядов: 1h, 4h, 1d (по умолчанию: 1h)
limitnumber
Максимальное количество событий для возврата (по умолчанию: 50)
maxEventsnumber
Максимальное количество событий для группировки в операции top (по умолчанию: 5000, максимум: 5000). Больше — точнее, но медленнее.
priorityenum
Приоритет событий
querystring
Поисковый запрос
sourcesstring[]
Фильтр по источникам
tagsstring[]
Фильтр по тегам
textstring
Текст события (для создания)
timezonestring
Необязательный часовой пояс IANA (например, «UTC», «Europe/Paris»). Устойчив к DST. Для гистограммы: управляет группировкой по часам/дням (по умолчанию: UTC). Для операций чтения search/aggregate/top/incidents: добавляет смежные строки *Local ISO 8601 (например, timestampLocal) рядом с существующими отметками времени. Опустите для байт-идентичной устаревшей формы.
titlestring
Название события (для создания)
tostring
Время окончания (ISO 8601, относительный формат, например "1h", или Unix timestamp)
transitionTypeenum[]
Фильтрует события по типу перехода состояния монитора. Когда установлено, ограничивает результаты событиями, у которых @monitor.transition.transition_type совпадает с любым значением. Для подсчета реальных срабатываний/восстановлений и пропуска повторных уведомлений используются значения ["alert","alert recovery"]. Пустой массив считается неопределенным (без фильтра). Для подсчета только срабатываний по идентификатору монитора предпочтительным является monitors action=history.

hosts

Управляет хостами инфраструктуры Datadog. Действия: список (с фильтрами), итоги (количество), отключение звука (отключает оповещения), включение звука. Используется для: инвентаризации инфраструктуры, проверки состояния хостов, отключения шумных хостов во время обслуживания.

Параметры

actionenumобязательный
Выполняемое действие.
countnumber
Количество возвращаемых хостов
endnumber
Метка времени окончания отключения звука (POSIX). Не указывайте для бессрочного отключения звука.
filterstring
Фильтрует хосты по имени, псевдониму или тегу (например, «env:prod»)
fromnumber
Начальное смещение для пагинации.
hostNamestring
Имя хоста (обязательно для mute/unmute)
messagestring
Сообщение с причиной отключения звука.
overrideboolean
Если задано true, заменяет существующий режим без звука, а не возвращает ошибку.
sortDirenum
Направление сортировки
sortFieldstring
Поле сортировки (например, "apps", "cpu", "name")

incidents

Управляет инцидентами Datadog для реагирования на инциденты. Действия: список, получение, поиск, создание, обновление, удаление. Используется для: управления инцидентами, реагирования по вызову, постмортемов, отслеживания MTTR/MTTD.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация инцидента (для создания/обновления). При создании требуется: title. При обновлении можно изменить: title, status, severity, fields.
idstring
Incident ID (обязателен для get/update/delete)
limitnumber
Максимальное количество возвращаемых инцидентов (по умолчанию: 50)
querystring
Поисковый запрос (для поискового действия)
statusenum
Фильтрует по статусу (для списка)

logs

Выполняет поиск логов Datadog с текстовой фильтрацией наподобие grep. Действия: search (поиск логов), aggregate (подсчёт/группировка). Ключевые фильтры: keyword (текстовый grep), pattern (регулярное выражение), service, host, status (error/warn/info). Диапазоны времени: "1h", "3d@11:45:23". CORRELATION: Логи содержат атрибут dd.trace_id для привязки к трейсам и метрикам APM. SAMPLING: Используй sample:"diverse" для расследования ошибок (дедуплицирует по шаблону сообщения), sample:"spread" для распределения по времени. TOKEN TIP: Используй compact:true, чтобы уменьшить размер полезной нагрузки (убирает тяжёлые поля) при запросе больших объёмов.

Параметры

actionenumобязательный
Выполняемое действие.
compactboolean
Удаляет пользовательские атрибуты для экономии токенов. Сохраняет: id, timestamp, service, host, status, message (truncated), dd.trace_id, dd.span_id, pod_name, kube_namespace, kube_container_name, error info
computeobject
Вычисляет операции над агрегированными данными.
fromstring
Начало времени. Форматы: ISO 8601, относительные (30s, 15m, 2h, 7d), точные (3d@11:45:23, yesterday@14:00).
groupBystring[]
Поля для группировки (для агрегации)
hoststring
Фильтрует по хосту.
indexesstring[]
Индексы журналов для поиска
keywordstring
Простой текстовый поиск - находит логи, содержащие этот текст (как grep). Объединяется с запросом через AND.
limitnumber
Максимальное количество возвращаемых логов (по умолчанию: 200)
patternstring
Regex-шаблон для поиска в сообщении лога (в стиле grep -E). Пример: "ERROR.*timeout|connection refused"
querystring
Поисковый запрос по логам (синтаксис Datadog). Примеры: "error", "service:my-service status:error", "error AND timeout"
sampleenum
Режим выборки: первый (хронологический, по умолчанию), распределённый (равномерно по временному диапазону), разнообразный (различные паттерны сообщений)
servicestring
Фильтровать по имени службы
sortenum
Порядок сортировки
statusenum
Фильтрует по статусу/уровню лога.
tostring
Время окончания. Те же форматы, что и у "from". Пример: from="3d@11:45:23" to="3d@12:55:34"

logs_archives

Управляет архивами журналов Datadog (долгосрочное хранение журналов в S3, GCS или Azure Blob). Действия: list, get, create, update, delete, reorder, get_order. Архивы принимают места назначения типа 's3', 'gcs' или 'azure_storage'; учётные данные и поля интеграции для каждого провайдера (S3 IAM role ARN, GCS service account, Azure tenant/secret) передаются без изменений. Мутации (create, update, delete, reorder) блокируются, когда сервер находится в режиме только для чтения.

Параметры

actionenumобязательный
Выполняемое действие.
archive_idsstring[]
Упорядоченный список идентификаторов архива (требуется для изменения порядка)
configobject
Конфигурация архива (для создания/обновления). Требует name, query и destination с типом ∈ { s3, gcs, azure_storage }. Поля учётных данных и интеграции провайдера передаются без изменений.
idstring
Идентификатор архива (обязателен для get/update/delete)
verboseboolean
Возвращает полный payload SDK вместе со сводкой (по умолчанию false)

logs_indexes

Управляет индексами логов Datadog (фильтры, срок хранения, фильтры исключений, дневные лимиты). Действия: list, get, update, reorder, get_order. Datadog идентифицирует индексы по 'name', а не 'id'. Примечание: создание/удаление доступны только в UI согласно Datadog и не поддерживаются через API. Мутации (update, reorder) блокируются, когда сервер находится в режиме только для чтения.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация индекса (для обновления). Требует filter.query и numRetentionDays. Фильтры исключения передаются без изменений.
index_namesstring[]
Упорядоченный список имён индексов (требуется для переупорядочивания)
namestring
Имя индекса (обязательно для get/update). Datadog идентифицирует индексы по имени, а не по id.
verboseboolean
Возвращает полный payload SDK вместе со сводкой (по умолчанию false)

logs_pipelines

Управляет конвейерами Datadog Logs (цепочки разбора и процессоров). Действия: list, get, create, update, delete, reorder, get_order. Конвейеры выполняются последовательно над входящими логами; reorder изменяет структуру последующих данных. Изменения блокируются, когда сервер находится в режиме только для чтения. Неизвестные типы процессоров в 'config.processors' передаются в Datadog без изменений.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация пайплайна (для создания/обновления). Требует name и filter.query. Процессоры передаются без изменений.
idstring
Pipeline ID (обязателен для get/update/delete)
pipeline_idsstring[]
Упорядоченный список идентификаторов конвейера (требуется для переупорядочивания).
verboseboolean
Возвращает полный payload SDK вместе со сводкой (по умолчанию false)

metrics

Запрашивает метрики Datadog. Действия: - query — получает данные временных рядов (требуется временной диапазон from/to, PromQL-запрос) - search — ищет метрики по имени (как grep, параметр времени НЕ нужен) - list — получает недавно активные метрики (последние 24 часа, опционально фильтр по тегу) - metadata — получает детали метрики (единица измерения, тип, описание) APM-МЕТРИКИ (автоматически генерируются из трейсов): Ключом является имя ОПЕРАЦИИ (например, express.request, pg.query), а не имя сервиса. Фильтруйте по сервису через теги: {service:my-service} ПЕРЦЕНТИЛИ (p50/p75/p90/p95/p99) — используйте КОРНЕВУЮ метрику (тип distribution): p95:trace.express.request{service:my-service} СРЕДНЕЕ/СУММА/МИН/МАКС — используйте суффикс .duration (предварительно агрегированный gauge): avg:trace.express.request.duration{service:my-service} Прочие trace-метрики (gauge): - trace.<operation>.hits — количество запросов - trace.<operation>.errors — количество ошибок - trace.<operation>.apdex — Apdex-оценка Чтобы узнать имена операций для сервиса, используйте инструмент traces с действием "services".

Параметры

actionenumобязательный
Выполняемое действие.
fromstring
Start time (ТОЛЬКО для query action). Форматы: ISO 8601, relative (30s, 15m, 2h, 7d), precise (3d@11:45:23)
limitnumber
Максимальное количество результатов (для поиска/списка, по умолчанию: 50)
metricstring
Название метрики (для действия с метаданными)
pointLimitnumber
Максимальное количество точек данных на временной ряд (для действия запроса). ИИ управляет балансом между разрешением и расходом токенов (по умолчанию: 1000).
querystring
Для запроса: выражение PromQL (например, "avg:system.cpu.user{*}"). Для поиска: grep-подобный фильтр по именам метрик. Для списка: фильтр по тегам.
tagstring
Фильтр по тегу
tostring
Время окончания (ТОЛЬКО для действия query). Те же форматы, что и "from".

monitors

Управляет мониторами Datadog. Действия: list, get, search, create, update, delete, mute, unmute, top, history, preview, test_notification. Фильтры: name, tags, groupStates (alert/warn/ok/no data). get/create/update возвращают полный объект options, чтобы вызывающий код мог безопасно выполнить read-then-patch. create/update принимают объект конфигурации, проверяемый по типизированной схеме, охватывающей документированные поля Datadog Monitor: - Верхний уровень: name, type, query, message, tags, priority (1-5, может быть null), restrictedRoles, multi, options. - Проверяемые ключи в options.*, сгруппированные по категориям: - notification: notifyNoData, noDataTimeframe, notifyAudit, notificationPresetName. - evaluation/delay: newHostDelay, newGroupDelay, evaluationDelay, requireFullWindow, onMissingData. - renotification: renotifyInterval (может быть null), renotifyOccurrences, renotifyStatuses, escalationMessage. - lifecycle: timeoutH (может быть null), includeTags, locked, silenced (запись временных меток/null), groupRetentionDuration. - thresholds: thresholds (critical/warning/ok/criticalRecovery/warningRecovery/unknown), thresholdWindows. - scheduling: schedulingOptions. Неизвестные ключи (на верхнем уровне или внутри options) передаются в Datadog как есть и отображаются через опциональный массив warnings в ответе, чтобы схема не отставала от API. Псевдонимы в snake_case принимаются на входе и нормализуются в camelCase перед проверкой. Ошибки проверки прерывают выполнение до любого HTTP-вызова и отображаются как 'EINVALID_MONITOR_CONFIG: <path>: <expected>'. Справка: https://docs.datadoghq.com/api/latest/monitors/ top: Ранжированные мониторы по частоте срабатываний с реальными именами мониторов и разбивкой по контексту. - Возвращает: {rank, monitor_id, name (с {{template.vars}}), message (шаблон), total_count, by_context} - Идеально подходит для еженедельных/ежедневных отчётов по срабатываниям - Получает реальные имена мониторов из API мониторов (не заголовки событий) - ПРЕДУПРЕЖДЕНИЕ: total_count — это количество сырых событий срабатываний, которое ВКЛЮЧАЕТ повторные уведомления и переоценки. Для мониторов, застрявших…

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация монитора (для создания/обновления)
contextobject
Контекст подстановки для monitors.preview (переменные и условные конструкции).
contextTagsstring[]
Префиксы тегов для разбивки контекста в действии top (по умолчанию: queue, service, ingress, pod_name, kube_namespace, kube_container_name)
dry_runboolean
Когда create и dry_run=true, валидирует тело монитора через POST /api/v1/monitor/validate, не создавая его. Разрешено при --read-only, потому что монитор не создаётся. Возвращает { valid, dryRun, monitor }. Ответы с кодом 400 отображаются дословно, как при неудачном создании.
endnumber
Временная метка окончания беззвучия (для действия «Mute»).
fromstring
Время начала (ISO 8601, относительное значение, например «1h», или Unix timestamp)
groupstring
Для действия history: фильтрует переходы по конкретной группе multi-alert монитора (например, "pod_name:foo,kube_namespace:bar"). Необязательно; опустите, чтобы применить ко всем группам.
groupStatesstring[]
Фильтрует мониторы с несколькими оповещениями по состояниям групп (например, оповещение по хосту). НЕ фильтрует по общему статусу монитора. Значения: alert, warn, no data, ok.
idstring
Monitor ID (обязателен для get/update/delete/mute/unmute)
limitnumber
Максимальное количество возвращаемых мониторов (по умолчанию: 50).
maxEventsnumber
Максимум событий, получаемых для основного действия (по умолчанию: 5000, максимум: 5000).
messagestring
Сообщение для отключения (для действия mute) ИЛИ исходный код встрочного шаблона для действия предпросиотра. Для предпросиотра укажите либо эту встрочную строку, либо monitor_id (или сущестующее пое id), чтобы действие могло заглузить сообщение монитора через getMonior.
monitor_idnumber
Числовой идентификатор монитора, используемый действием предпросмотра, когда не указано встроенное message. Эквивалентен передаче существующего поля id в виде числовой строки.
namestring
Фильтрует по имени (для действия list)
querystring
Поисковый запрос (для поискового действия)
tagsstring[]
Фильтр по тегам
timezonestring
Необязательный часовой пояс IANA (например, "UTC", "Europe/Paris"). При передаче в get/list ответ добавляет соседние поля createdLocal/modifiedLocal в формате ISO 8601 рядом с created/modified. Опустите его для побайтово идентичной прежней формы. Недействительные зоны возвращают EINVALID_TIMEZONE.
tostring
Время окончания (ISO 8601, относительный формат, например "1h", или Unix timestamp)
transitionTypeenum[]
Для действия history: фильтруйте по типам переходов состояния монитора. По умолчанию: ["alert","alert recovery"] (реальные срабатывания + восстановления, исключая повторные уведомления). Передайте ["alert"], чтобы получить только срабатывания, или включите "renotify" для полного хронологического аудита.

notebooks

Управляет Datadog Notebooks. Действия: list (поиск notebooks), get (получение по ID с ячейками), create (создание нового notebook), update (изменение notebook), delete (удаление notebook). Используется для: runbooks, документация инцидентов, заметки расследований, панели мониторинга как код.

Параметры

actionenumобязательный
Выполняемое действие.
authorHandlestring
Фильтрует по идентификатору автора (email).
cellsobject[]
Ячейки блокнота (для создания/обновления)
excludeAuthorHandlestring
Исключает блокноты по имени автора.
idnumber
Notebook ID (обязателен для операций get/update/delete)
includeCellsboolean
Включает содержимое ячейки в ответ (по умолчанию: true для get)
namestring
Имя блокнота (для создания/обновления)
pageNumbernumber
Номер страницы для пагинации.
pageSizenumber
Количество блокнотов для возврата.
querystring
statusenum
Статус блокнота
timeobject
Настройка времени для ноутбука

rum

Запрашивает данные Datadog Real User Monitoring (RUM). Действия: applications (список RUM-приложений), events (поиск RUM-событий), aggregate (группирует и подсчитывает события), performance (Core Web Vitals: LCP, FCP, CLS, FID, INP), waterfall (временная шкала сессии с ресурсами/действиями/ошибками). Используется для: производительность фронтенда, пользовательские сессии, просмотры страниц, ошибки, загрузка ресурсов.

Параметры

actionenumобязательный
Выполняемое действие.
applicationIdstring
Идентификатор приложения для действия «водопад».
computeobject
Вычисляет конфигурацию для агрегации.
fromstring
Время начала (ISO 8601, относительное, например «1h», «7d», или точное, например «1d@10:00»)
groupBystring[]
Поля для группировки при агрегации (например, ["@view.url_path", "@session.type"])
limitnumber
Максимальное количество событий для возврата (по умолчанию: 50)
metricsenum[]
Метрики Core Web Vitals для получения (по умолчанию: все). lcp=Largest Contentful Paint, fcp=First Contentful Paint, cls=Cumulative Layout Shift, fid=First Input Delay, inp=Interaction to Next Paint, loading_time=время загрузки представления
querystring
Строка запроса RUM (например, "@type:view @application.id:abc")
sessionIdstring
Session ID для waterfall action
sortenum
Порядок сортировки событий
tostring
Время окончания (ISO 8601, относительное, например «now», или точная временная метка)
typeenum
Фильтр по типу события RUM
viewIdstring
View ID для waterfall action (необязательно, фильтрует до конкретного представления)

schema

Получает допустимые значения перечислений для полей API Datadog. Возвращает палитры, типы виджетов, агрегаторы, компараторы, временные интервалы и другие допустимые значения для создания панелей мониторинга, мониторов, запросов метрик и SLO. Используйте это, чтобы узнать допустимые варианты перед созданием или обновлением ресурсов Datadog.

Параметры

resourceenumобязательный
Тип ресурса Datadog, для которого нужно получить схему: dashboards, events, metrics, monitors, slos.

security

Запрашивает Datadog Security Monitoring. Действия: rules (перечисляет правила обнаружения), signals (ищет сигналы безопасности), findings (перечисляет результаты проверки безопасности). Используется для: обнаружения угроз, обеспечения соответствия требованиям, оценки безопасности, расследования инцидентов.

Параметры

actionenumобязательный
Выполняемое действие.
fromstring
Время начала (ISO 8601, относительное, например "1h", "7d")
idstring
Правило или идентификатор сигнала (для конкретных запросов)
pageCursorstring
Курсор для пагинации
pageSizenumber
Количество результатов для возврата.
querystring
Поисковый запрос для сигналов или результатов.
severityenum
Фильтр по серьезности
statusenum
Фильтрует сигналы по статусу.
tostring
Время окончания (ISO 8601, относительное, например «now»)

slos

Управляет Service Level Objectives (SLO) Datadog. Действия: list (со статусом SLI и error budget), get, create, update, delete, history. Типы SLO: на основе метрик, на основе мониторов. Каждый ответ list/get/create/update содержит поле url с прямой ссылкой на интерфейс Datadog. Используется для: отслеживания надёжности, запасов ошибок, соблюдения SLA, целевых показателей производительности.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация SLO (для создания/обновления). Должна включать тип, имя и пороговые значения.
fromstring
Время начала истории (ISO 8601 или относительное время, например "7d", "1w")
idstring
SLO ID (обязателен для get/update/delete/history)
idsstring[]
Несколько идентификаторов SLO (для списка с конкретными идентификаторами).
limitnumber
Максимальное количество возвращаемых SLO (по умолчанию: 50)
querystring
Поисковый запрос (для списка)
tagsstring[]
Фильтр по тегам (для списка)
tostring
Время окончания истории (ISO 8601 или относительное, по умолчанию: сейчас).

synthetics

Управляет Synthetic-тестами Datadog (API и Browser). Действия: list, get, create, update, delete, trigger, results. Используется для: мониторинга доступности, тестирования API, тестирования пользовательских сценариев, тестирования производительности, канареечных развертываний.

Параметры

actionenumобязательный
Выполняемое действие.
configobject
Конфигурация теста (для создания/обновления). Включает: name, type, config, options, locations, message.
idstring
Test public ID (требуется для get/update/delete/trigger/results)
idsstring[]
Несколько идентификаторов тестов (для массового запуска)
limitnumber
Максимальное количество возвращаемых тестов (по умолчанию: 50)
locationsstring[]
Фильтровать по местоположениям (для списка)
tagsstring[]
Фильтр по тегам (для списка)
testTypeenum
Проверьте фильтр по типу (для списка) или тип для создания.

tags

Управляет тегами хостов Datadog. Действия: list (все теги хостов), get (теги для конкретного хоста), add (создание тегов), update (замена тегов), delete (удаление всех тегов). Используется для: организации инфраструктуры, фильтрации, группировки.

Параметры

actionenumобязательный
Выполняемое действие.
hostNamestring
Имя хоста (обязательно для операций get/add/update/delete)
sourcestring
Источник тегов (например, "users", "datadog"). По умолчанию: "users".
tagsstring[]
Теги для добавления или установки (для действий добавления/обновления). Формат: "key:value"

teams

Управляет командами Datadog. Действия: список (с фильтрацией), получить (по ID), участники (список участников команды). Используется для: организации команды, управления доступом, совместной работы.

Параметры

actionenumобязательный
Выполняемое действие.
filterstring
Фильтрует команды по названию.
idstring
Team ID (обязателен для действий get/members)
pageNumbernumber
Номер страницы для пагинации.
pageSizenumber
Количество команд, возвращаемых на страницу.

traces

Анализирует трейсы APM для отладки потока запросов и задержек. Действия: search (ищет спаны), aggregate (группирует статистику), services (выводит список сервисов APM). Ключевые фильтры: minDuration/maxDuration ("500ms", "2s"), httpStatus ("5xx", ">=400"), status (ok/error), errorMessage (grep). МЕТРИКИ APM: Трейсы автоматически генерируют метрики в пространстве имён trace.<operation>.* (например, trace.express.request). Используйте инструмент метрик для запроса: avg:trace.express.request.duration{service:my-service}. Для процентилей (p95) используйте корневую метрику БЕЗ суффикса .duration: p95:trace.express.request{service:my-service}

Параметры

actionenumобязательный
Выполняемое действие.
envstring
Фильтрует по окружению. Пример: "production", "staging"
errorMessagestring
Фильтрует по сообщению об ошибке (по аналогии с grep). Пример: "timeout", "connection refused".
errorTypestring
Фильтрует по типу ошибки (как grep). Пример: «TimeoutError», «ConnectionRefused»
fromstring
Начало времени. Форматы: ISO 8601, относительные (30s, 15m, 2h, 7d), точные (3d@11:45:23, yesterday@14:00).
groupBystring[]
Поля для группировки (при агрегации). Пример: ["resource_name", "status"]
httpStatusstring
Фильтр по HTTP-коду состояния. Примеры: "500", "5xx" (500-599), "4xx" (400-499), ">=400"
limitnumber
Максимальное количество результатов (по умолчанию: 50)
maxDurationstring
Максимальная длительность спана. Примеры: "5s", "1000ms"
minDurationstring
Минимальная длительность спана (выявляет медленные спаны). Примеры: "1s", "500ms", "100ms"
operationstring
Фильтрует по имени операции. Пример: "express.request", "mongodb.query".
querystring
Поисковый запрос по трейсам APM (синтаксис Datadog). Пример: "@http.status_code:500", "service:my-service status:error"
resourcestring
Фильтрует по имени ресурса (endpoint/query). Поддерживает подстановочные знаки. Пример: "GET /api/*", "orders"
servicestring
Фильтрует по имени сервиса. Пример: "my-service", "postgres"
sortenum
Порядок сортировки
statusenum
Фильтр по статусу span: "ok" для успешных, "error" для завершившихся с ошибкой
tostring
Время окончания. Те же форматы, что и у "from". Пример: from="3d@11:45:23" to="3d@12:55:34"

usage

Запрашивает данные учёта использования Datadog. Действия: сводка (общее использование), хосты (инфраструктура), логи, пользовательские метрики, индексированные спаны, принимаемые спаны. Используется для: управления затратами, планирования ёмкости, отслеживания использования, анализа счетов.

Параметры

actionenumобязательный
Действие для выполнения: сводка (общее использование), хосты, журналы, пользовательские метрики, индексируемые спаны, принимаемые спаны.
fromstring
Время начала (дата ISO 8601, например, «2024-01-01», или относительное время, например, «30d»)
includeOrgDetailsboolean
Включите разбивку использования по организациям (для аккаунтов с несколькими организациями)
tostring
Время окончания (дата в формате ISO 8601, например «2024-01-31», или относительное время, например «now»).

users

Управляет пользователями Datadog. Действия: список (с фильтрами), получение (по ID). Используется для: управление доступом, аудит пользователей, организация команд.

Параметры

actionenumобязательный
Выполняемое действие.
filterstring
Фильтрует пользователей по имени или email.
idstring
User ID (требуется для действия get)
pageNumbernumber
Номер страницы для пагинации.
pageSizenumber
Количество возвращаемых пользователей на страницу
statusenum
Фильтр по статусу пользователя

`5.8.2`основная	29.06.2026
`5.8.1`	14.05.2026
`5.8.0`	14.05.2026
`5.7.0`	14.05.2026
`5.6.0`	14.05.2026
`5.5.0`	14.05.2026
`5.4.0`	14.05.2026
`5.3.4`	11.03.2026
`5.3.3`	13.02.2026
`5.3.2`	10.02.2026
`5.3.1`	09.02.2026
`5.3.0`	28.01.2026
`5.2.1`	28.01.2026
`5.2.0`	28.01.2026
`5.1.1`	27.01.2026
`5.1.0`	27.01.2026
`5.0.0`	23.12.2025
`4.0.1`	23.12.2025
`4.0.0`	23.12.2025
`3.0.0`	23.12.2025
`2.0.2`	23.12.2025
`2.0.1`	22.12.2025
`2.0.0`	22.12.2025
`1.1.1`	20.12.2025
`1.0.11`	20.12.2025
`1.0.10`	20.12.2025
`1.0.9`	19.12.2025
`1.0.8`	19.12.2025
`1.0.7`	19.12.2025
`1.0.6`	19.12.2025
`1.0.5`	18.12.2025
`1.0.4`	18.12.2025
`1.0.2`	18.12.2025
`1.0.0`	18.12.2025

Выберите клиент, чтобы установить TANTIOPE/datadog-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"tantiope-datadog-mcp-server-5ys90b7c8y\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"datadog-mcp\"],\"env\":{\"DD_API_KEY\":\"your-api-key\",\"DD_APP_KEY\":\"your-app-key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add tantiope-datadog-mcp-server-5ys90b7c8y --env DD_API_KEY=your-api-key --env DD_APP_KEY=your-app-key -- npx -y datadog-mcp

Либо через JSON-конфиг:

claude mcp add-json tantiope-datadog-mcp-server-5ys90b7c8y "{\"command\":\"npx\",\"args\":[\"-y\",\"datadog-mcp\"],\"env\":{\"DD_API_KEY\":\"your-api-key\",\"DD_APP_KEY\":\"your-app-key\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add tantiope-datadog-mcp-server-5ys90b7c8y --env DD_API_KEY=your-api-key --env DD_APP_KEY=your-app-key -- npx -y datadog-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.tantiope-datadog-mcp-server-5ys90b7c8y]
command = "npx"
args = ["-y", "datadog-mcp"]

[mcp_servers.tantiope-datadog-mcp-server-5ys90b7c8y.env]
DD_API_KEY = "your-api-key"
DD_APP_KEY = "your-app-key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите TANTIOPE/datadog-mcp-server, а в поле команды запуска — строку ниже:

npx -y datadog-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например tantiope-datadog-mcp-server-5ys90b7c8y.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: tantiope-datadog-mcp-server-5ys90b7c8y
    command: npx
    args:
      - "-y"
      - "datadog-mcp"
    env:
      DD_API_KEY: your-api-key
      DD_APP_KEY: your-app-key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "tantiope-datadog-mcp-server-5ys90b7c8y": {
      "command": "npx",
      "args": [
        "-y",
        "datadog-mcp"
      ],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "datadog-mcp"
  ],
  "env": {
    "DD_API_KEY": "your-api-key",
    "DD_APP_KEY": "your-app-key"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx