Datadog
Метрики, мониторы, логи и простои Datadog в процессах Pailot
Datadog — мониторинг инфраструктуры, приложений и логов. Блок ходит в API (Application Programming Interface — программный интерфейс) по ключу API и Application key (ключ приложения).
С Datadog в Pailot вы можете:
- Отправлять свои метрики и запрашивать временные ряды
- Создавать события, мониторы и простои (downtime)
- Искать и слать логи
- Смотреть, глушить и снимать мониторы
Нужны ключ API и, для части инструментов, Application key (ключ приложения). Поле site — регион (по умолчанию datadoghq.com). Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключи — в переменных окружения рабочего пространства.
Отправить свои метрики в Datadog: производительность, бизнес-метрики, свой мониторинг.
| Параметр | Тип | Обязательный | Описание |
|---|
series | string | Да | JSON-массив серий метрик: имя, тип (gauge/rate/count), точки (время/значение) и необязательные теги |
apiKey | string | Да | Ключ API Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Метрики отправлены |
errors | array | Ошибки при отправке |
Запросить временной ряд метрик Datadog: тренды, отчёты, значения.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Запрос метрик Datadog (например, avg:system.cpu.user{*}) |
from | number | Да | Начало — Unix-время в секундах |
to | number | Да | Конец — Unix-время в секундах |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
series | array | Временные ряды: имя метрики, теги, точки |
status | string | Статус запроса |
Опубликовать событие в ленту Datadog: деплой, алерт, важное происшествие.
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок события |
text | string | Да | Текст события. Поддерживается Markdown |
alertType | string | Нет | Тип: error, warning, info, success, user_update, recommendation или snapshot |
priority | string | Нет | Приоритет: normal или low |
host | string | Нет | Имя хоста события |
tags | string | Нет | Теги через запятую (например, env:production,service:api) |
aggregationKey | string | Нет | Ключ агрегации событий |
sourceTypeName | string | Нет | Тип источника события |
dateHappened | number | Нет | Unix-время события (по умолчанию сейчас) |
apiKey | string | Да | Ключ API Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
event | object | Данные созданного события |
↳ id | number | ID события |
↳ title | string | Заголовок события |
↳ text | string | Текст события |
↳ date_happened | number | Unix-время события |
↳ priority | string | Приоритет события |
↳ alert_type | string | Тип алерта |
↳ host | string | Связанный хост |
↳ tags | array | Теги события |
↳ url | string | Ссылка на событие в Datadog |
Создать монитор или алерт Datadog: метрики, проверки сервиса, события.
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Имя монитора |
type | string | Да | Тип монитора: metric alert, service check, event alert, process alert, log alert, query alert, composite, synthetics alert, slo alert |
query | string | Да | Запрос монитора (e.g., "avg(last_5m):avg:system.cpu.idle{*} < 20") |
message | string | Нет | Текст уведомления. Можно @-упоминания и Markdown |
tags | string | Нет | Теги через запятую |
priority | number | Нет | Приоритет монитора (1–5, 1 — высший) |
options | string | Нет | JSON опций монитора (thresholds, notify_no_data, renotify_interval и др.) |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
monitor | object | Данные созданного монитора |
↳ id | number | ID монитора |
↳ name | string | Имя монитора |
↳ type | string | Тип монитора |
↳ query | string | Запрос монитора |
↳ message | string | Текст уведомления |
↳ tags | array | Теги монитора |
↳ priority | number | Приоритет монитора |
↳ overall_state | string | Текущее состояние монитора |
↳ created | string | Когда создали |
↳ modified | string | Когда меняли в последний раз |
Карточка монитора по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
monitorId | string | Да | ID монитора |
groupStates | string | Нет | Состояния групп через запятую: alert, warn, no data, ok |
withDowntimes | boolean | Нет | Включить данные простоев монитора |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
monitor | object | Данные монитора |
↳ id | number | ID монитора |
↳ name | string | Имя монитора |
↳ type | string | Тип монитора |
↳ query | string | Запрос монитора |
↳ message | string | Текст уведомления |
↳ tags | array | Теги монитора |
↳ priority | number | Приоритет монитора |
↳ overall_state | string | Текущее состояние монитора |
↳ created | string | Когда создали |
↳ modified | string | Когда меняли в последний раз |
Список мониторов: фильтр по имени, тегам или состоянию.
| Параметр | Тип | Обязательный | Описание |
|---|
groupStates | string | Нет | Фильтр состояний групп: alert, warn, no data, ok |
name | string | Нет | Фильтр по имени (частичное совпадение) |
tags | string | Нет | Теги через запятую для фильтра |
monitorТеги | string | Нет | Теги мониторов через запятую |
withDowntimes | boolean | Нет | Включить данные простоев |
page | number | Нет | Номер страницы (с нуля) |
pageSize | number | Нет | Мониторов на страницу (максимум 1000) |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
monitors | array | Список мониторов |
↳ id | number | ID монитора |
↳ name | string | Имя монитора |
↳ type | string | Тип монитора |
↳ query | string | Запрос монитора |
↳ overall_state | string | Текущее состояние |
↳ tags | array | Теги |
Заглушить монитор — временно не слать уведомления.
| Параметр | Тип | Обязательный | Описание |
|---|
monitorId | string | Да | ID монитора |
scope | string | Нет | Область глушения (например, host:myhost). Если пусто — все области |
end | number | Нет | Unix-время конца глушения. Если пусто — без срока |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Монитор заглушен |
Поиск логов Datadog: разбор инцидентов, анализ, мониторинг.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Запрос логов (например, service:web-app status:error) |
from | string | Да | Начало в ISO-8601 или относительно (например, now-1h) |
to | string | Да | Конец в ISO-8601 или относительно (например, now) |
limit | number | Нет | Максимум логов (по умолчанию 50, максимум 1000) |
sort | string | Нет | Сортировка: timestamp (сначала старые) или -timestamp (сначала новые) |
indexes | string | Нет | Индексы логов через запятую |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
logs | array | Список записей лога |
↳ id | string | ID лога |
↳ content | object | Содержимое лога |
↳ timestamp | string | Время лога |
↳ host | string | Имя хоста |
↳ service | string | Имя сервиса |
↳ message | string | Текст лога |
↳ status | string | Уровень лога |
↳ timestamp | string | Время лога |
↳ host | string | Имя хоста |
↳ service | string | Имя сервиса |
↳ message | string | Текст лога |
↳ status | string | Уровень лога |
nextLogId | string | Курсор страницы |
Отправить записи логов в Datadog.
| Параметр | Тип | Обязательный | Описание |
|---|
logs | string | Да | JSON-массив логов: message и необязательно ddsource, ddtags, hostname, service |
apiKey | string | Да | Ключ API Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Логи отправлены |
Запланировать простой — не слать уведомления на время работ.
| Параметр | Тип | Обязательный | Описание |
|---|
scope | string | Да | Область простоя (например, host:myhost, env:production или * для всех) |
message | string | Нет | Сообщение на время простоя |
start | number | Нет | Unix-время начала простоя (по умолчанию сейчас) |
end | number | Нет | Unix-время конца простоя |
timezone | string | Нет | Часовой пояс простоя (например, America/New_York) |
monitorId | string | Нет | ID конкретного монитора |
monitorТеги | string | Нет | Теги мониторов через запятую (например, team:backend,priority:high) |
muteFirstRecoveryNotification | boolean | Нет | Глушить первое уведомление о восстановлении |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
downtime | object | Данные созданного простоя |
↳ id | number | ID простоя |
↳ scope | array | Область простоя |
↳ message | string | Сообщение простоя |
↳ start | number | Начало (Unix-время) |
↳ end | number | Конец (Unix-время) |
↳ active | boolean | Простой сейчас активен |
Список запланированных простоев Datadog.
| Параметр | Тип | Обязательный | Описание |
|---|
currentOnly | boolean | Нет | Только активные простои |
monitorId | string | Нет | Фильтр по ID монитора |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
downtimes | array | Список простоев |
↳ id | number | ID простоя |
↳ scope | array | Область простоя |
↳ message | string | Сообщение простоя |
↳ start | number | Начало (Unix-время) |
↳ end | number | Конец (Unix-время) |
↳ active | boolean | Простой сейчас активен |
Отменить запланированный простой.
| Параметр | Тип | Обязательный | Описание |
|---|
downtimeId | string | Да | ID простоя |
apiKey | string | Да | Ключ API Datadog |
applicationKey | string | Да | Ключ приложения Datadog (Application key) |
site | string | Нет | Сайт/регион Datadog (по умолчанию datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Простой отменён |
