Логи

Зачем это нужно

Сообщение удалено, но никто уже не помнит, что в нём было. Канала нет. Роль называется не так, как вчера. Журнал аудита Discord помогает лишь отчасти: содержимого сообщений там не бывает, да и заглядывает туда почти никто. Собственный журнал событий записывает всё это в момент, когда оно происходит, и складывает в каналы, которые вы выбираете сами. После этого вопрос «кто это сделал и когда?» перестаёт быть реконструкцией и становится взглядом в канал.

Как это выглядит в жизни

Ты решаешь по каждому событию, записывать ли его и куда. Заходы могут идти в один канал, удалённые и изменённые сообщения попадать во второй, а изменения ролей и каналов в третий. Запись о заходе называет участника, его идентификатор и возраст его учётной записи Discord; у удалённого сообщения указаны автор, канал и текст; у изменённого указана версия до и после. Переименованные роли и каналы выглядят как старое имя, стрелка, новое имя, а голосовые каналы отдельно фиксируют подключение, отключение и переход. Как выглядит запись, тоже выбирается по событию: отрисованная карточка, простой embed или оба сразу. Карточка относится к Premium-возможностям, без Premium отправляется embed.

На что обратить внимание

Первый вопрос в том, кто вправе читать каналы журнала. Публичный журнал удалённых сообщений снова показывает ровно то, что кто-то только что убрал: ссоры, личные подробности и всё, что было написано сгоряча. Поэтому оставь такие каналы только для команды, а чувствительные разделы полностью вынеси через список исключений, например признания или заявки. Вторая ловушка кроется в списке допущенных ролей: это фильтр, а не дополнение. Стоит что-то туда вписать, и все участники без этих ролей исчезают из журнала целиком; обычно имелось в виду обратное, так что в сомнении оставляй его пустым. Учитывай также, что удалённые сообщения попадают в журнал дословно лишь тогда, когда бот видел их раньше; написанное до его последнего запуска он дослать не может и прямо пишет об этом в записи. И не включай всё сразу: канал, в котором стоит каждая мелочь, читают так же редко, как и никакой.

Настройка в три шага

1. Включи модуль «Logs» в панели.
2. Для каждого события поставь переключатель и укажи канал назначения, ведь без канала даже включённое событие молчит.
3. Настрой права каналов журнала так, чтобы их видела только команда, а бот мог в них писать.
4. Каналы, которые не должны попадать в журнал, впиши в список исключений.

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

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

Нет. При удалении и правке журнал пропускает сообщения ботов, иначе каждая панель и каждое объявление затопили бы канал. Сообщений людей это не касается.

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

Да, через список исключений. События из указанных там каналов пропускаются; это работает везде, где известен канал происхождения, то есть у сообщений и в голосовой части. У общесерверных действий вроде создания роли такого канала нет, и они записываются дальше.

Действительно ли текст удалённых сообщений попадает в журнал?

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

Записываются ли сообщения ботов?

Нет. При удалении и правке журнал пропускает сообщения ботов, иначе каждая панель и каждое объявление затопили бы канал. Сообщений людей это не касается.

Почему изменения роли нет в журнале?

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

Можно ли исключить отдельные каналы из журнала?

Да, через список исключений. События из указанных там каналов пропускаются; это работает везде, где известен канал происхождения, то есть у сообщений и в голосовой части. У общесерверных действий вроде создания роли такого канала нет, и они записываются дальше.