Логи нужны для диагностики ошибок frontend, gateway, bootstrap и внутренних микросервисов.
Когда нужны логи
- страница пустая, хотя данные должны быть;
- frontend показывает Failed to fetch;
- gateway возвращает 500/502/503;
- bootstrap не залил стартовый контент;
- короткая ссылка отдаёт 404;
- SEO или автопостинг не запускается.
[ТУТ СКРИНШОТ: административная страница логов с кнопкой создания архива]
Порядок действий
- Откройте административные настройки.
- Перейдите в раздел логов.
- Нажмите создание архива.
- Дождитесь завершения.
- Скачайте архив.
- Приложите архив к задаче вместе с точным URL страницы и временем ошибки.
Что приложить вместе с логами
- URL страницы;
- время ошибки с часовым поясом;
- текст ошибки из toast/console;
- скриншот Network request;
- что нажимали перед ошибкой;
- архив логов.
Что искать по Help/Documentation bootstrap
В cdp-bootstrap.log:
frontend_content_bootstrap_start | kind=documentation
frontend_content_bootstrap_start | kind=help
bootstrap_seed_result | file=DocumentationInstall.json success=true
В gateway.log:
POST /v1/documentation
PUT /v1/documentation/{uuid}
POST /v1/help
PUT /v1/help/{uuid}Важно. Если в gateway.log есть только GET /v1/help и GET /v1/documentation, это запросы frontend на чтение. Они не создают статьи.
Контрольный чек-лист
- Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
- Проверьте роль пользователя: часть кнопок видна только администратору.
- Откройте DevTools → Network и найдите запрос к
/v1/.... - Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
- Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.
Что приложить к задаче разработчику
Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.
[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]
