Fjord

Документация Fjord

Модули

03

Журнал активности

Записывайте важные события в выбранных каналах Discord.

Включённые функции

  • 89 поддерживаемых типов событий
  • Один общий канал журнала
  • Отдельно включаемые записи

Что умеет журнал активности?

Журнал активности записывает выбранные события на сервере. Выберите из 89 типов событий и укажите канал Discord для записей. Так можно просматривать изменения сообщений и действия модерации.

Настроить журнал активности

Включайте и выключайте журнал активности переключателем журналирования независимо от того, выбран ли канал. При выключении выбранный канал сохраняется. Выбор «Нет канала» автоматически выключает переключатель.

Журнал активности фиксирует выбранные события на сервере и публикует их все вместе в назначенном текстовом канале Discord.

Необходимые права в Discord

Просмотр канала Управление вебхуками Показать журнал аудита

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

Ведение журналаНеобязательно

Включает или выключает весь журнал действий. Без активации выбранные события не будут выводиться.

Канал протоколаОбязательно при активации

Определяет текстовый канал, в котором публикуются записи. Канал должен быть доступен и доступен для записи для Fjord.

СобытияПо крайней мере одно обязательное

Каждый тип события можно активировать индивидуально. Если ведение журнала включено, необходимо выбрать хотя бы одно событие.

Включить ботовНеобязательно

Определяет, регистрируются ли также действия других ботов.

  1. Откройте нужный сервер на панели управления, а затем Журнал активности.
  2. Включить ведение журнала.
  3. Выберите канал протокола.
  4. Активируйте хотя бы одно из доступных событий.
  5. При необходимости определите, включены ли действия других ботов.
  6. Сохраните конфигурацию.

Доставка через вебхук

Журнал активности публикует записи через вебхук, а не как обычные сообщения бота. Для этого Fjord нужно право Управлять вебхуками в канале журнала.

ПубликацияАвтоматически

Обнаруженные действия собираются и затем публикуются через веб-перехватчик в выбранном канале.

Интервал сбора данныхПриблизительно 2 минуты

Новые записи не обязательно появляются сразу. Fjord публикует собранные журналы примерно каждые две минуты.

Задержка до двух минут является нормальной и не означает, что журнал активности не работает.

Выбрать события

Доступно 89 индивидуально активируемых типов событий. Поле поиска ищет их имена и описания. Ненужные события можно исключить, чтобы канал журнала содержал только соответствующие операции.

КатегорияЗаписанные операции
СообщенияРедактирование, одиночное и многократное удаление, закрепление, реакции и удаление ссылок или вложений.
Каналы и разрешенияСоздание, редактирование и удаление каналов, а также изменение разрешений каналов.
ТемыСоздание, редактирование и удаление тем.
Роли и праваРоли, разрешения ролей, роли участников и изменения порядка ролей.
УчастникиПрисоединиться, выйти, исключить, заблокировать, разблокировать, профиль, псевдоним и время ожидания.
Голос и сценаПрисоединение, выход, перемещение, отключение, отключение или включение звука, трансляция, камера и каналы сцены.
Серверы и повышенияПрофиль сервера, безопасность, настройки сообщества, передача права собственности и статус повышения.
ПриглашенияСоздание, редактирование и удаление приглашений.
Приложения и автоматизацияБоты, интеграция, разрешения для команд приложений и веб-перехватчики.
Эмодзи, наклейки и звукиСоздавайте, редактируйте и удаляйте смайлы, наклейки и звуки деки.
Мероприятия и сообществоМероприятия на сервере, вопросы по адаптации, обучение и руководство по серверу.
Автомодерация и модерацияОчистка участников, правила и обращения автомодератора, карантин, тайм-ауты, предупреждения и неназначенные действия аудита.
МонетизацияПоддерживаемые запросы на монетизацию и принятые условия.

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

Включить действия бота

Если параметр Включить ботов отключен, действия других ботов не будут регистрироваться. Это предотвращает ненужное заполнение канала журнала автоматическими процессами.

Если настройка активирована, также могут отображаться изменения, внесенные модерацией, ролевыми или интеграционными ботами. Выбранные события продолжают определять, какие типы действий выполняются.

Доступность предыдущего контента

Для отредактированных или удаленных сообщений журнал активности пытается показать предыдущий и новый статус. Однако предыдущий контент не всегда доступен.

Если предыдущий контент отсутствует, Fjord помечает его в журнале как недоступный. Вся оставшаяся информация все равно будет выведена. Например, при редактировании новый контент может появиться, даже если предыдущий контент отсутствует.

Незавершенное состояние до/после не означает, что журнал активности не работает. По соображениям защиты данных содержимое сообщений не хранится бесконечно.

Исправить ошибки

НаблюдениеОбследование
Событие появляется не сразу.Подождите примерно две минуты. Записи собираются перед публикацией.
Ничего не появляется даже после интервала сбора данных.Проверьте, активировано ли ведение журнала и соответствующий тип событий, и сохранена ли конфигурация.
Канал протокола не может быть выбран.Проверьте, может ли Fjord видеть канал и писать туда. Также обратите внимание на переопределение разрешений, связанных с каналом.
Вебхук отсутствует или ничего не публикует.Проверьте разрешение Управление вебхуками в канале журнала. Затем снова выберите канал и сохраните.
Действия ботов отсутствуют.Активируйте Включить ботов и проверьте, включен ли соответствующий тип событий.
Канал содержит слишком много записей.Отключите ненужные события или исключите действия других ботов.
Содержимое предыдущего сообщения отсутствует.Информация не может быть предоставлена и поэтому помечена как недоступная. Это не дефект.
Сохраненный канал больше не доступен.Выберите существующий текстовый канал, доступный для Fjord, и сохраните его еще раз.