サーバーログは、サーバーで起きるすべてを追跡して記録します。Discord上では整形された埋め込みとして、パネルでは検索できるエントリーとして記録されます。
設定はすべてパネルから行います。スラッシュコマンドで設定するものは何もありません。
📋 ログに記録される内容
サーバーログは、10個の独立したカテゴリに分かれています。必要なものだけを有効にします。
| カテゴリ | 追跡される内容 |
|---|---|
| 👥 メンバー | 参加、退出、BAN、BAN解除、キック、ニックネームの変更、ロールの変更 |
| 💬 メッセージ | 編集、削除、一括削除、ピン留め |
| 📁 チャンネル | 作成、削除、名前変更、トピック、スロウモード、NSFW、カテゴリー、さらに権限の上書きは、許可された、拒否された、許可されなくなった、拒否されなくなった、と1つの遷移ずつ名前を付けて記録されます |
| 🎭 ロール | 作成、削除、名前変更、権限と色の変更 |
| 🎙️ ボイス | 参加、退出、チャンネル間の移動、スピーカーミュート、ミュート、配信の開始/終了 |
| 🏠 サーバー | 名前、アイコン、説明、認証レベル、バナー、AFK / システム / ルール / モデレーターのチャンネル、さらにオーナーの変更、不適切なコンテンツのフィルター、モデレーションに必要な2段階認証のレベル |
| 🔗 招待 | 作成と削除（招待の完全なメタデータ付き） |
| 😀 絵文字・スタンプ | 作成、削除、名前変更（絵文字）、追加、削除、名前変更、説明の変更（スタンプ） |
| 🤖 ボット | ボットのサーバーへの追加 |
| 🔨 モデレーション | BAN、キック、警告、ミュート、ソフトBAN、BAN解除、ミュート解除 |
**権限の4つの遷移を別々に名前付けする理由。**許可されなくなったは、判断をメンバーのロールに戻します。拒否されたは、メンバーからその判断を奪います。この2つは同じイベントではなく、両者をまとめてしまうログでは、どちらが起きたのかわかりません。
誰かが最初に弱める2つの設定は、不適切なコンテンツのフィルターと、モデレーションに必要な2段階認証のレベルです。どちらも、完全な名前で表示されるようになりました。行には「1 → 0」ではなく*「Elevated → None」*と表示され、チャンネルの設定には、IDではなくチャンネルの名前が表示されます。
📡 ログチャンネル
各カテゴリは、個別に有効化でき、それぞれに専用のログチャンネルを割り当てられます。
すべてを受け止めるフォールバックとして、1つのグローバルログチャンネルを設定することもできます。カテゴリに専用のチャンネルがない場合、そのイベントはグローバルチャンネルに送られます。
例: モデレーションのイベントは非公開の
#mod-logに、それ以外はすべて汎用の#server-logに送る。
🙈 除外ルール
ノイズを減らすために、ログに記録しないイベントを除外できます。
- チャンネル: 無視するチャンネルのイベントは、記録されません（ボットのスパムや、スタッフ専用の非公開チャンネルに便利です）。
- ロール: 無視するロールのいずれかを持つメンバーは、記録の対象から除外されます。
- ユーザー: 特定のDiscordのユーザーIDを除外します。
🔎 ログビューアー
保存されたイベントは、ログビューアータブから、パネル上で直接閲覧できます。
次の項目で絞り込めます。
- カテゴリ（メンバー、メッセージ、ロールなど）
- キーワード（イベントの種類、実行者、対象にまたがって検索）
- 実行者ID / 対象ID
- 期間（開始 / 終了）
結果はページ分けされ、現在絞り込んでいる表示をJSONファイルとしてエクスポートできます。
保存はデフォルトで有効です。保持期間はデフォルトで30日で、最大365日まで設定できます。
🔗 サーバーログとモデレーション
モデレーション機能が有効なときは、モデレーションの操作（BAN、キック、警告、ミュート、およびその取り消し）が、自動的にモデレーションのログカテゴリに流れ込みます。追加の設定は不要です。
モデレーションのカテゴリのカードには、ステータスのバッジが表示されます。
- Bridge connected: モデレーション機能が有効で、操作が自動で同期されています。
- Standalone: モデレーションのカテゴリは、Discordの監査ログが報告する内容だけを記録します。
🔗 サーバーログとその他の機能
モデレーションの操作を行うほかの機能も、モデレーションカテゴリに記録されるので、すべてが一か所に集まります。
- Automodとアンチレイドの操作。
- Honeypotの発動。サーバーログにモデレーションのチャンネルが設定されている場合、重複したエントリーを避けるため、Honeypot独自のログチャンネルは使われません。
👍 おすすめの設定
- フォールバックとして、グローバルログチャンネルを設定します。
- 必要なカテゴリを有効にして、機密性の高いもの（モデレーション、メンバー）には、それぞれ専用の非公開チャンネルを割り当てます。
- ボットのスパムや、騒がしい連携のチャンネルを、無視するチャンネルに追加します。
- あとで履歴を検索できるように、保存をオンのままにします。
💡 ベストプラクティス
- モデレーションのログは、スタッフ専用のチャンネルに送ってください。
- 非常に大きなサーバーでは、すべてのカテゴリを一度にログに記録するのは避け、実際に確認するものを選んでください。
- 保持期間を超えて記録を残すには、ビューアーのエクスポートを使ってください。
- 手動の操作と自動の操作のどちらも記録されるよう、モデレーション機能と組み合わせてください。