> ## 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 频道或 Webhook，每个都有自己的频道和颜色。

日志在事后回答"实际发生了什么"。Vetox 可以记录 **148 个独立事件**，每个都可独立配置。

<Info>
  日志免费。其中三个选项——显示谁执行了动作、通过 Webhook 发布，以及批量设置工具——需要 **Basic**。
</Info>

## 屏幕

一个标签栏带 **全部** 加十四个类别，每个都显示启用了多少事件。每个标签页都有搜索框和已启用事件的运行计数。

<CardGroup cols={3}>
  <Card title="服务器" icon="server" />

  <Card title="审核" icon="gavel" />

  <Card title="消息" icon="message" />

  <Card title="频道" icon="hashtag" />

  <Card title="角色" icon="user-tag" />

  <Card title="表情区" icon="face-smile" />

  <Card title="语音" icon="microphone" />

  <Card title="线程" icon="comments" />

  <Card title="活动" icon="calendar" />

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

  <Card title="舞台" icon="podium" />

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

  <Card title="集成" icon="plug" />

  <Card title="抽奖" icon="gift" />
</CardGroup>

<Warning>
  **四个战斗通行证日志事件没有类别。** 等级解锁、赛季开始、赛季结束和任务完成存在且工作，但只能通过 **全部** 标签页到达——没有类别标签页包含它们。

  少数其他事件也在没有翻译名称的情况下显示。
</Warning>

## 配置事件

每个事件 **默认关闭**，各有自己的设置。

| 设置              | 默认   | 说明                                   |
| --------------- | ---- | ------------------------------------ |
| **启用**          | 关    |                                      |
| **目的地**         | 频道   | 在频道和 Webhook 之间切换                    |
| **日志频道**        | 无    | 条目发布之处                               |
| **Webhook URL** | 无    | 必须是 Discord Webhook URL。**Basic 等级** |
| **日志颜色**        | 默认蓝色 | 任何十六进制颜色                             |
| **禁用频道**        | 无    | 排除特定频道。**仅在九个消息事件上**                 |
| **显示执行者**       | 关    | 包括谁执行了动作。**Basic 等级**                |

<Warning>
  **频道和 Webhook 互斥。** 设置一个会清除另一个。你不能将同一事件发送到两者。
</Warning>

<Warning>
  在 Starter 上，**显示执行者** 和 **Webhook URL** 在你保存时 **被静悄悄地重置** ——没有错误，没有警告，值就是回退了。

  若这两个设置不能保留，那就是原因。事件上的其他所有内容正常保存。
</Warning>

<Note>
  **禁用频道** 排除仅存在于消息事件上。语音、角色或审核事件没有每频道排除。
</Note>

## 一次设置许多事件

单独配置 148 个事件不切实际，因此 **管理日志** 批量创建频道并连接事件。需要 **Basic**。

| 模式       | 结果               |
| -------- | ---------------- |
| **单独频道** | 每个事件一个独立频道       |
| **类别**   | 每个类别一个频道，位于日志分类下 |

你还可以选择哪些角色可以查看创建的频道，以及排除哪些频道。创建的频道拒绝 `@everyone` 并只授予你指定的角色。

对话框报告创建频道、分配日志、设置权限和应用例外的进度。

<Tip>
  **类别模式几乎总是正确的选择。** 单独模式在广泛选择下会创建极大量的频道——最多 148 个。
</Tip>

## 保存

只发送你实际更改的事件，因此保存单个切换不会重写你的整个配置。

<Note>
  [仪表板监视器](/zh-CN/server-management/dashboard-watcher) 只记录 **启用和禁用动作**。更改频道、Webhook 或颜色被正确保存但不留下审计条目。
</Note>

## 选择记录什么

<AccordionGroup>
  <Accordion title="从审核和服务器事件开始" icon="star">
    这些是你会真正回去阅读的。
  </Accordion>

  <Accordion title="消息事件量大" icon="triangle-exclamation">
    在大型活跃服务器上，编辑和删除日志会产生大量条目。请使用禁用频道选项排除你最忙的频道——这是唯一可以做到的类别。
  </Accordion>

  <Accordion title="语音事件比看起来更嘈杂" icon="volume-high">
    成员加入和离开语音会产生持续条目。仅在你特别需要时才记录它们。
  </Accordion>

  <Accordion title="Webhook 在频道更改后仍然有效" icon="link">
    Webhook 目的地在频道被重命名或移动时仍然工作，并且发布时不需要机器人在那里的发送权限。需要 Basic。
  </Accordion>
</AccordionGroup>

## 故障排查

<AccordionGroup>
  <Accordion title="没有记录任何东西">
    请检查日志在 [服务器设置](/zh-CN/server-management/setup) 中已打开，然后检查具体事件已启用并有目的地。
  </Accordion>

  <Accordion title="显示执行者一直自己关闭">
    它需要 Basic，低于该等级会被静悄悄地重置。
  </Accordion>

  <Accordion title="我设置了 Webhook 但它回退到频道">
    相同原因——Webhook 目的地需要 Basic。
  </Accordion>

  <Accordion title="我找不到战斗通行证日志事件">
    它们没有类别标签页。请使用全部标签页并搜索。
  </Accordion>

  <Accordion title="事件有空白或奇怪的名称">
    少数事件出厂时没有显示名称。事件本身正常工作。
  </Accordion>
</AccordionGroup>

## 相关

<CardGroup cols={2}>
  <Card title="仪表板监视器" icon="desktop" href="/zh-CN/server-management/dashboard-watcher">
    跟踪在仪表板中而非 Discord 中的更改。
  </Card>

  <Card title="审核工具" icon="gavel" href="/zh-CN/moderation/moderation-tools">
    审阅并解除当前生效的处罚。
  </Card>
</CardGroup>