Документация пользователя

Назад в ЛК
Полный сценарий: от входа в систему до проверки отчета. У каждого шага есть скриншот и комментарий.
Шаг 1. Вход в систему

Откройте страницу входа, укажите email и пароль, нажмите Login.

Зачем: без авторизации доступ к ЛК, датасетам, сессиям и отчетам закрыт.

Шаг 1: Вход в систему
Шаг 2. Раздел Датасеты

После входа перейдите в меню Датасеты. Это основной раздел управления выгрузками.

Что видно: список датасетов, кнопки запуска, статус последнего запуска.

Шаг 2: Раздел Датасеты
Шаг 3. Создание датасета

Нажмите Создать датасет, заполните название и тему, затем сохраните форму.

Совет: используйте понятное название, чтобы в отчетах не путать источники.

Шаг 3: Создание датасета
Шаг 4. Добавление шаблона выборки

На странице датасета в блоке Шаблоны выборки добавьте URL и тип (resume/vacancy).

Важно: URL должен быть именно с hh.ru.

Шаг 4: Добавление шаблона
Шаг 5. Настройка расписания запуска

В блоке Расписание выгрузки включите расписание и выберите частоту:

  • каждый день — только часы и минуты;
  • раз в неделю — часы, минуты и день недели;
  • раз в месяц — часы, минуты и число месяца.

Важно: запуск идет по часовому поясу пользователя в профиле.

Шаг 5: Настройка расписания
Шаг 6. Настройка уведомлений

В блоке Куда отправлять отчет включите email и/или webhook.

Когда приходят уведомления: старт выгрузки, завершение, завершение с ошибками, ошибка запуска.

Шаг 6: Настройка уведомлений
Шаг 7. Подключение HH сессии

Перейдите в Сессии, нажмите Start Browser, затем Connect Screen и выполните логин в HH.

Критерий успеха: после подтверждения статус сессии меняется и валидация проходит без ошибок.

Шаг 7: Подключение HH сессии
Шаг 8. Запуск датасета

Вернитесь в Датасеты и запустите выгрузку кнопкой Запустить у нужного датасета.

Альтернатива: используйте Запустить все активные датасеты для массового запуска.

Шаг 8: Запуск датасета
Шаг 9. Проверка статуса в Отчетах

Откройте раздел Отчеты. Для нового запуска статус обычно проходит цепочку created -> queued -> running -> done.

Если статус не меняется: проверьте раздел Процессы и логи.

Шаг 9: Статус в отчетах
Шаг 10. Просмотр деталей и логов

Откройте конкретный отчет: смотрите totals, диагностику пагинации и сигналы ошибок по каждому источнику.

Ключевая зона: блок Диагностика парсинга и ссылки на логи запуска.

Шаг 10: Детали отчета
Шаг 11. Экспорт результатов

На странице отчета используйте экспорт:

  • CSV — по выбранной выгрузке;
  • ZIP — архив по всем выгрузкам запуска.
Шаг 11: Экспорт результатов
Шаг 12. Профиль и часовой пояс

В разделе Профиль проверьте email и timezone. Эти данные влияют на уведомления и расписание.

Рекомендация: timezone должен соответствовать фактическому времени запуска у пользователя.

Шаг 12: Профиль и часовой пояс
Возможные ошибки и их интерпретация
Сообщение/сигнал Что означает Что делать
has_employer_access_required Вы вошли в HH, но нет доступа работодателя для полного просмотра резюме. Перелогиниться под аккаунтом работодателя и повторить Validate.
Selenium browser capacity is reached (active sessions: 2/2) Достигнут лимит одновременных внутренних браузеров. Закрыть лишние HH browser sessions или увеличить лимит на сервере.
Selenium browser is busy Selenium не выдал новую сессию в допустимое время. Подождать и повторить старт, проверить загрузку контейнера browser.
Failed to terminate Selenium session ... 404 Unable to find session Сессия уже завершилась/протухла раньше попытки закрытия. Считать закрытие завершенным, при необходимости сделать Restart Browser.
has_pager_limit HH показывает большой total, но фактически ограничивает доступные страницы выдачи. Оценивать результат по фактически собранным карточкам и сигналу в диагностике.
status=needs_relogin Куки HH недействительны или проверка перед запуском не пройдена. Открыть Сессии, заново пройти Start Browser -> логин -> Validate.
The stream or file .../storage/logs/laravel.log could not be opened ... Permission denied У PHP процесса нет прав на запись логов. Исправить владельца/права на storage и bootstrap/cache, перезапустить сервисы.
Connect Screen ничего не делает Часто нет активной browser-сессии или не работает WS-proxy/noVNC. Проверить Start Browser, контейнеры browser и novnc, затем Retry.
Если ошибка повторяется, приложите в тикет: номер run, trace_id (если есть), скриншот экрана и текст последней ошибки из логов.