Wiki / Core Features / 审计日志

审计日志

更新者 Maxime_48 · 3小时前 · 浏览量:96

语言: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

审计日志记录的是人们在 YAWBDB 面板内做了什么:谁启用了某个功能、修改了某项设置、添加了团队成员,或者平台管理员在后台做了什么。它是你追溯仪表盘里发生的一切的责任记录。

与 服务器日志 不同。 服务器日志记录的是 Discord 事件(加入、消息删除、语音活动等)。审计日志记录的是面板操作(配置更改、团队管理、审核)。它们回答的是不同的问题:“我的 Discord 服务器上发生了什么?”和“谁在我的仪表盘里改了什么?”。


🔭 三种视图,同一条记录

审计日志是同一条记录在三个范围上的视图。一次操作会自动出现在所有与它相关的视图中,你不必去多个地方查找。

视图 位置 显示内容
服务器活动 某个服务器 → 活动日志 对该服务器配置所做的一切
团队活动 团队设置 → 活动日志 团队的所有治理操作,以及在团队拥有的每个服务器上所做的一切
后台(管理员) 管理 → 活动日志 整个平台上所有团队和服务器的每一项操作

由于这些视图相互关联,一次操作会同时出现在所有相关的地方。在某个服务器上启用一项功能,会出现在该服务器的日志、它所属团队的日志以及后台中。当平台管理员对你的某个服务器进行操作时,你在自己团队和服务器的日志中也能看到,并且清楚地标有 管理员 标记,所以后台的干预对你来说从来不是不可见的。


👁️ 谁能看到什么

  • 服务器和团队活动:团队所有者以及拥有管理权限(管理员角色)的成员。没有管理权限的成员无法打开。
  • 后台:仅限平台管理员。他们能看到完整、不经过滤的记录。

📋 记录哪些内容

服务器配置

  • 功能被启用或禁用
  • 保存的功能设置(Automod、入服验证、Starboard、服务器日志等)
  • 服务器从团队中移除

团队治理

  • 成员被邀请、添加、移除或自行离开
  • 团队被重命名或删除

后台(管理员)操作

  • 用户被封禁、解封,或被赋予新的平台角色
  • 平台 SEO 设置和集成凭据被更新
  • 发送了一封群发邮件,发布或重新发送了一条公告
  • 某个套餐的价格被更改或同步到 PayPal,某项功能被移入或移出测试版
  • 机器人状态轮换被重写,某个 wiki 版块被删除
  • 清理机器人已不在其中的所有服务器的操作

审核:针对某个人所做的决定

  • 成员被处罚、原因被改写、历史记录被清除
  • 申请被接受或拒绝、其回答被删除
  • 举报被关闭,或直接从举报中发出处罚
  • 对申诉做出裁决;工单被关闭或删除
  • 某人的 XP 被调整或重置、成员被从生日列表中移除、对某条建议做出裁决

服务器功能的创建、改写和删除

  • Automod 规则、自定义命令、嵌入模板、抽奖
  • 反应角色消息、定时消息、社交提醒
  • 生日、建议、等级设置及其奖励图

每一条记录都包含谁做的(即使他们的账号之后被删除,也会保留)、什么时候,以及受影响的对象。

为什么审核自成一类。 针对某个人所做的决定,不应该和一个取色器的改动放在同一个列表里。处罚、被清除的历史记录、被拒绝的申请和被调整的 XP,都与设置更改分开存放,这样服务器所有者可以只看其中一类,而不必在另一类里翻找。

它填补的空白。 以前,审核会把记录留在 Discord 的日志频道里,而那是可选的。在没有日志频道的服务器上,清除某位成员的历史记录什么都不会留下。而且直接从举报发出处罚会完全绕过审核页面:那是唯一一种在面板端没有任何痕迹的处罚。

有意不记录的内容

  • 工作人员的回复和内部备注:它们本身已经是附有作者的持久记录,把它们也审计一遍,只会白白把每条消息复制到第二张表里。
  • 对套餐、wiki 版块或 wiki 页面的重新排序:它只是移动了一个排序列,别无其他。
  • wiki 页面的正文:已经按版本逐一存档,并附有作者。
  • AI 记忆条目的具体内容。 记录里会写明某条事实被写入、编辑或删除,但绝不会写它的内容。这条记录比事实本身存在得更久,并按自己的计划清理,所以把那句话复制进去,就等于悄悄地撤销了删除。

🔍 具体改了什么

大多数条目都带有一张更改前 / 更改后的表:不只是“Wordle 设置已保存”,而是哪些字段变了,以及它们从什么变成了什么。

字段 更改前 更改后
channel_id 8412… 9930…
cooldown_seconds 10 30

在任意条目上打开 详情 就能看到。关于它的构建方式,有几点值得了解:

  • 只列出真正发生变化的内容。 不改动任何东西就保存表单,不会记录任何内容;表单返回的字段形式不同(比如用 "1" 代替 1),也不会被报告为更改。
  • 列表是整体比较的。 在允许列表里增加一个频道,只算作对这个列表的一次更改,而不是每一项的位置都变了。
  • 嵌套的设置按路径显示,所以 categories.voice.enabled 会告诉你你关掉的是哪个类别。
  • 凭据绝不会被写下来。 如果某个令牌或密钥被更改,条目只会记录它被轮换了,两边都显示 ••••••••。这适用于所有地方,包括管理员的集成凭据。

每条记录都用你的语言显示:句子会跟随你为面板选择的语言,而当两者读起来不同时,记录时使用的那行英文会保留在下方。在这个功能加入之前记录的条目,仍然只用英文显示。


🎚️ 查找条目

三种视图提供同样的筛选器:

  • 搜索:操作者、操作、描述或受影响的对象
  • 类别:功能、服务器、团队、成员、订阅、账单、管理、认证
  • 操作:精确的操作,从你的日志中实际存在的操作里选择
  • 操作者:某一个人
  • 日期范围:起始 / 结束
  • 服务器(团队和后台视图),以及 来源:管理员或用户(仅后台)

启用的筛选条件会以标签的形式显示在表格上方,点击其中一个即可移除。筛选器上方的计数器显示总数、最近 24 小时的数量、后台操作有多少次,以及有多少不同的人进行过操作。


🪝 推送到你自己的服务器

团队的记录不一定非要在这个页面上查看。团队设置 → Webhook 可以把它指向你自己的一个 URL:你订阅的每一条记录,在写入的那一刻就会以带签名的 JSON POST 的形式送达。

Webhook 携带的内容与这个页面显示的完全一致,不多也不少:相同的行、相同的字段,只是没有 IP 地址,IP 地址绝不会离开面板。完整的设置方法、数据格式和签名验证,请见 对外 Webhook。


⏳ 保留期限

条目会在一个滚动窗口内保留(默认 180 天),更早的会被自动清理。这条记录是只增不改的:条目在写入之后绝不会被编辑。