> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Логирование

> Записывайте 148 различных событий сервера в Discord-каналы или вебхуки, каждое со своим каналом и цветом.

Логирование отвечает на вопрос «что на самом деле произошло» задним числом. Vetox может писать **148 различных событий**, каждое настраивается независимо.

<Info>
  Логирование бесплатное. Три опции внутри — показ того, кто выполнил действие, публикация через вебхук и инструмент массовой настройки — требуют **Basic**.
</Info>

## Экран

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

<CardGroup cols={3}>
  <Card title="Server" icon="server" />

  <Card title="Moderation" icon="gavel" />

  <Card title="Messages" icon="message" />

  <Card title="Channels" icon="hashtag" />

  <Card title="Roles" icon="user-tag" />

  <Card title="Emote Zone" icon="face-smile" />

  <Card title="Voice" icon="microphone" />

  <Card title="Threads" icon="comments" />

  <Card title="Events" icon="calendar" />

  <Card title="AutoMod" icon="filter" />

  <Card title="Stage" icon="podium" />

  <Card title="Webhooks" icon="link" />

  <Card title="Integrations" icon="plug" />

  <Card title="Giveaways" icon="gift" />
</CardGroup>

<Warning>
  **У четырёх событий логов Battle Pass нет категории.** Tier unlocked, season started, season ended и quest completed существуют и работают, но добраться до них можно только через вкладку **All** — ни в одной категории их нет.

  У ряда других событий имя отображается без перевода.
</Warning>

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

Каждое событие **выключено по умолчанию** и имеет собственные настройки.

| Настройка             | По умолчанию       | Заметки                                                           |
| --------------------- | ------------------ | ----------------------------------------------------------------- |
| **Enabled**           | Выкл               |                                                                   |
| **Destination**       | Channel            | Переключатель между каналом и вебхуком                            |
| **Log Channel**       | Нет                | Куда публикуется запись                                           |
| **Webhook URL**       | Нет                | Должен быть URL вебхука Discord. **Basic-тариф**                  |
| **Log Color**         | Синий по умолчанию | Любой hex-цвет                                                    |
| **Disabled Channels** | Нет                | Исключить конкретные каналы. **Только у девяти событий Messages** |
| **Show Executor**     | Выкл               | Включать, кто выполнил действие. **Basic-тариф**                  |

<Warning>
  **Канал и вебхук взаимоисключающи.** Установка одного очищает другое. Одно и то же событие нельзя отправлять в оба.
</Warning>

<Warning>
  На Starter **Show Executor** и **Webhook URL** **молча сбрасываются при сохранении** — ни ошибки, ни предупреждения, значение просто откатывается.

  Если эти два настройки не «прилипают», вот почему. Всё остальное на событии сохраняется нормально.
</Warning>

<Note>
  Исключение **Disabled Channels** есть только у событий сообщений. Для голосовых, ролевых или модерационных событий per-channel исключений нет.
</Note>

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

Настраивать 148 событий по одному непрактично, поэтому **Manage Logs** создаёт каналы и связывает события массово. Требует **Basic**.

| Режим                   | Результат                                   |
| ----------------------- | ------------------------------------------- |
| **Individual Channels** | Отдельный канал на событие                  |
| **Category**            | По каналу на категорию, под категорией Logs |

Вы также выбираете, какие роли могут видеть созданные каналы, и какие каналы исключить. Созданные каналы отказывают `@everyone` и дают доступ только выбранным ролям.

Диалог отчитывается о прогрессе: создание каналов, привязка логов, установка разрешений и применение исключений.

<Tip>
  **Режим Category — почти всегда правильный выбор.** Individual при широкой выборке создаёт огромное количество каналов — до 148.
</Tip>

## Сохранение

Отправляются только реально изменённые события, поэтому сохранение одного переключателя не переписывает всю конфигурацию.

<Note>
  [Dashboard Watcher](/ru/server-management/dashboard-watcher) для логирования записывает **только действия включения и выключения**. Смена канала, вебхука или цвета сохраняется корректно, но не оставляет audit-записи.
</Note>

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

<AccordionGroup>
  <Accordion title="Начните с событий модерации и сервера" icon="star">
    К ним вы реально будете возвращаться и читать.
  </Accordion>

  <Accordion title="События сообщений — высокого объёма" icon="triangle-exclamation">
    Логи правок и удалений на большом активном сервере производят огромный поток. Используйте disabled-channels, чтобы исключить самые оживлённые каналы — это единственная категория, где можно.
  </Accordion>

  <Accordion title="Голосовые события шумнее, чем кажутся" icon="volume-high">
    Входы и выходы участников в голос создают постоянные записи. Логируйте только если специально нужно.
  </Accordion>

  <Accordion title="Вебхуки переживают смены каналов" icon="link">
    Вебхук как назначение продолжает работать при переименовании или переносе канала и публикует без права send-permission у бота. Требует Basic.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Ничего не логируется">
    Убедитесь, что Логирование включено в [Настройке сервера](/ru/server-management/setup), затем что конкретное событие включено и у него задано назначение.
  </Accordion>

  <Accordion title="Show Executor всё время сам выключается">
    Он требует Basic и молча сбрасывается ниже этого тарифа.
  </Accordion>

  <Accordion title="Задал вебхук, а вернулось к каналу">
    Та же причина — вебхук-назначения требуют Basic.
  </Accordion>

  <Accordion title="Не могу найти события логов Battle Pass">
    У них нет вкладки-категории. Используйте вкладку All и поиск.
  </Accordion>

  <Accordion title="У события пустое или странное имя">
    Небольшое число событий идёт без отображаемого имени. Само событие работает нормально.
  </Accordion>
</AccordionGroup>

## Связанное

<CardGroup cols={2}>
  <Card title="Dashboard Watcher" icon="desktop" href="/ru/server-management/dashboard-watcher">
    Отслеживает изменения, сделанные в панели, а не в Discord.
  </Card>

  <Card title="Moderation Tools" icon="gavel" href="/ru/moderation/moderation-tools">
    Просмотр и снятие текущих действующих наказаний.
  </Card>
</CardGroup>