Datadog
Мониторинг инфраструктуры, приложений и логов с помощью Datadog
Datadog — это комплексная платформа мониторинга и аналитики для инфраструктуры, приложений, логов и многого другого. Она позволяет организациям получать реальную видимость состояния и производительности систем, обнаруживать аномалии и автоматизировать реагирование на инциденты.
С помощью Datadog вы можете:
- Мониторить метрики: Собирать, визуализировать и анализировать метрики с серверов, облачных сервисов и пользовательских приложений.
- Запрашивать данные временных рядов: Выполнять расширенные запросы к метрикам производительности для анализа трендов и создания отчетов.
- Управлять мониторами и событиями: Настраивать мониторы для обнаружения проблем, активации оповещений и создания событий для наблюдаемости.
- Обрабатывать простои: Планировать и программно управлять запланированными простоями для подавления оповещений во время технического обслуживания.
- Анализировать логи и трассировки (с дополнительной настройкой в Datadog): Централизовать и проверять логи или распределенные трассировки для глубокого устранения неполадок.
Интеграция Datadog в AACFlow позволяет вашим агентам автоматизировать эти операции и взаимодействовать с вашей учетной записью Datadog программно. Используйте её для отправки пользовательских метрик, запроса данных временных рядов, управления мониторами, создания событий и оптимизации рабочих процессов мониторинга непосредственно в автоматизациях AACFlow.
Интегрируйте мониторинг Datadog в рабочие процессы. Отправляйте метрики, управляйте мониторами, запрашивайте логи, создавайте события, обрабатывайте простои и многое другое.
Отправляет пользовательские метрики в Datadog. Используется для отслеживания производительности приложений, бизнес-метрик или пользовательских данных мониторинга.
| Параметр | Тип | Обязательный | Описание |
|---|
series | string | Да | JSON-массив серий метрик для отправки. Каждая серия должна включать имя метрики, тип (gauge/rate/count), точки (пары timestamp/value) и опциональные теги. |
apiKey | string | Да | API-ключ Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли отправлены метрики |
errors | array | Любые ошибки, возникшие во время отправки |
Запрашивает данные метрик временных рядов из Datadog. Используется для анализа трендов, создания отчетов или получения значений метрик.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Запрос метрик Datadog (например, "avg:system.cpu.user{*}", "sum:nginx.requests{env:prod}.as_count()") |
from | number | Да | Время начала в формате Unix timestamp в секундах (например, 1705320000) |
to | number | Да | Время окончания в формате Unix timestamp в секундах (например, 1705323600) |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
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 | Нет | Имя хоста для ассоциации с этим событием (например, "web-server-01", "prod-api-1") |
tags | string | Нет | Список тегов через запятую (например, "env:production,service:api", "team:backend,priority:high") |
aggregationKey | string | Нет | Ключ для агрегации событий |
sourceTypeName | string | Нет | Имя типа источника для события |
dateHappened | number | Нет | Unix timestamp в секундах, когда произошло событие (например, 1705320000, по умолчанию: сейчас) |
apiKey | string | Да | API-ключ Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
event | object | Детали созданного события |
↳ id | number | ID события |
↳ title | string | Заголовок события |
↳ text | string | Текст события |
↳ date_happened | number | Unix timestamp, когда произошло событие |
↳ priority | string | Приоритет события |
↳ alert_type | string | Тип оповещения |
↳ host | string | Ассоциированный хост |
↳ tags | array | Теги события |
↳ url | string | URL для просмотра события в 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 | Да | Запрос монитора (например, "avg(last_5m):avg:system.cpu.idle{*} < 20", "logs("status:error").index("main").rollup("count").last("5m") > 100") |
message | string | Нет | Сообщение для включения в уведомления. Может содержать @-упоминания и markdown. |
tags | string | Нет | Список тегов через запятую |
priority | number | Нет | Приоритет монитора (1-5, где 1 — наивысший) |
options | string | Нет | JSON-строка опций монитора (пороги, notify_no_data, renotify_interval и т.д.) |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
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 монитора для получения (например, "12345678") |
groupStates | string | Нет | Состояния групп для включения через запятую (например, "alert,warn", "alert,warn,no data,ok") |
withDowntimes | boolean | Нет | Включать данные о простоях с монитором |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
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 | Временная метка последнего изменения |
Выводит список всех мониторов в Datadog с опциональной фильтрацией по имени, тегам или состоянию.
| Параметр | Тип | Обязательный | Описание |
|---|
groupStates | string | Нет | Состояния групп для фильтрации через запятую (например, "alert,warn", "alert,warn,no data,ok") |
name | string | Нет | Фильтрация мониторов по имени с частичным совпадением (например, "CPU", "Production") |
tags | string | Нет | Список тегов для фильтрации через запятую (например, "env:prod,team:backend") |
monitorTags | string | Нет | Список тегов мониторов для фильтрации через запятую (например, "service:api,priority:high") |
withDowntimes | boolean | Нет | Включать данные о простоях с мониторами |
page | number | Нет | Номер страницы для пагинации (0-индексированный, например, 0, 1, 2) |
pageSize | number | Нет | Количество мониторов на странице (например, 50, максимум: 1000) |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
monitors | array | Список мониторов |
↳ id | number | ID монитора |
↳ name | string | Имя монитора |
↳ type | string | Тип монитора |
↳ query | string | Запрос монитора |
↳ overall_state | string | Текущее состояние |
↳ tags | array | Теги |
Отключает монитор для временного подавления уведомлений.
| Параметр | Тип | Обязательный | Описание |
|---|
monitorId | string | Да | ID монитора для отключения (например, "12345678") |
scope | string | Нет | Область для отключения (например, "host:myhost", "env:prod"). Если не указано, отключает все области. |
end | number | Нет | Unix timestamp в секундах, когда отключение должно закончиться (например, 1705323600). Если не указано, отключает на неопределенный срок. |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли отключен монитор |
Ищет и получает логи из Datadog. Используется для устранения неполадок, анализа или мониторинга.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Запрос поиска логов с использованием синтаксиса запросов Datadog (например, "service:web-app status:error", "host:prod-* @http.status_code:500") |
from | string | Да | Время начала в формате ISO-8601 или относительное время (например, "now-1h", "now-15m", "2024-01-15T10:00:00Z") |
to | string | Да | Время окончания в формате ISO-8601 или относительное время (например, "now", "now-5m", "2024-01-15T12:00:00Z") |
limit | number | Нет | Максимальное количество логов для возврата (например, 50, 100, максимум: 1000) |
sort | string | Нет | Порядок сортировки: "timestamp" для старых сначала, "-timestamp" для новых сначала |
indexes | string | Нет | Список индексов логов для поиска через запятую |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
logs | array | Список записей логов |
↳ id | string | ID лога |
↳ content | object | Содержимое лога |
↳ 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 timestamp для начала простоя в секундах (например, 1705320000, по умолчанию: сейчас) |
end | number | Нет | Unix timestamp для окончания простоя в секундах (например, 1705323600) |
timezone | string | Нет | Часовой пояс для простоя (например, "America/New_York", "UTC", "Europe/London") |
monitorId | string | Нет | Конкретный ID монитора для отключения (например, "12345678") |
monitorTags | string | Нет | Теги мониторов для сопоставления через запятую (например, "team:backend,priority:high") |
muteFirstRecoveryNotification | boolean | Нет | Отключить первое уведомление о восстановлении |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
downtime | object | Детали созданного простоя |
↳ id | number | ID простоя |
↳ scope | array | Область простоя |
↳ message | string | Сообщение простоя |
↳ start | number | Время начала (Unix timestamp) |
↳ end | number | Время окончания (Unix timestamp) |
↳ active | boolean | Активен ли простой в данный момент |
Выводит список всех запланированных простоев в Datadog.
| Параметр | Тип | Обязательный | Описание |
|---|
currentOnly | boolean | Нет | Возвращать только текущие активные простои |
monitorId | string | Нет | Фильтровать по ID монитора (например, "12345678") |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
downtimes | array | Список простоев |
↳ id | number | ID простоя |
↳ scope | array | Область простоя |
↳ message | string | Сообщение простоя |
↳ start | number | Время начала (Unix timestamp) |
↳ end | number | Время окончания (Unix timestamp) |
↳ active | boolean | Активен ли простой в данный момент |
Отменяет запланированный простой.
| Параметр | Тип | Обязательный | Описание |
|---|
downtimeId | string | Да | ID простоя для отмены (например, "abc123def456") |
apiKey | string | Да | API-ключ Datadog |
applicationKey | string | Да | Ключ приложения Datadog |
site | string | Нет | Сайт/регион Datadog (по умолчанию: datadoghq.com) |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли отменен простой |
