Discord操作監査ログ
Discord上の操作を記録し、イベント別の通知と履歴確認を行います。設定を開く
対象サーバーの「設定と機能」から「運用・監査」を開き、「監査ログ」を選択します。ここなつfrex独自の内部イベントではなく、Discordが発火する操作だけを記録します。通知先とイベントの分け方
最初は「すべてのログ」グループへ通知先チャンネルを指定するだけで利用できます。必要に応じてグループを増やし、メッセージ、モデレーション、チャンネル、ロールなどのイベントを別々のチャンネルへ割り当てます。未分類の受け皿を指定すると、割り当て漏れを防げます。本文と変更内容
監査ログが有効な場合、取得できた本文を記録します。編集前後や単一・一括削除の本文、ロール付与・剥奪で操作したロール、VCの移動前後などを通知と履歴で確認できます。チャンネル編集では変更前後、削除では削除時の設定を残します。権限と保持期間
実行者の照合にはBotの「監査ログを表示」権限が必要です。通知には送信先チャンネルの閲覧、メッセージ送信、埋め込みリンク権限が必要です。保存期間を過ぎた記録は自動的に削除されます。操作前の準備
- 対象サーバーのモデレーション閲覧・設定変更権限
- Botの監査ログを表示権限
- 通知先チャンネルの閲覧・送信・埋め込みリンク権限
操作手順
監査ログを有効にする
- 設定と機能の「運用・監査」から「監査ログ」を開きます。
- Discord操作の監査ログを有効にします。
- すべてのロググループで通知先チャンネルを選択します。
- 保存を押し、テスト操作が通知・履歴に残ることを確認します。
イベント別に通知先を分ける
- ロググループを追加します。
- 各グループの通知先チャンネルを選択します。
- イベントを1つのグループへ割り当てます。
- 未分類の受け皿を1つ指定し、割り当て漏れを確認します。
本文と差分を確認する
- 監査ログを有効にすると、取得できた本文を削除時と編集前後に記録・通知します。
- メッセージを編集して、通知に変更前と変更後が表示されることを確認します。
- テストメッセージを削除し、削除本文・投稿者・添付が通知されることを確認します。
- 直近の監査ログで本文・差分・操作対象の詳細も確認します。
設定項目一覧
画面に表示される入力項目と、その値がDiscord上の動作へ与える影響です。| 設定項目 | 意味 | 選択肢・入力条件 |
|---|---|---|
| Discord操作の監査ログ | Discordイベントの記録と通知の親スイッチです。 | 画面の案内に従って入力 |
| ロググループ・通知先 | イベントの集合と、その通知先テキストチャンネルです。イベントは1つのグループだけに所属できます。 | 画面の案内に従って入力 |
| 未分類の受け皿 | グループへ明示的に割り当てていないイベントの通知先です。 | 画面の案内に従って入力 |
| メッセージ本文 | 監査ログが有効な間に取得できた削除時の本文と編集前後の差分を記録・通知します。通知文字数を超える場合、全文は履歴で確認できます。 | 画面の案内に従って入力 |
| 保持日数 | 監査イベントをDBへ保存する日数です。期限切れの記録は自動削除されます。 | 画面の案内に従って入力 |
必要な権限
監査ログを表示（実行者の照合）チャンネルを見るメッセージを送信埋め込みリンクモデレーション閲覧・設定変更権限
うまく動かないとき
実行者が不明になるBotに監査ログを表示権限があるか、操作直後に監査ログを取得できる状態か確認します。
通知が届かない監査ログの有効化、イベントのグループ割り当て、通知先、未分類の受け皿、Botのチャンネル権限を確認します。
編集前や削除本文が表示されない設定前に発生したメッセージや取得できなかった部分は復元できません。設定後の新しいメッセージで確認し、Botの接続状態と通知先権限を確認します。