Эксплуатация платформы

Эксплуатация платформы — четыре инструмента, которыми вы держите инсталляцию в рабочем состоянии: обзор с аналитикой использования, почтовый сервер для писем платформы, режим обслуживания и политики очистки старых данных. Обзор открывается сразу при входе в администрирование (/settings/administration/overview), остальные три страницы лежат в группе Платформа. Все четыре страницы видны только пользователям с глобальной ролью admin: остальные получают экран «Недостаточно прав». Модели, провайдеры и тарифы вы настраиваете в других разделах администрирования.

Что вам понадобится

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

Как читать сводку инсталляции

Обзор отвечает на вопрос «как инсталляцией пользуются». Страница называется Аналитика, открывается за последние 30 дней и считает показатели по значимым действиям: созданный чат, запуск ассистента, запуск действия, новая версия документа базы знаний, новый документ на холсте, транскрибация, вопрос к базе знаний, импорт.

Период задайте кнопкой выбора дат: Сегодня, Вчера, Последние 7 дней, Последние 30 дней, Последние 90 дней, Этот месяц, Прошлый месяц или произвольный интервал. Кнопка Сравнивать с прошлым периодом добавляет к каждому показателю изменение относительно предыдущего интервала той же длины. Рядом два фильтра — Рабочее пространство и Функция. Периоды длиннее 45 дней платформа рисует на графиках по неделям, короткие — по дням.

Восемь плиток вверху страницы показывают ключевые показатели периода. Нажмите на плитку — платформа откроет вкладку с детализацией.

Примечание. Показатели за последние трое суток платформа пересчитывает при открытии страницы, но не чаще одного раза в минуту, поэтому сегодняшние значения могут отставать.

Что показывают вкладки обзора

Семь вкладок страницы Аналитика раскрывают показатели по срезам. Каждая вкладка подчиняется общему периоду и фильтрам, заданным вверху страницы.

Сегмент пространства платформа считает по сравнению с предыдущим периодом.

Экспорт отдаёт CSV с содержимым текущей таблицы.

На вкладке AI-нагрузка переключатель На активное рабочее пространство делит все величины на число активных пространств: так видно среднюю нагрузку одного пространства, а не суммарную.

Как настроить отправку писем

Письма о регистрации, приглашениях и сбросе пароля платформа отправляет через один почтовый сервер, заданный на странице Администрирование → Платформа → SMTP (/settings/administration/platform/smtp). Пока сервер не настроен, письма не уходят, а операции, которые их требуют, завершаются ошибкой.

Заполните поля на вкладке Настройки и нажмите Сохранить. Кнопки сохранения появляются внизу формы после первого изменения.

Как проверить, дошло ли письмо

Нажмите Тестовое письмо рядом с заголовком Подключение, укажите Email получателя и нажмите Отправить. Тестовое письмо уходит через текущие сохранённые настройки, поэтому проверяйте подключение после сохранения формы.

Результат каждой отправки платформа пишет на вкладку Журнал уведомлений: колонки Дата, Тип, Получатель, Тема, Статус. Статус принимает значения Отправлено, В очереди и Ошибка. Нажмите на строку, чтобы открыть панель с текстом письма, ответом почтового сервера и сообщением об ошибке: это первое место, куда стоит смотреть по жалобе «письмо не пришло».

Как включить режим обслуживания немедленно

Режим обслуживания закрывает платформу для пользователей и показывает им страницу-заглушку. Откройте Администрирование → Платформа → Режим обслуживания (/settings/administration/platform/maintenance) и нажмите Экстренно включить. В окне подтверждения заполните текст для страницы-заглушки и нажмите Включить.

Пока режим активен, обычные запросы к платформе завершаются ошибкой MAINTENANCE_MODE, а пользователь видит заглушку. Вход в систему и раздел администрирования остаются доступными, поэтому вы продолжаете работать: после входа платформа сразу открывает страницу режима обслуживания. Внешние системы могут узнать состояние без авторизации запросом GET /api/maintenance/status.

Строка активного режима появляется в журнале внизу страницы со статусом Экстренный. Кнопка Редактировать меняет тексты, не выключая режим, кнопка Отключить возвращает платформу в работу.

Важно. Экстренное включение действует до ручного отключения: срок окончания задать нельзя.

Как запланировать окно обслуживания

Плановое окно предупреждает пользователей заранее и включает заглушку само. Откройте Администрирование → Платформа → Режим обслуживания, нажмите Запланировать и заполните форму.

