ログ機能(入退室メッセージ)
ログ機能は、メンバーが 参加・退出・キック・Ban されたときに、指定したチャンネルへ埋め込み(Embed)でお知らせを送る機能です。ダッシュボードのメニューでは「入退室メッセージ」という名前で表示されます。Free プランでも利用できます。
サーバーごとに、4 つのイベントそれぞれの有効/無効・送信先チャンネル・埋め込みの見た目を別々に設定します。イベントは初期状態ですべて無効です。 埋め込みの編集方法は 埋め込みメッセージ をご覧ください。
コマンドの有効化・権限設定は コマンドの権限設定 をご覧ください。
/log settings コマンド
Discord 上でも /log settings でログ設定を編集できます。サーバー内専用で、応答は実行した本人にだけ表示されます。既定では「サーバーの管理」権限が必要です。
- 📁 チャンネルと 📝 メッセージのボタンは、そのログが有効になっているときだけ操作できます。先に 💡 トグルで有効にしてください。
- 変更してもパネルの表示は変わりません。🔄 更新を押すと反映されます。
- 📁 チャンネルのドロップダウンは 180 秒で期限切れになります。反応しなくなったらボタンを押し直してください。
埋め込みの上限とカラー
編集する場所によって上限が異なります。
ダッシュボードでは、タイトル 256 文字・説明 4096 文字・フッターテキスト 2048 文字まで入力でき、フィールドは 25 個まで追加できます。Discord の 📝 メッセージから編集する場合は /embed edit と同じ編集パネルを使うため、説明は 2000 文字までになります。そのほかの上限は 埋め込みメッセージ をご覧ください。
カラーの書き方は 色の指定 をご覧ください。
既定の埋め込み
埋め込み設定を編集していない場合は、次の既定値が使われます。
| イベント | 既定のタイトル | 既定のカラー |
|---|---|---|
| 参加 | メンバーが参加しました | #22ff22(緑) |
| 退出 | メンバーが退出しました | #ff2222(赤) |
| キック | メンバーがKickされました | #ffaa00(オレンジ) |
| Ban | メンバーがBANされました | #ff0000(赤) |
| イベント | 既定の説明文 |
|---|---|
| 参加 | {EventUser.mention}さん、サーバーへようこそ! |
| 退出 | {EventUser.name}さんがサーバーから退出しました。 |
| キック | {EventUser.mention}さんが{OperatorUser.mention}によってサーバーからKickされました。\n理由: {Event.reason} |
| Ban | {EventUser.mention}さんが{OperatorUser.mention}によってサーバーからBANされました。\n理由: {Event.reason} |
{EventUser.mention} は対象メンバーのメンション、{EventUser.name} はその名前、{OperatorUser.mention} は操作したモデレーターのメンション、{Event.reason} はキック・Ban の理由に置き換わります。参加イベントの既定のサムネイルはメンバーのアイコン({EventUser.icon})で、タイムスタンプ表示はすべてのイベントで既定でオンです。
キック・Ban の見分け方
Bot は Discord の監査ログを確認して、退出・キック・Ban を区別します。
- メンバーがいなくなってからおよそ 5 秒以内に監査ログへキックの記録があれば「キック」として扱います。
- Ban は Discord の Ban イベントから検出します。Ban されたメンバーは「退出」としては記録されません。
- どちらにも該当しない場合は「退出」として記録します。
Bot がそのサーバーで監査ログを閲覧できないと、キックされたメンバーは「退出」として記録されます。キックから記録までに約 5 秒を超えた場合も「退出」扱いになることがあります。
うまくいかないとき
- ログが届かない: 最も多い原因は、送信先チャンネルで Bot にメッセージや埋め込みを送る権限がないことです。この場合エラーは表示されません。 チャンネルやロールの権限設定を確認してください。
- イベントが通知されない: そのイベントの「ログ出力の有効化」がオンか、送信先チャンネルが指定されているかを確認してください。設定したチャンネルが削除されたり Bot から見えなくなったりした場合も送信されません。
- 名前が
Unknown Userになる: メンバーがいなくなった直後に Discord からユーザー情報を取得できなかった場合に起こります。
サーバー設定を削除すると、そのサーバーの参加・退出・キック・Ban すべてのログ設定が消えます。保存前であれば「破棄」で元に戻せます。
次のステップ / 関連ページ
最終更新: