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

Экран

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

Сервер

Модерирование

Сообщения

Каналы

Роли

Зона эмодзи

Голос

Темы

События

AutoMod

Трибуна

Вебхуки

Интеграции

Giveaways

Игры

Battle Pass

Настройка события

Каждое событие выключено по умолчанию и имеет собственные настройки.
Канал и вебхук взаимоисключающи. Установка одного очищает другое. Одно и то же событие нельзя отправлять в оба.
На Starter Webhook URL молча сбрасывается при сохранении — ни ошибки, ни предупреждения, значение просто откатывается.Если эта настройка не «прилипает», вот почему. Всё остальное на событии сохраняется нормально.
Исключение Disabled Channels есть только у событий сообщений. Для голосовых, ролевых или модерационных событий per-channel исключений нет.

Показать исполнителя

«Показать исполнителя» добавляет в запись того, кто выполнил действие: модератора, который забанил, админа, который переименовал канал. 111 из 154 событий поддерживают эту опцию. У остальных нет единого исполнителя — например, когда участник присоединяется к серверу или запланированное событие начинается по расписанию. Опция сама подстраивается под ваш тариф:
Vetox берёт исполнителя из журнала аудита Discord, поэтому боту нужно право Просматривать журнал аудита. Без него запись всё равно публикуется, но без имени.
Когда модератор действует через команду Vetox — ban, kick, timeout, mute и подобные, — запись называет этого модератора, а не бота. Во всём остальном, что Vetox делает от чьего-то имени, например в AI Server Control или тикетах, запись показывает Vetox вместе с причиной, в которой указано, кто об этом попросил.

Что нужно боту

Когда включено только общее событие

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

Настройка множества событий сразу

Настраивать 154 события по одному непрактично, поэтому Manage Logs создаёт каналы и связывает события массово. Требует Basic. Вы также выбираете, какие роли могут видеть созданные каналы, и какие каналы исключить. Созданные каналы отказывают @everyone и дают доступ только выбранным ролям. Диалог отчитывается о прогрессе: создание каналов, привязка логов, установка разрешений и применение исключений.
Режим Category — почти всегда правильный выбор. Individual при широкой выборке создаёт огромное количество каналов — до 154.

Сохранение

Отправляются только реально изменённые события, поэтому сохранение одного переключателя не переписывает всю конфигурацию.
Dashboard Watcher записывает включение и выключение события, а также переключение «Показать исполнителя». Смена канала, вебхука или цвета сохраняется корректно, но не оставляет audit-записи.

Что стоит логировать

К ним вы реально будете возвращаться и читать.
Логи правок и удалений на большом активном сервере производят огромный поток. Используйте disabled-channels, чтобы исключить самые оживлённые каналы — это единственная категория, где можно.
Входы и выходы участников в голос создают постоянные записи. Логируйте только если специально нужно.
Правило Discord AutoMod может одновременно заблокировать сообщение, отправить оповещение и дать участнику timeout. Vetox записывает это одной записью, в которой перечислены все выполненные действия.
Вебхук как назначение продолжает работать при переименовании или переносе канала и публикует без права send-permission у бота. Требует Basic.

Решение проблем

Убедитесь, что Логирование включено в Настройке сервера, затем что конкретное событие включено и у него задано назначение.
Требуется Basic. Ниже этого тарифа опция показана как выключенная и возвращается сама, когда сервер оформляет подписку.
Проверьте, что «Показать исполнителя» включено для этого события и что у бота есть право Просматривать журнал аудита. У некоторых действий назвать некого: участник сам вышел из голосового канала или ветка ушла в архив после неактивности.
Боту не хватает права. Событиям вебхуков и интеграций нужно право Просматривать журнал аудита; событиям AutoMod — Управлять сервером.
Вебхук-назначения требуют Basic.

Связанное

Dashboard Watcher

Отслеживает изменения, сделанные в панели, а не в Discord.

Moderation Tools

Просмотр и снятие текущих действующих наказаний.