1. Выберите Часовой пояс — в этом поясе платформа показывает и принимает все интервалы на странице.
2. Откройте Интервал обслуживания и выберите даты начала и окончания.
3. Укажите в подвале календаря время начала и время окончания.
4. Заполните Заголовок для пользователей, Время восстановления и Описание для страницы заглушки.
5. Нажмите Сохранить.

Запись появляется в журнале со статусом Запланирован. За сутки до начала платформа показывает пользователям предупреждение о предстоящих работах с вашим текстом. В момент начала статус меняется на Активный, платформа закрывается сама, а по окончании интервала открывается обратно.

Действия над записями журнала зависят от статуса.

Как настроить автоматическую очистку данных

Политики очистки удаляют устаревшие журналы, вложения и служебные записи, чтобы база данных и хранилища не росли бесконечно. Откройте Администрирование → Платформа → Политики очистки (/settings/administration/platform/cleanup-policies). Вкладка Политики содержит полный список ресурсов, сгруппированный по областям: LLM, Агент, ASR, Знания, Ассистенты и чаты, События, Логи, Аудит, Токены и сессии, Контент, Хранилище, Векторное хранилище (Qdrant), Служебное.

Большинство политик выключено по умолчанию: платформа не удаляет ничего, пока вы не включите конкретный ресурс. Плитки вверху страницы показывают, сколько политик включено и сколько требуют внимания — то есть завершились с ошибкой или включены, но ни разу не запускались.

Нажмите на строку — справа откроется панель ресурса.

Блок Попадает под очистку пересчитывает число записей по сохранённым настройкам, блок Последний прогон показывает статус, число удалённых записей и освобождённый объём. Кнопка Сохранить внизу панели применяет изменения.

Политики с пометкой «чувствительная» затрагивают конфиденциальные данные, поэтому при включении платформа спрашивает подтверждение. Отдельный флажок Чувствительные в фильтрах слева оставляет в таблице только их.

Как запустить очистку вручную

Нажмите Запустить вручную внизу панели ресурса. Платформа сначала считает объём и показывает окно «Запустить очистку сейчас?» с числом записей; удаление запускает кнопка Удалить.

Важно. ⚠️ Ручной прогон удаляет данные безвозвратно, отмены нет.

Кнопка неактивна, пока в панели есть несохранённые изменения: сначала сохраните срок хранения и размер батча, затем запускайте. Результат любого прогона — и ручного, и автоматического — попадает на вкладку Журнал очистки с колонками Политика, Дата/время, Статус, Тип запуска, Инициатор, Удалено, Освобождено. Статус Частично означает, что записей под очистку было больше, чем размер батча, и остаток уйдёт следующим прогоном.

Частые вопросы

Почему в обзоре нет данных за сегодня

Показатели за последние трое суток платформа пересчитывает при открытии страницы, но не чаще раза в минуту, а текущий день закрывается не полностью. Проверьте:

• выбранный период включает сегодняшнюю дату;
• фильтры Рабочее пространство и Функция не сузили выборку до пустой;
• в инсталляции вообще были значимые действия за период — на пустом стенде графики остаются пустыми.

Пользователи не получают письма

Настройки почтового сервера не сохранены или сервер отклоняет отправку. Проверьте:

• на вкладке Настройки заполнены SMTP хост, SMTP порт и Email отправителя;
• переключатели Использовать TLS и Использовать SSL согласованы с портом: 587 для TLS, 465 для SSL;
• тестовое письмо доходит до вашего адреса;
• в Журнале уведомлений у писем статус Отправлено, а не Ошибка — в панели строки виден ответ почтового сервера.

Пользователи видят заглушку, хотя работы закончились

Интервал обслуживания не завершён. Откройте страницу Режим обслуживания и посмотрите на статус рядом с заголовком: у экстренного режима окончания нет вовсе, а плановый интервал вы могли задать с запасом. Нажмите Отключить у активной строки журнала.

Политика очистки включена, но ничего не удаляет

Под критерий не попадает ни одной записи или прогон ещё не наступил. Проверьте:

• в панели ресурса блок Попадает под очистку показывает число больше нуля;
• срок хранения не выше, чем реальный возраст данных;
• в Журнале очистки нет статуса Ошибка у этой политики;
• при статусе Частично увеличьте Размер батча — остаток удаляется следующими прогонами.

Что дальше

• Раздел администрирования — карта всех разделов и групп меню.
• Центр активности — журналы запусков и отзывы, если нужна детализация глубже аналитики.
• Тарифы, кредиты и биллинг — откуда берутся списанные кредиты на вкладке «AI-нагрузка».
• Доступ, пользователи и пространства — настроить приглашения, ради которых нужен почтовый сервер.
• Распознавание документов и речи — подключить ASR, минуты которого видны в аналитике.