ログ機能(入退室メッセージ)
ログ機能は、サーバーのメンバーが 参加・退出・キック・Ban されたときに、指定したチャンネルへ自動でお知らせ(ログ)を送る機能です。誰がサーバーに入ってきたか、誰が抜けたか、誰がキック・Ban されたかを記録として残せます。
ダッシュボードのメニューでは「入退室メッセージ」という名前で表示されます。本ページでは「入退室メッセージ」「ログ」の両方の呼び方を使います。
ログ機能は無料で使える機能です。プレミアムプランに加入しなくても利用できます。
この機能でできること
- メンバーがサーバーに 参加 したときの通知
- メンバーがサーバーから 退出 したときの通知
- メンバーが キック されたときの通知
- メンバーが Ban されたときの通知
これらは イベントごとに独立して 設定できます。たとえば「参加と退出だけ通知して、キックと Ban は通知しない」といった使い分けが可能です。さらに、通知メッセージは埋め込み(Embed)で見た目を自由にデザインできます。
サーバーは複数登録でき、サーバーごとに「どのイベントを」「どのチャンネルに」「どんな見た目で」通知するかを別々に設定できます。
ページの開き方
ログ機能の設定は、対象の Bot のダッシュボードから開きます。
Bot の管理画面を開く
ダッシュボードで設定したい Bot を選びます。
メニューから「入退室メッセージ」を選ぶ
左側(またはモバイルではメニュー内)のモジュール一覧から「入退室メッセージ」を選ぶと、ログ機能の設定ページが開きます。
まずは機能を有効化する
ページの一番上に「機能の有効化」のトグルがあります。ログ機能を使うには、まずこのトグルをオンにしてください。
「機能の有効化」がオフのままだと、後述の各種設定をしてもログは送信されません。最初に必ずオンにしてください。
コマンド権限設定
「コマンド権限設定」セクションでは、ログ設定コマンドの有効状態と権限を管理します。管理できるコマンドは次のとおりです。
| コマンド | 説明 |
|---|---|
| 「/log setting」 | 「ログの出力先・詳細設定を変更できます。」 |
/log setting は、Discord 上からログ機能の設定パネルを開くためのコマンドです。このセクションでは、このコマンドを使えるようにするか(有効 / 無効)、誰が使えるか(権限)を設定できます。
コマンド権限設定の具体的な操作方法(有効 / 無効の切り替え、ロールごとの許可・拒否、強制上書きなど)は、全機能で共通です。詳しくは コマンド権限設定の使い方 をご覧ください。
Discord 上での「/log setting」コマンド
ダッシュボードのほかに、Discord 上で /log setting コマンドを実行してもログ設定を編集できます。このコマンドはサーバー内専用で、応答はコマンドを実行した本人にだけ見える形(エフェメラル)で表示されます。
/log setting の応答パネルには、次のメッセージが表示されます。
ログ設定パネル
設定したいログの種類を下のドロップダウンから選択してください。ドロップダウンでログの種類(参加 / 退出 / キック / Ban)を選ぶと、そのイベント専用の設定パネルに切り替わり、現在の状態・送信先チャンネル・各種ボタンが表示されます。パネルには次のボタンが並びます。
| ボタン | 役割 |
|---|---|
| 💡 トグル | そのログの有効 / 無効を切り替えます。 |
| 📁 チャンネル | ログの送信先チャンネルを選びます。 |
| 📝 メッセージ | 埋め込みのタイトル・説明・カラーを編集します。 |
| 🔄 更新 | 変更内容をパネルの表示に反映します。 |
| ↩️ 戻る | 種類選択のパネルに戻ります。 |
Discord 上で送信先チャンネルを選ぶ
📁 チャンネルのボタンを押すと、テキストチャンネルだけに絞り込まれたドロップダウンが開き、次のメッセージが表示されます。
ログを送信するチャンネルを選択してください。チャンネルを選ぶと設定が保存され、次のメッセージが表示されます({ChannelMention} の部分には選んだチャンネル名、{LogTypeName} の部分にはログの種類が入ります)。
{LogTypeName}ログのチャンネルを {ChannelMention} に設定しました。
パネルに反映するには「🔄 更新」ボタンを押してください。チャンネル選択のドロップダウンは表示から 180 秒(3 分)で期限切れになります。時間が経って反応しなくなった場合は、もう一度ボタンを押し直してください。
Discord 上で埋め込みを編集する
📝 メッセージのボタンを押すと、タイトル・説明・カラー(#RRGGBB 形式のカラーコード)を入力できるフォームが開きます。保存に成功すると、次のメッセージが表示されます。
メッセージ設定を保存しました。
パネルに反映するには「🔄 更新」ボタンを押してください。📁 チャンネルと 📝 メッセージのボタンは、そのログが有効になっているときだけ操作できます。無効のあいだはボタンがグレーアウトして押せません。先に 💡 トグルでログを有効にしてください。
/log setting はサーバー内の誰でも実行できます。誰が使えるかを制限したい場合は、上の「コマンド権限設定」または Discord 側のコマンド権限設定でロールごとに調整してください。
サーバー別ログ設定
「サーバー別ログ設定」セクションでは、サーバーごとのログ出力設定を作成・編集します。見出しの右側には現在登録されている設定の数(例: 「2 個の設定」)が表示されます。
まだ設定が 1 つもないときは、次のメッセージが表示されます。
設定可能なサーバーが見つかりません。 上のボタンからサーバーを選択して追加してください。
サーバーを追加する
設定を作るには、まず対象のサーバーを追加します。
追加フォームを開く
セクション内の「新しいサーバー設定を追加」ボタンで追加フォームを開きます。
対象サーバーを選ぶ
「対象サーバー」の選択欄をクリックすると、Bot が参加しているサーバーの一覧が表示されます。一覧から設定したいサーバーを選びます。一覧が表示されないときや見つからないときは、検索欄でサーバー名や ID を入力して絞り込めます。リスト下部の「id で直接入力」欄にサーバー ID を入力して「適用」をクリックする方法でも指定できます。
「追加」ボタンをクリックする
対象サーバーを選ぶと「追加」ボタンがクリックできるようになります。「追加」をクリックすると、そのサーバーの設定が一覧に追加されます。
サーバーを選ぶまで「追加」ボタンはクリックできません(無効状態になっています)。先に「対象サーバー」を選んでください。
同じサーバーは二重に追加できません。すでに追加済みのサーバーをもう一度追加しようとすると、「既に追加されています」「このサーバーの設定は既に存在します。」というメッセージが表示され、追加されません。
登録済みサーバーの一覧
追加したサーバーは、折りたたみ(アコーディオン)形式の一覧で表示されます。各行の見出しには次の情報が表示されます。
| 表示 | 意味 |
|---|---|
| 「Server: (サーバーID)」 | このログ設定が対象としているサーバーの ID です。 |
| 「ログ詳細設定」 | この行を開くとログの詳細設定を編集できることを示します。 |
行をクリックすると、その下に詳細設定(イベントごとのタブ)が開きます。
イベントごとの設定(参加 / 退出 / キック / Ban)
登録したサーバーの行を開くと、上部のタブで参加・退出・キック・Ban のイベントを切り替えられます。各タブは次のイベント用の設定です。
| タブ | 通知されるタイミング |
|---|---|
| 「参加」 | メンバーがサーバーに参加したとき |
| 「退出」 | メンバーがサーバーから退出したとき |
| 「キック」 | メンバーがキックされたとき |
| 「Ban」 | メンバーが Ban されたとき |
参加・退出・キック・Ban はそれぞれ独立した設定です。通知したいイベントのタブで個別に「ログ出力の有効化」をオンにし、送信先チャンネルを指定してください。あるタブをオンにしても、他のタブの設定には影響しません。
各タブには、共通して次の 3 つの設定があります。
ログ出力の有効化
タブの一番上にあるトグルで、このイベントのログを送信するかどうかを設定します。オンになっているイベントだけが通知されます。たとえば「参加」タブのトグルをオンにすると、メンバーが参加したときに通知が送られるようになります。
送信先チャンネル
「送信先チャンネル」では、このイベントのログをどのチャンネルに送るかを指定します。選択欄(「ログチャンネル」)を開いてチャンネルを選びます。
サーバーを選ぶ
選択欄を開くと、まず Bot が参加しているサーバーの一覧が表示されます。対象のサーバーを選びます。
チャンネルを選ぶ
サーバーを選ぶと、そのサーバーのテキストチャンネル一覧が表示されます。ログを送りたいチャンネルを選びます。検索欄でチャンネル名や ID を入力して絞り込むこともできます。
ID で直接指定する(任意)
一覧に出てこない場合は、リスト下部の「id で直接入力」欄にチャンネル ID を入力し、「適用」ボタンをクリックして指定することもできます。
送信先チャンネルにはテキストチャンネルを指定します。Bot がそのチャンネルにメッセージを送れる権限を持っているか、念のため確認してください。
埋め込み設定
「埋め込み設定」では、通知として送られるメッセージ(埋め込み / Embed)の見た目をデザインできます。設定エリアの下部には、実際に Discord で表示されたときのイメージを確認できる「PREVIEW(プレビュー)」が用意されています。プレビューは「🖥️ PC」「📱 Mobile」のボタンで表示幅を切り替えられます。
埋め込みの設定は、次のタブに分かれています。
| タブ | 設定できる内容 |
|---|---|
| 「基本設定」 | タイトル、タイトルURL、説明(Description)、カラー |
| 「著者 (Author)」 | 著者名、著者URL、アイコンURL |
| 「画像設定」 | 画像URL(メイン画像)、サムネイルURL |
| 「フッター」 | フッターテキスト、フッターアイコンURL、タイムスタンプの表示 |
| 「フィールド」 | 見出しと内容のセットを最大 25 個まで追加 |
主な入力項目は次のとおりです。
| 項目 | 説明 |
|---|---|
| 「タイトル」 | 埋め込みの見出しです(最大 256 文字)。 |
| 「タイトルURL」 | タイトルをクリックしたときに開くリンク先です。 |
| 「説明 (Description)」 | 本文です。Markdown に対応しています(最大 4096 文字)。 |
| 「カラー」 | 埋め込み左側の縦線の色です。カラーピッカーまたは色コードで指定します。 |
| 「著者名 (Author Name)」 | 埋め込み上部に表示される著者名です(最大 256 文字)。 |
| 「画像URL (Main Image)」 | 埋め込み内に大きく表示する画像の URL です。 |
| 「サムネイルURL (Thumbnail)」 | 埋め込み右上に小さく表示する画像の URL です。 |
| 「フッターテキスト」 | 埋め込み下部のテキストです(最大 2048 文字)。 |
| 「タイムスタンプを表示」 | オン(ON)にすると埋め込み下部に日時が表示されます。 |
フィールドの追加
「フィールド」タブでは、「見出し」と「内容」のセット(フィールド)を追加できます。
「フィールドを追加」をクリックする
「フィールド」タブを開き、「フィールドを追加」ボタンをクリックすると、新しいフィールド(「Field #1」「Field #2」…)が作られます。
内容を入力する
各フィールドの「Name」に見出し、「Value」に内容を入力します。「Inline」のスイッチをオンにすると、複数のフィールドを横並びに表示できます。
不要なフィールドを削除する
フィールド右上のゴミ箱アイコンをクリックすると、そのフィールドを削除できます。
フィールドは 1 つの埋め込みにつき最大 25 個まで追加できます。上限に達すると「Fieldは最大25個までです。」と表示されます。
埋め込みの編集画面は、ウェルカムメッセージなど他の機能と共通の作りになっています。埋め込みの作り方をより詳しく知りたい場合は 埋め込みメッセージ のページもあわせてご覧ください。
サーバー設定を削除する
不要になったサーバーのログ設定は削除できます。
削除したいサーバーの行を探す
「サーバー別ログ設定」の一覧から、削除したいサーバーの行を見つけます。
「削除」ボタンをクリックする
行の右側にある「削除」ボタンをクリックすると、そのサーバーのログ設定が一覧から取り除かれます。
削除すると、そのサーバーのログ設定(参加・退出・キック・Ban すべて)が一覧から消えます。誤って削除したまま保存しないよう注意してください。保存前であれば、後述の「破棄」で元に戻せます。
設定を保存する
設定を変更すると、画面の下部に「未保存の変更があります」というバー(保存バー)が表示されます。変更内容は、ここで保存するまで反映されません。
設定を一通り編集する
機能の有効化、サーバーの追加、各タブの「ログ出力の有効化」「送信先チャンネル」「埋め込み設定」などを必要に応じて編集します。
「保存」をクリックする
保存バーの「保存」ボタンをクリックすると、変更が反映されます。保存が完了すると「保存しました」と表示されます。
やり直したいときは「破棄」をクリックする
変更をなかったことにしたい場合は、「破棄」ボタンをクリックすると、編集前の状態に戻せます。
「保存」をクリックせずにページを離れると、変更が反映されません。設定が終わったら必ず「保存」をクリックしてください。
設定の流れ(まとめ)
ログ機能を一通り設定する手順は次のとおりです。
「機能の有効化」をオンにする
ページ上部のトグルでログ機能を有効にします。
必要に応じてコマンド権限を設定する
「コマンド権限設定」で /log setting の有効 / 権限を調整します。
対象サーバーを追加する
「新しいサーバー設定を追加」から対象サーバーを選び、「追加」をクリックします。
イベントごとに通知を設定する
追加したサーバーの行を開き、「参加」「退出」「キック」「Ban」のタブを切り替えて、通知したいイベントで「ログ出力の有効化」をオンにし、「送信先チャンネル」を選びます。必要なら「埋め込み設定」で見た目を整えます。
不要な設定を削除する
使わなくなったサーバー設定は「削除」ボタンで取り除きます。
保存する
保存バーの「保存」ボタンで設定を反映します(詳しくは「設定を保存する」を参照)。
実際に通知される埋め込みと既定値
ログが有効でチャンネルが設定されていると、メンバーのイベント発生時に埋め込み(Embed)が送信されます。送られる埋め込みには、メンバーのメンションや名前、発生日時、ユーザーのアイコンなどが含まれ、キック・Ban のときは実行したモデレーターと理由も表示されます。
埋め込み設定を編集していない場合は、イベントごとに次の既定値が使われます。タイトル・説明・カラーは「埋め込み設定」(または Discord の 📝 メッセージ)でいつでも変更できます。
| イベント | 既定のタイトル | 既定のカラー |
|---|---|---|
| 参加 | メンバーが参加しました | #22ff22(緑) |
| 退出 | メンバーが退出しました | #ff2222(赤) |
| キック | メンバーがKickされました | #ffaa00(オレンジ) |
| Ban | メンバーがBANされました | #ff0000(赤) |
既定の説明文(Description)には、イベントに応じた変数があらかじめ差し込まれています。{EventUser.mention} は対象メンバーのメンション、{EventUser.name} はその名前、{OperatorUser.mention} は操作したモデレーターのメンション、{Event.reason} はキック・Ban の理由に置き換わります。
| イベント | 既定の説明文 |
|---|---|
| 参加 | {EventUser.mention}さん、サーバーへようこそ！ |
| 退出 | {EventUser.name}さんがサーバーから退出しました。 |
| キック | {EventUser.mention}さんが{OperatorUser.mention}によってサーバーからKickされました。\n理由: {Event.reason} |
| Ban | {EventUser.mention}さんが{OperatorUser.mention}によってサーバーからBANされました。\n理由: {Event.reason} |
参加イベントの既定のサムネイルにはメンバーのアイコン({EventUser.icon})が使われます。また、すべてのイベントで埋め込みのタイムスタンプ表示は既定でオンです。
ログ機能の各イベント(参加・退出・キック・Ban)は、初期状態ではすべて無効で、送信先チャンネルも未設定です。通知したいイベントごとに「ログ出力の有効化」をオンにし、「送信先チャンネル」を指定してはじめて通知が送られます。
キック・Ban の見分け方
退出・キック・Ban はメンバーがサーバーからいなくなる点では同じですが、Bot は Discord の監査ログを確認してこれらを区別します。
- メンバーがいなくなった直後(およそ 5 秒以内)に監査ログへキックの記録があれば「キック」として扱い、実行したモデレーターと理由を埋め込みに表示します。
- Ban は Discord の Ban イベントから検出し、最新の Ban 記録からモデレーターと理由を取得します。Ban として記録されたメンバーは、重複を避けるため「退出」としては記録されません。
- キック・Ban のどちらにも該当しない場合は、通常の「退出」として記録します。
キックを正しく「キック」として記録するには、Bot がそのサーバーで監査ログを閲覧できる必要があります。Bot が監査ログを読めない場合、キックされたメンバーは「退出」として記録されます。実際にキックしてから記録までに時間が空きすぎた場合(約 5 秒を超えた場合)も「退出」扱いになることがあります。
入力できる上限とカラーの扱い
埋め込みの各項目には、Discord 側の仕様に合わせた上限があります。Discord 上の 📝 メッセージから編集する場合は、次の制限が適用されます。
| 項目 | 上限 |
|---|---|
| タイトル | 256 文字まで |
| 説明 | 2000 文字まで |
| カラー | #RRGGBB 形式(# を含めてちょうど 7 文字) |
カラーは # のあとに 6 桁の 16 進数を続けた形式で入力します。#gggggg のように解釈できない値や # を付け忘れた値を入力すると、その色は無視され、Discord の標準色で表示されます。これは編集中のプレビューでも、実際に送信されるログでも同じです。
ダッシュボードの「埋め込み設定」では、タイトルは 256 文字、説明は 4096 文字、フッターテキストは 2048 文字までなど、より広い範囲で編集できます。Discord 上の /log setting から編集する場合は、上の表の範囲内で入力してください。
注意点・うまくいかないとき
ログが送信されない、または思ったとおりに表示されないときは、次の点を確認してください。
- イベントが有効になっていない: 通知したいイベント(参加・退出・キック・Ban)のタブで「ログ出力の有効化」がオンになっているか確認してください。初期状態ではすべて無効です。
- 送信先チャンネルが未設定: そのイベントに送信先チャンネルが指定されていないと通知は送られません。
- Bot にチャンネルへの送信権限がない: 設定したチャンネルに Bot がメッセージや埋め込みを送れる権限を持っていないと、ログは送信されません。この場合エラーメッセージは表示されず、静かに送信されないだけなので注意してください。
- 送信先チャンネルが消えている: 設定したチャンネルが削除されたり Bot から見えなくなっていると、ログは送信されません。
- 退出したメンバーの情報が取得できない: メンバーがいなくなった直後に Discord 側からそのユーザー情報を取得できない場合、名前が
Unknown Userとして記録されることがあります。
ログが届かない最も多い原因は「送信先チャンネルへの Bot の権限不足」です。Bot がそのチャンネルでメッセージの送信・埋め込みの送信ができる状態になっているか、ロール設定やチャンネルの権限設定を確認してください。