Как настроить журнал событий в ClickHouse
Хранилище журнала событий в ClickHouse позволяет вести лог действий пользователей во внешней базе данных ClickHouse — удобно для длительного хранения, аналитики и высоких нагрузок. Инструкция предназначена для администраторов платформы.
Предварительные условия
- Наличие прав администратора платформы.
- Развёрнутый сервер ClickHouse с созданной базой данных и учётной записью.
- Параметры подключения: адрес сервера, порт, имя базы данных, пользователь и пароль.
Основные шаги
- Войдите как администратор и перейдите в Администрирование → Плагины → Журналы → Управление хранилищами журнала.
- Включите хранилище Журнал событий в БД Clickhouse (значок «глаза»).
- Нажмите Настройки.
- В разделе Настройки базы данных укажите параметры подключения к ClickHouse: адрес сервера, порт, имя базы данных, пользователя и пароль.
- Сохраните настройки.
- Убедитесь, что в списке хранилищ журнала новое хранилище активно, и выполните тестовое действие в системе.
После настройки события будут записываться в ClickHouse и доступны для аналитических запросов.
💡 Совет: ClickHouse хорошо подходит для длительного хранения и быстрых аналитических выборок по журналу — используйте его, если стандартного журнала не хватает по объёму или скорости.
Важно: если подключение не настроено или сервер недоступен, запись событий не будет работать — проверьте доступность сервера и корректность параметров.
Частые вопросы
- Проблема: Ошибка подключения к ClickHouse. Решение: Проверьте адрес, порт, имя базы данных и учётные данные; убедитесь, что сервер доступен из сети, где работает YooLearn.
- Проблема: События не записываются. Решение: Проверьте статус хранилища в управлении журналами и настройки подключения; после исправления сохраните настройки повторно.
- Проблема: Нужно вернуться к стандартному журналу. Решение: Отключите хранилище ClickHouse в управлении хранилищами журнала — запись вернётся в стандартное хранилище.