Логирование

Настройка модуля логирования событий.

Введение

Этот модуль поможет вам следить за большинством событий на сервере, например: бан, удаление роли, создание канала и изменение сообщения.

Настройка

Вручную настраивать этот модуль будет долго и нудно. Поэтому была сделана функция автонастройки. Она включит модуль и создаст на вашем сервере приватную категорию "Логи" (она и каналы в ней будут видны лишь участникам с правами администратора) и каналы в ней, которые будут привязаны к соответствующим событиям. Например, в канале "Наказания" будут отправляться логи про баны, разбаны, муты и размуты. Чтобы выполнить автонастройку, напишите a.logs autosetup. После этого модуль будет полностью готов к работе.

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

Вручную

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

Включение

Перед ручной настройкой модуля нужно сначала его включить. Чтобы это сделать, нужно написать a.logs toggle.

Привязка событий

Привязка событий означает, что логирование этого события будет отправлять сообщения в привязанный вами канал. Чтобы привязать событие или категорию событий к определённому каналу, вам нужно написать команду a.logs bind <событие или категория событий> <#канал>. Список событий по категориям находится здесь.

Пример: a.logs bind guild #сервер

Включение и выключение событий

После привязки события его логирование нужно включить. Делается это командой a.logs toggle <событие>. Выключается событие этой же командой.

Пример: a.logs toggle banUser

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

Включение и выключение категорий

Если вам нужно включить логирование сразу целой категории событий, делается это командой a.logs enable <категория событий>.

Выключается же логирование категории событий командой a.logs disable <категория событий>.

Примеры:

• a.logs disable members
• a.logs enable members

Список событий

Ниже вы увидите список событий по категориям. Также его можно посмотреть у бота командой a.logs events (будет отображена подробная информация о том, включено ли логирование события и к какому каналу оно привязано).

punishments

Событие	Когда вызывается
banUser	При бане пользователя
unbanUser	При разбане пользователя
muteUser	При мьюте пользователя
unmuteUser	При размьюте пользователя

members

Событие	Когда вызывается
memberUpdateNickname	При изменении никнейма пользователя на сервере
memberAdd	При входе пользователя на сервер
memberRemove	При выходе пользователя с сервера
memberUpdateRoles	При обновлении списка ролей пользователя

roles

Событие	Когда вызывается
roleCreate	При создании роли
roleRemove	При удалении роли
roleChangeName	При изменении названия роли
roleChangeColor	При изменении цвета роли

guild

Событие	Когда вызывается
guildChangeName	При изменении названия сервера
guildUpdateOwner	При передаче прав владельца сервера
guildInviteCreate	При создании приглашения
guildInviteRemove	При удалении приглашения

channels

Событие	Когда вызывается
channelCreate	При создании канала
channelRemove	При удалении канала
channelChangeName	При изменении названия канала
channelChangeTopic	При изменении описания канала

messages

Событие	Когда вызывается
messageRemove	При удалении сообщения
messageEdit	При изменении сообщения

После настройки

Вы можете посмотреть, включён ли модуль командой a.logs status.

Также можно посмотреть подробную информацию про то, включено ли событие и к какому каналу оно привязано командой a.logs events.

Если нужно стереть все настройки модуля, делается это командой a.logs reset.