Логирование Бесплатно

Журнал в выбранных вами каналах: удалённые и изменённые сообщения, входы и выходы, смена никнеймов и ролей, новые имена и аватары, баны и тайм-ауты от кого угодно, изменения каналов, ролей, эмодзи, стикеров и самого сервера — каждое с указанием, кто это сделал, — и активность в голосовых каналах.

Setting it up

1. Создайте приватные каналы для своей команды — один для всего или по одному на каждый тип событий.
2. Начните с общего лога: туда попадает всё, у чего нет своего канала.
3. Выделяйте типу событий собственный канал, когда хотите держать его отдельно: сообщения, входы и выходы, участники, роли, модерация, голосовые каналы, приглашения, изменения сервера и то, что сделал собственный AutoMod Discord.

Настройки

Всё, что можно настроить для этого модуля в панели управления, в том порядке, в каком это показывает страница.

Полезно знать

• Кто это сделал, берётся из журнала аудита Discord, поэтому Pangobot нужно для этого право Просматривать журнал аудита. Каналы, роли, сам сервер, его эмодзи и стикеры, удалённые сообщения, массовые очистки и никнеймы — всё это называет того, кто это сделал, с причиной, если она указана. Каждая такая запись ждёт записи аудита около секунды, потому что Discord иногда присылает её сразу после самого изменения. Без этого права запись всё равно появляется — там, где было бы имя, сказано, что у Pangobot нет права Просматривать журнал аудита, а не пустое место, которое читается как ответ.
• Удалённое сообщение — единственное, о чём Discord молчит: он ничего не записывает, когда человек удаляет собственное сообщение, поэтому запись без имени указывает на автора как на вероятного удалившего, а не делает вид, что никто не знает. Когда модератор удаляет несколько сообщений одного участника в одном канале, Discord делает одну запись на все — первое названо прямо, у остальных стоит most likely (скорее всего), потому что их мог удалить и сам автор.
• Эмодзи и стикеры, которые добавили, переименовали или удалили, попадают в лог сервера — с картинкой и с указанием, кто это сделал.
• Роль, которой управляет Discord, — собственная роль бота, роль бустеров, роль интеграции — никогда не удаляется вручную: она исчезает, когда исчезает то, чему она принадлежит. Запись указывает, что именно, поэтому роль, пропавшая из-за удаления бота, не выглядит так, будто кто-то что-то удаляет.
• Изменения прав перечисляются по одному: какая роль или участник, какое право и каким оно было раньше («View Channel (allowed to denied)»). Учитывается и изменение внутри существующего переопределения, а не только добавление или удаление целого. Переопределение, исчезнувшее вместе со своей ролью, тоже это указывает. Перечисляется не больше двенадцати, затем — их число.
• Кем кто-то был раньше — его прежний никнейм, роли, которые были у него при уходе, — известно, только если Pangobot видел его с момента последнего запуска. При запуске он загружает список участников каждого сервера с логом участников, поэтому первое изменение после перезапуска уже полное. Серверы с более чем 25 000 участников пропускаются: держать в памяти столько участников, чтобы назвать роли изредка уходящих, обходится дороже, чем стоит запись, и там лог участников заполняется по мере того, как люди появляются. Где лог участников не задан, списки участников не хранятся вовсе.
• Как выглядит запись: заголовок, затем факты короткими строками (пользователь, канал, причина...), справа — аватар участника, а если действие кто-то совершил — этот человек в подвале. Имена показываются обычным текстом: никнейм или название канала не могут превратиться в ссылку или пинг.
• Изменённые сообщения показывают «Before» (до) и «After» (после), где изменения подчёркнуты: удалённые или добавленные слова или только буквы, если исправили одно слово. Текст показывается так, как его набрали, — символы форматирования видны как символы, поэтому сообщение не может подделать выделение или спрятать ссылку. Ссылки, свои эмодзи и упоминания остаются как есть; изменённая ссылка не подчёркивается (Discord принял бы отметку за часть адреса).
• Вид записей лога: Классический помещает до десяти записей в одно сообщение; запись, которая одна в своём сообщении (изменённое сообщение), получает кнопку Jump to message (перейти к сообщению). Карточки показывают каждую запись отдельным блоком с её кнопками — Jump to message и Get user ID, которая присылает ID лично вам, чтобы его можно было скопировать, — но в одно сообщение помещается меньше записей. Стиль применяется ко всем каналам логов сервера, в том числе к каналам других модулей. Живые логи в панели управления сохраняют собственный вид.
• Новые имена и аватары (те, что участники задают для всего Discord, а не никнейм на сервере) попадают в лог участников вместе с тем, какими они были раньше. После перезапуска Pangobot один раз читает список участников серверов с логом участников, чтобы знать предыдущее имя.
• User left сообщает, был ли участник забанен или выгнан и кем (нужно право Просматривать журнал аудита).
• Тип событий без своего канала переходит в запасной: входы и роли — в лог участников, приглашения и изменения ролей — в лог сервера, а всё остальное — в общий лог. Без общего лога тип событий без своего канала просто не логируется.
• Лог ролей называет, кто выдал или снял роль, и причину, если её указали, — из журнала аудита, поэтому нужно право Просматривать журнал аудита.
• Лог AutoMod Discord показывает, что заблокировали или пометили правила в разделе Настройки сервера > AutoMod. Discord сообщает об этом только ботам с правом Управлять сервером. У собственного AutoMod Pangobot канал логов задаётся в его настройках; так же устроены Тикеты, Контроль входа и Трекер приглашений (кто по какому приглашению зашёл).
• Лог модерации показывает и действия, совершённые без Pangobot, — из журнала аудита, для этого нужно право Просматривать журнал аудита.
• Сообщения ботов по умолчанию игнорируются; можно исключать каналы и целые категории. Убрать канал из списка игнорируемых может только тот, кто его видит, — для категории это касается всех каналов в ней.
• То, что цитирует канал логов, зависит от того, кто его выбрал. Текст сообщений, срабатывания AutoMod Discord, а также названия и темы каналов цитируются в канале логов, только если участник, выбравший этот канал в панели управления, видит канал, откуда они пришли, — то же касается участника, очистившего более конкретный канал логов, чтобы записи переходили в этот. Иначе строка всё равно сообщает, что произошло, кто это сделал и где, с пометкой Not quoted here. Каналы, выбранные владельцем сервера, цитируют всё. Если участник, выбравший канал логов, уходит с сервера, этот канал перестаёт цитировать, пока его кто-нибудь не выберет снова.
• Живые логи панели управления показывают те же события в реальном времени — запись целиком, но только тем, кто видит канал, откуда она пришла (для приватной ветки нужно Управлять ветками; записи удалённого канала остаются видны только тем, кто мог его видеть). Срабатывания AutoMod Discord появляются под фильтром AutoMod.
• Строки логов группируются в как можно меньшее число сообщений, которое позволяет Discord (до 10 записей и 6000 символов в сообщении); длинные записи распределяются по нескольким сообщениям, так что ничего не теряется. Если Discord отклоняет отдельную запись, Pangobot пропускает только её и сообщает об этом в списке проблем — в живых логах она всё равно есть.
• Файлы удалённого сообщения перечисляются по имени, и каждое имя — ссылка на копию, которая хранится у самого Discord. Если среди них есть картинка, лог её показывает. Через какое-то время Discord убирает файлы удалённого сообщения, поэтому ссылка и картинка работают, пока они есть у Discord, — Pangobot копий не хранит. Показывать в логе картинку удалённого сообщения выключает предпросмотр и оставляет имена и ссылки. Имя файла показывается обычным текстом, поэтому не может само стать ссылкой.
• Массовые удаления (чистка, бан с удалением сообщений, очистка канала другим ботом) сопровождаются транскриптом: текстовым файлом со всеми удалёнными сообщениями, которые Pangobot ещё держал в памяти, от старых к новым, с автором, временем, текстом и ссылками на файлы. Сообщения старше примерно двух часов или отправленные до перезапуска перечисляются только по ID. Сообщения ботов не включаются, пока сообщения ботов игнорируются. Транскрипт попадает только в канал логов, который выбрал человек, видящий очищенный канал, и Pangobot нужно там право Прикреплять файлы, если только он не публикует через свой вебхук.
• Логи публикуются в Discord, Pangobot их не хранит. Удалённые сообщения показываются из того, что бот ещё держал в памяти.

What the bot needs

• Просматривать журнал аудита; в каналах логов — Отправлять сообщения и Встраивать ссылки.