監査ログは、YAWBDBのパネル内での操作を記録します。誰が機能を有効にしたか、設定を変更したか、チームメンバーを追加したか、プラットフォーム管理者がバックオフィスで何をしたか、といったことです。ダッシュボード内で起きたすべてのことについて、責任の所在を示す記録です。
サーバーログとは別のものです。サーバーログはDiscordのイベント(参加、メッセージの削除、ボイスのアクティビティなど)を記録します。監査ログはパネルでの操作(設定の変更、チームの管理、モデレーション)を記録します。答える問いが違います。「Discordサーバーで何が起きたか」と「ダッシュボードで誰が何を変更したか」です。
🔭 3つのビュー、1つの記録
監査ログは、同じ記録を3つの範囲で見たものです。操作は、関係するすべてのビューに自動的に表示されるので、複数の場所を探す必要はありません。
| ビュー | 場所 | 表示される内容 |
|---|---|---|
| サーバーの操作 | サーバー → 操作ログ | そのサーバーの設定に対して行われたすべての操作 |
| チームの操作 | チーム設定 → 操作ログ | チームのガバナンスのすべてと、チームが所有するすべてのサーバーで行われたすべての操作 |
| バックオフィス(管理者) | 管理 → 監査ログ | すべてのチームとサーバーを含む、プラットフォーム全体のあらゆる操作 |
ビューは相互に連携しているため、1つの操作は、関係するすべての場所に同時に表示されます。サーバーで機能を有効にすると、そのサーバーのログにも、チームのログにも、バックオフィスにも表示されます。プラットフォーム管理者があなたのサーバーに対して操作を行った場合も、あなた自身のチームとサーバーのログに表示され、管理者とはっきり表示されます。そのため、バックオフィスによる介入があなたから見えなくなることはありません。
👁️ 誰が何を見られるか
- サーバーとチームの操作 - チームのオーナーと、管理権限(管理者ロール)を持つメンバー。管理権限のないメンバーは開けません。
- バックオフィス - プラットフォーム管理者のみ。フィルターなしの完全な記録を見られます。
📋 記録される内容
サーバーの設定
- 機能の有効化と無効化
- 保存された機能の設定(自動モデレート、参加認証、Starboard、サーバーログなど)
- チームから削除されたサーバー
チームのガバナンス
- メンバーの招待、追加、削除、退出
- チーム名の変更と削除
バックオフィス(管理者)の操作
- ユーザーのBAN、BAN解除、新しいプラットフォームロールの付与
- プラットフォームのSEO設定と連携の認証情報の更新
- メーリングの送信、お知らせの公開または再送
- プランの価格の変更またはPayPalとの同期、機能のベータへの出し入れ
- botのステータスローテーションの書き換え、Wikiセクションの削除
- botがもう参加していないすべてのギルドを削除するクリーンアップ
モデレーション - 人に対して下された決定
- メンバーへの処分、理由の書き換え、履歴の消去
- 申請の承認または却下、その回答の削除
- 通報のクローズ、または通報から直接下された処分
- 異議申し立てへの裁定、チケットのクローズまたは削除
- 誰かのXPの調整やリセット、誕生日リストからのメンバーの削除、提案への裁定
サーバーの機能の作成、書き換え、削除
- 自動モデレートのルール、カスタムコマンド、埋め込みテンプレート、プレゼント企画
- リアクションロールのメッセージ、予約メッセージ、ソーシャル通知
- 誕生日、提案、レベリングの設定とその報酬グラフ
各エントリーには、誰が行ったか(あとからそのアカウントが削除されても残ります)、いつ行ったか、そして対象の項目が記録されます。
**モデレーションが独立したカテゴリである理由。**人に対して下された決定は、カラーピッカーと同じ一覧に載せるものではありません。処分、消去された履歴、却下された申請、調整されたXPは、すべて設定の変更とは別にまとめられているので、サーバーのオーナーは、一方をもう一方に埋もれずに読めます。
これで解消された問題。以前は、モデレーションの記録はDiscordのログチャンネルに残されていましたが、これは任意です。ログチャンネルのないサーバーでは、メンバーの履歴を消去しても何も残りませんでした。さらに、通報から直接処分を下すとモデレーションのページを完全に迂回するため、パネル側に一切の記録が残らない唯一の処分でした。
意図的に記録しないもの
- スタッフの返信と内部メモ - すでに作成者付きの永続的な記録として残っています。これらを監査対象にすると、すべてのメッセージを意味もなく2つ目のテーブルにコピーすることになります。
- プラン、Wikiセクション、Wikiページの並べ替え - 並び順の列が動くだけで、それ以外は何も変わりません。
- Wikiページの本文 - すでに、作成者付きでバージョンごとにアーカイブされています。
- **AIメモリーのエントリーの内容。**記録されるのは、事実が書き込まれた、編集された、削除されたということだけで、その内容は記録されません。記録は事実よりも長く残り、独自のスケジュールで整理されるので、その文をコピーしてしまうと、削除したことが静かに無効になってしまいます。
🔍 何が変わったのか
ほとんどのエントリーには、変更前/変更後の表が付いています。「Wordleの設定を保存しました」だけではなく、動いた項目と、その変更前の値と変更後の値がわかります。
| 項目 | 変更前 | 変更後 |
|---|---|---|
channel_id |
8412… | 9930… |
cooldown_seconds |
10 | 30 |
見るには、任意のエントリーの詳細を開きます。仕組みについて、知っておくとよい点がいくつかあります。
- **実際に変わったものだけが記載されます。**何も触らずにフォームを保存しても何も記録されず、フォームから別の形で返ってきた項目(
1ではなく"1"など)は、変更として報告されません。 - **リストは丸ごと比較されます。**許可リストにチャンネルを1つ追加した場合、すべての要素の位置が動いたのではなく、そのリストへの1つの変更として表示されます。
- **入れ子の設定はパスとして表示されます。**そのため、
categories.voice.enabledなら、どのカテゴリをオフにしたかがわかります。 - **認証情報は決して書き込まれません。**トークンやシークレットが変更された場合、エントリーにはローテーションされたことだけが記録され、両側とも
••••••••と表示されます。これは、管理者の連携の認証情報を含め、あらゆる場所に当てはまります。
各エントリーはあなたの言語で表示されます。文章はパネルに選んだ言語に従い、記録時の英語の行も、読み方が異なる場合はその下に残ります。これが追加される前に記録されたエントリーは、英語のみで表示されます。
🎚️ エントリーを探す
同じフィルターが、3つのビューすべてで使えます。
- 検索 - 実行者、操作、説明、対象の項目
- カテゴリ - 機能、サーバー、チーム、メンバー、サブスクリプション、請求、管理、ログイン
- 操作 - 正確な操作。実際にログにあるものから選びます
- 実行者 - 特定の1人
- 日付の範囲 - 開始/終了
- サーバー(チームとバックオフィスのビュー)と種別:管理者またはユーザー(バックオフィスのみ)
有効なフィルターは表の上にチップとして表示され、クリックすると解除できます。フィルターの上のカウンターには、合計、過去24時間、バックオフィスの操作の件数、そして操作を行った人の人数が表示されます。
🪝 自分のサーバーにプッシュする
チームの記録は、このページで読む必要はありません。チーム設定 → Webhookで、自分が所有するURLに向けられます。購読しているすべてのエントリーが、書き込まれた瞬間に、署名付きのJSONのPOSTとして届きます。
Webhookが運ぶのは、このページに表示されるものとまったく同じ内容で、それ以上ではありません。同じ行、同じ項目で、IPアドレスだけが含まれず、これはパネルの外には出ません。設定の手順、ペイロードの形、署名の検証については、送信Webhookをご覧ください。
⏳ 保持期間
エントリーは、一定の期間(既定では180日)保持され、それより古いものは自動的に整理されます。この記録は追記のみで、エントリーがあとから編集されることはありません。