Логи сервиса

GET /v1/infra/servers/:id/logs

Возвращает логи BLACKHOLE-сервера через системную утилиту journalctl с фильтрацией по количеству строк, временному окну и подстроке. При деплое по умолчанию создаётся юнит app.service, если не указали другое имя.

Параметры

Примеры

curl — личный ключ

# Логи приложения за последний час с фильтром по "error"
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/logs?service=app&lines=100&since=1%20hour%20ago&grep=error"

# Весь системный журнал, последние 10 строк (для отладки cloud-init)
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/logs?lines=10"

curl — OAuth-приложение

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  "https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/logs?service=app&lines=50"

JavaScript — личный ключ

const params = new URLSearchParams({
  service: 'app',
  lines: '100',
  since: '30 minutes ago',
})

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/logs?${params}`,
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { data } = await res.json()
data.logs.forEach(line => console.log(line))

JavaScript — OAuth-приложение

const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/logs?service=app&lines=50`,
  {
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)

Поля ответа

Пример ответа

{
  "success": true,
  "data": {
    "service": null,
    "logs": [
      "Apr 22 11:17:02 epd65hdv07p8g89c0c06 CRON[1406]: pam_unix(cron:session): session closed for user root",
      "Apr 22 11:17:27 epd65hdv07p8g89c0c06 vibe-agent[1098]: 2026/04/22 11:17:27 [exec] id= timeout=10s workdir=\"\" command=\"uname -a\"",
      "Apr 22 11:17:28 epd65hdv07p8g89c0c06 cloud-init[975]: Reading package lists..."
    ],
    "lines": [
      "Apr 22 11:17:02 epd65hdv07p8g89c0c06 CRON[1406]: pam_unix(cron:session): session closed for user root",
      "Apr 22 11:17:27 epd65hdv07p8g89c0c06 vibe-agent[1098]: 2026/04/22 11:17:27 [exec] id= timeout=10s workdir=\"\" command=\"uname -a\"",
      "Apr 22 11:17:28 epd65hdv07p8g89c0c06 cloud-init[975]: Reading package lists..."
    ],
    "requestedLines": 50,
    "returnedLines": 3,
    "since": null,
    "grep": null
  }
}

Пример ответа при ошибке

400 — сервер в OPEN-режиме:

{
  "success": false,
  "error": {
    "code": "NOT_BLACKHOLE",
    "message": "Deployment API only available for BLACKHOLE servers"
  }
}

Ошибки

Полный список общих ошибок API — Ошибки.

Известные особенности

• Спящую отдельную виртуальную машину чтение журнала будит. Если сервер (kind: "STANDALONE") в статусе sleeping, платформа запускает пробуждение и ждёт его в том же запросе — до 6,5 минуты, и только потом читает журнал. Клиентский таймаут запроса это время обязан пережить. У galaxy-приложения чтение ведёт себя иначе — см. раздел «Galaxy-приложения» ниже.
• Формат строк — как выдаёт journalctl. Каждая строка уже содержит время, имя хоста, имя процесса и его PID — дополнительная обработка на клиенте не нужна, выводите как есть.
• Фильтр grep — простая подстрока, не регулярное выражение. Для сложных паттернов выгружайте больше строк и фильтруйте на клиенте.
• Логи агента туннеля видны без service — под именем vibe-agent. По ним ищут причину, когда приложение не отвечает через Deploy API.
• Лимит 500 строк помножен на ограничение вызовов. Ограничение lines действует на каждый запрос и между репликами не делится, а потолок вызовов делится — его действующее значение приходит в заголовке x-ratelimit-limit. Реальный потолок — 500 × значение из этого заголовка. Для большего объёма логов делайте несколько вызовов с разными since.

Galaxy-приложения

Если сервер — galaxy-приложение (kind=GALAXY_APP), эндпоинт возвращает не системный журнал хоста, а stdout/stderr самого контейнера приложения (docker logs). Параметр service для galaxy-приложений не применяется.

• Чтение не будит машину. Пока хост-галактика спит или недоступен, ответ приходит со статусом 200, пустым массивом data.logs и двумя диагностическими полями — data.hint и data.recovery. Поднимите приложение вызовом POST /v1/infra/servers/:id/wake и повторите запрос: пробуждение запускает тот же контейнер, поэтому строки, записанные до сна, остаются в журнале. Холодная галактика загружается минутами, её бюджет приходит в поле recovery.coldBootBudgetSeconds, а готовность проверяется опросом GET /v1/infra/servers/:id по полю reachability.effectiveStatus. Разбор всех полей ответа и порядок действий — Сон и пробуждение Galaxy-приложения.
• since — длительность или RFC 3339, не относительная текстовая форма. Для galaxy-приложений since принимает только длительность в секундах, минутах или часах — 10m, 2h, 24h — или метку времени RFC 3339, например 2026-06-24T10:00:00Z — для интервала в сутки используйте 24h. Относительные текстовые формы journalctl ("1 hour ago", "10 minutes ago") допустимы только для Black Hole-серверов.
• grep работает так же — простая подстрока, фильтрация на стороне платформы.

Смотрите также

• Полный деплой
• Выполнить команду
• Метрики туннеля