Система логирования
Отслеживайте все события на вашем сервере с помощью 55 типов событий, организованных в 18 категорий, маршрутизации по каналам для каждой категории и пользовательских цветов встраивания — все это настраивается из панели управления.
Topics: logs, logging, audit, events, tracking
Отслеживайте все события на вашем сервере с помощью 55 типов событий, организованных в 18 категорий, маршрутизации по каналам для каждой категории и пользовательских цветов встраивания — все это настраивается из панели управления.
Обзор
Система логирования фиксирует события сервера и отправляет подробные встраивания в выбранные вами каналы. Она является основой для ответственности модерации и общей видимости: кто присоединился, что было удалено, какие роли изменились, кто был забанен и многое другое.
Все настраивается из Панели управления → Логи. По умолчанию ничего не включено — вы решаете, какие категории отслеживать и куда каждую из них отправлять. Для быстрого включения всего в одном канале смотрите Команды логов.
Включение и базовая настройка
- Откройте Панель управления → Логи для вашего сервера.
- Переключите Активно в заголовке страницы, чтобы включить систему.
- Используйте выбор канала Все каналы логов в заголовке, чтобы отправить *каждую* категорию в один канал — самый быстрый способ начать.
- Или разверните любую категорию ниже, чтобы назначить ей собственный канал и включить его.
Совет: Netrcol требует Просмотр канала, Отправка сообщений, Встраивание ссылок и Чтение истории сообщений в каждом канале, в который вы ведете логи. Проверка состояния настройки на странице предупредит вас, если какая-либо разрешение отсутствует.
Каналы по категориям
Каждая категория представляет собой развертываемую строку с собственным выбором канала и переключателем включения/выключения. Это позволяет вам разделить ваши логи по каналам — например, логи модерации в закрытом канале для персонала и логи вступления/выхода в публичном канале.
Если каждая категория указывает на один и тот же канал, выбор канала Все каналы логов показывает этот канал; если они различаются, отображается *“Каналы различаются.”* Повторная настройка снова указывает все на один канал.
Цвета встраивания
Каждое событие имеет цветную полосу, которую вы можете настроить. Откройте категорию, и в каждой строке события будет цветовая палитра — удобно для быстрой идентификации категорий (например, красный для модерации, зеленый для вступлений).
Категории логов
Netrcol группирует свои 55 типов событий в 18 категорий:
| Категория | Что фиксируется |
|---|---|
| Бот | Логи взаимодействия с ботом и жизненного цикла гильдии |
| Модерация | Логи банов, разбанов, автоматической модерации и действий персонала |
| Сообщение | Логи удаления, редактирования и массового удаления сообщений |
| Реакция | Действия по добавлению и удалению эмодзи |
| Участник | Вступления, выходы, обновления ролей, изменения никнеймов и тайм-ауты |
| Канал | Логи создания, удаления, переименования, изменения темы и категории каналов |
| Роль | Логи создания, обновления и удаления ролей |
| Голос | Изменения состояния голоса (дебаг событий голоса требуют включения флага) |
| Приглашение | Логи создания и удаления приглашений |
| Сервер | Логи изменений настроек сервера, названия и структуры |
| Актив | Логи обновлений эмодзи и стикеров |
| Вебхук | События обновления вебхука |
| Безопасность | Логи рискованной активности и системы защиты |
| Интеграция | События обновления интеграции гильдии |
| Запланированное событие | Логи создания, обновления и удаления запланированных событий |
| Закрепленное сообщение | Логи обновлений закрепленных сообщений в канале |
| Присутствие | Логи набора текста и присутствия (по желанию, большой объем) |
| Пользователь | Изменения профиля пользователя, отображаемые один раз для каждой затронутой гильдии |
Умные заголовки
Некоторые категории используют более чистые и специфические заголовки вместо общего “Обновлено.” Например, выходы участников стараются разделить на вышел, выгнан и забанен; изменения в каналах с одним полем используют точный заголовок, такой как “Тема канала изменена” вместо “Канал обновлен.”
Обогащение с учетом аудита
Когда доступны журналы аудита сервера, логи Модерации и Участников обогащаются информацией об акторе и причине аудита — так, лог бана может показать *кто* его выдал и *почему*, а не просто то, что это произошло.
Быстрая настройка из чата
Если вы хотите, чтобы все было в одном канале, не открывая панель управления:
!logs-setup 123456789012345678Это включает все 18 категорий и направляет их в этот канал. Выключить всю систему можно с помощью:
!logs-disableПолные детали находятся на странице Команды логов.
Заметки и советы
- Ничего не включено по умолчанию. Вы выбираете, какие категории отслеживать — начните с малого и добавляйте больше по мере необходимости.
- Категории с высоким объемом. *Присутствие* (набор текста/присутствие) отключено по умолчанию и лучше оставить выключенным, если вы не отлаживаете; также требуется флаг окружения бота для передачи каких-либо данных.
- Дебаг событий голоса остаются без звука, если не включен глобальный флаг согласия в окружении бота.
- Дедуплицированные пользовательские логи. Одно изменение профиля группируется по гильдии, даже если несколько кэшированных сообщений соответствуют этому пользователю, так что вы не получите дублирующихся записей.
- Кэш сообщений. Чтобы показать удаленное/отредактированное содержимое, Netrcol хранит короткий кэш недавних сообщений в памяти для каждого сервера. Он никогда не записывается в постоянное хранилище — смотрите Политику конфиденциальности.
Следующие шаги
- Настройте это в Панели управления → Логи
- Ознакомьтесь с Командами логов
- Убедитесь, что у Netrcol есть правильные разрешения