ВозможностиДокументацияЦеныPlaygroundFAQ

Commands

История команд и метаданные выполнения

Обзор

Commands хранит выполненные команды с метаданными: timestamp, агент, статус результата, exit code, время выполнения. Полезно для аудита, аналитики и понимания паттернов использования системы.

Модель данных

{
  "id": "cmd_abc123",
  "agent_id": "my-server",
  "command": "ls -la /var/www",
  "status": "success",
  "exit_code": 0,
  "started_at": "2026-04-21T20:00:00Z",
  "completed_at": "2026-04-21T20:00:01.234Z",
  "execution_time_ms": 1234,
  "error": null,
  "input_risk": 0,
  "level": 1,
  "metadata": {
    "user": "root",
    "cwd": "/root"
  }
}

API эндпоинты

bash
# Получить историю команд
GET /api/v1/commands/history

# Получить одну команду
GET /api/v1/commands/history/{id}

# Получить статистику команд
GET /api/v1/commands/stats

# Запрос по агенту
GET /api/v1/commands/history?agent_id=...

# Запрос по тегу
GET /api/v1/commands/history?tag=production

Эндпоинты статистики

bash
# Получить топ команд по частоте
GET /api/v1/commands/stats/top?limit=10

# Получить ошибки команд
GET /api/v1/commands/stats/errors

# Получить среднее время выполнения
GET /api/v1/commands/stats/avg-execution-time

# Получить политику хранения
GET /api/v1/commands/stats/retention

Примеры запросов

bash
# Получить последние 100 команд
curl https://flowlink.flow-masters.ru/api/v1/commands/history?limit=100&order=desc

# Получить команды с конкретного агента
curl https://flowlink.flow-masters.ru/api/v1/commands/history?agent_id=prod-db-01

# Получить неудачные команды за сегодня
curl https://flowlink.flow-masters.ru/api/v1/commands/stats/errors?date=today

# Получить топ 20 самых используемых команд
curl https://flowlink.flow-masters.ru/api/v1/commands/stats/top?limit=20

Политика хранения

Политика по умолчанию:

7 days

Успешные команды

30 days

Неудачные команды

90 days

Критические/аудите команды

Удаление

Старше политики хранения

Сценарии использования

  • Auditing: Отслеживать кто выполнял какие команды и когда
  • Compliance: Команды безопасности просматривают историю команд
  • Analytics: Понимать паттерны использования системы
  • Debugging: Восстановить что произошло во время инцидентов