ログ

「ログ」画面では、Bot が実際にどう動いているかを 1 行ずつの記録として確認できます。コマンドの実行、モデレーション、サーバーへの参加・退出、エラーの発生など、Bot のあらゆる動作がここに残ります。

検索・フィルターでの絞り込み、「ライブ受信(ライブ tail)」でのリアルタイム表示、表示中のログのコピー・ファイル保存ができます。1 件をクリックすれば、そのログの詳細(発生時刻・エラー内容・Discord 上の文脈など)を確認できます。

ログは Bot が動作したときに記録されます。Bot を作成・起動した直後はまだ何も表示されないことがあります。Bot が起動すると順次ログが流れてきます。

この画面でできること

ログをキーワードで検索する(メッセージ・アクション・カテゴリ・サーバー名・ユーザー名が対象)
フィルターで期間・ログレベル・ステータス・サーバー・エラー重要度などを指定して絞り込む
直近 1 時間のログ件数を**ヒストグラム(棒グラフ)**で俯瞰する(成功とエラーの内訳つき)
**ライブ受信(ライブ tail)**で、発生したログをリアルタイムに受け取る
表示中のログをコピーしたり、CSV / JSON ファイルとして書き出す
ログ行をクリックして詳細を開き、前後のログへ移動したり、内容をコピーする

ログ画面を開く

Bot を選んで「ログ」を開く

ダッシュボードで対象の Bot を開き、左側のサイドバー(または Bot 概要画面)から「ログ」を選びます。

一覧表の見方を確認する

ログの一覧表には次の 5 つの列があります。

列	内容
日時	ログが記録された時刻。マウスを重ねると日本時間・UTC・相対時間が表示されます
レベル	ログの重要度(`INFO` / `WARNING` / `ERROR` / `CRITICAL`)。警告は黄色、エラーは赤色で表示されます
カテゴリ	ログの種類(「コマンド」「モデレーション」「機能」「サーバー」「システム」など)
アクション	実行された具体的な動作。該当がない場合は `-` が表示されます
メッセージ	そのログの内容を表す説明文。右側に応答時間(ms)やステータス(成功・エラーなど)のバッジが付くことがあります

左下の「戻る」をクリックすると、Bot 概要画面に戻れます。

ログを検索する

画面上部の検索欄「ログを検索…」にキーワードを入力すると、一致するログだけが絞り込まれます。検索の対象:

ログのメッセージ(説明文)
アクション
カテゴリ
サーバー名(またはサーバー ID)
ユーザー名(またはユーザー ID)

入力すると即座に絞り込まれます。検索欄の横に表示される「検索クリア」(×ボタン)をクリックすると、入力をすべて消して元の表示に戻せます。

検索とフィルターは組み合わせて使えます。両方を指定した場合は、両方の条件を満たすログだけが表示されます。

フィルターで絞り込む

フィルターを使うと、期間・ログレベル・ステータス・サーバー・エラー重要度などの条件でログを絞り込めます。

フィルターを開く

画面が広いとき(パソコンなど)は、フィルターが左側のサイドバーに表示されています。画面が狭いときや、フィルターが見当たらないときは、ツールバーの「フィルターを開く」(漏斗のアイコン)をクリックすると、フィルターのパネルが開きます。

条件を選ぶ

各項目の見出しをクリックして選択肢を展開し、チェックを入れた条件だけが絞り込みに反映されます。各選択肢の右側には、現在のログに何件あるかの件数が表示されます。

絞り込みを解除する

絞り込みをやめたいときは、「すべて解除」をクリックするとフィルターの指定がすべてリセットされます(検索欄の入力も一緒にクリアされます)。

期間

「期間」では、表示するログの時間範囲を指定します。プルダウン(「期間を選択」)から、あらかじめ用意された範囲を選べます。

選択肢	内容
すべての期間	期間で絞り込まない(初期状態)
直近 30 分	過去 30 分間のログ
直近 1 時間	過去 1 時間のログ
直近 6 時間	過去 6 時間のログ
直近 12 時間	過去 12 時間のログ
直近 24 時間	過去 24 時間のログ
直近 3 日間	過去 3 日間のログ
直近 7 日間	過去 7 日間のログ
直近 14 日間	過去 14 日間のログ

さらに細かく日時を指定したいときは、プルダウンの左にあるカレンダーのボタンをクリックします。カレンダーが開くので、開始日と終了日をクリックで選び、それぞれに「開始」「終了」の時刻(HH:mm 形式)を入力して「適用」をクリックします。指定した範囲は「カスタム範囲」として反映されます。

カレンダーで指定する日時は、お使いの端末のタイムゾーン(ローカル時刻)で扱われます。カレンダーの下部に現在のタイムゾーンが表示されます。

ログレベル

ログの重要度で絞り込みます。複数を同時に選べます。

レベル	意味
INFO	通常の情報ログ
WARNING	警告(注意が必要な事象)
ERROR	エラー(処理が失敗した事象)
CRITICAL	重大なエラー

ステータス

ログの結果(状態)で絞り込みます。複数を同時に選べます。

ステータス	意味
開始	処理の開始
成功	処理の正常完了
エラー	処理の失敗
警告	警告つきの処理
スキップ	処理のスキップ
稼働中	継続して動作中
処理中	処理の実行中
停止	停止中
パネル送信	パネルの送信
予約	予約された処理

サーバー

Bot が参加しているサーバーのうち、ログに登場するサーバーで絞り込みます(ログにサーバーの記録がある場合のみ表示されます)。特定のサーバーで起きたことだけを確認したいときに便利です。

エラー重要度

エラーログの重要度で絞り込みます。複数を同時に選べます。

重要度	意味
情報	参考情報レベル
警告	警告レベル
エラー	エラーレベル
重大	重大レベル

その他

「エラー有りのみ」にチェックを入れると、エラー情報を含むログだけに絞り込めます。トラブルを調べたいときに役立ちます。

ヒストグラム(直近 1 時間)

ツールバーのすぐ下には、直近 1 時間のログ件数を 1 分ごとに示す棒グラフ(ヒストグラム)が表示されます。1 本の棒は、その時間帯のログ件数を表し、内訳として成功とエラーが色分けされています。棒にマウスを重ねると、その 1 分間の成功件数・エラー件数を確認できます。

直近 1 時間にログが 1 件もないときは、「直近 1 時間にログはありません」と表示されます。

ライブ受信(ライブ tail)

「ライブ受信(ライブ tail)」をオンにすると、新しく発生したログがリアルタイムで一覧に流れ込んできます。

ライブ受信(ライブ tail)を使うには Bot が稼働している必要があります。Bot が停止しているときはライブ受信を開始できません。

Live ボタンで開始する

ツールバーの「Live」ボタン(再生アイコン)でライブ受信が始まります。接続中はボタンのアイコンが一時停止マークに変わります。

接続状態を確認する

ボタンの隣に小さなドットと状態ラベルが表示され、現在の接続状況がわかります。

表示	状態
Live	受信中(リアルタイムにログを受け取っています)
接続中…	接続を試みています
再接続中…	一時的に切れたため、接続をやり直しています
別タブで接続中	別のタブやブラウザで同じ Bot のログを開いたため、こちらは一時停止しています
切断	接続が切れました

ライブ受信中はログ一覧に「Live Mode」という区切り線が表示され、その区切り線より上(新しい側)がリアルタイムに受信したログ、下が既存のログです。

一時停止・再接続する

Live ボタン(受信中は一時停止アイコン)をクリックすると、ライブ受信を一時停止できます。再度クリックすれば再接続します。

同じ Bot のログを別のタブやブラウザで開くと、先に開いていた接続は閉じられます(状態が「別タブで接続中」になります)。複数の画面で同時にライブ受信することはできません。

更新と共有(コピー・エクスポート)

コピー・ファイル出力する

ツールバーの「共有」メニュー(共有アイコンのボタン)を開くと、次の操作ができます。

メニュー	内容
ログをコピー	表示中のログをテキスト形式でクリップボードにコピーします
CSV で出力	表示中のログを CSV ファイル(`bot-logs-….csv`)として保存します。Excel などの表計算ソフトで開けます
JSON で出力	表示中のログを JSON ファイル(`bot-logs-….json`)として保存します

エクスポートやコピーの対象は、現在のフィルター・検索で絞り込まれた「表示中のログ」です。必要なログだけを先に絞り込んでから出力すると、目的のデータだけを取り出せます。

ログの詳細を見る

一覧のログ行をクリックすると、そのログの詳細が開きます(パソコンでは画面の右側に、スマートフォンなどでは画面いっぱいに表示されます)。

詳細には、ログの内容に応じて次のような情報がまとまって表示されます。

セクション	内容
イベント	カテゴリ・アクション・レベル・コマンド名・応答時間など、ログの基本情報
メッセージ	そのログの説明文(本文)
エラー	エラーが発生していた場合の、エラーの種類・重要度・タイトル・メッセージ・詳細など
Discord	関連するサーバー・チャンネル・ユーザーなど、Discord 上の文脈
ランタイム	このログ固有の識別子(`stream_id`)など、内部的な情報

詳細パネルの上部には、次のボタンがあります。

ボタン	操作
前のログ	一覧で 1 つ前のログの詳細に移動します
次のログ	一覧で 1 つ次のログの詳細に移動します
コンテキストをコピー	このログの内容を整形してクリップボードにコピーします。コピーすると「コピーしました」と表示されます
閉じる	詳細の表示を閉じます

エラーログの詳細では、エラーの内容が日本語の分かりやすい見出しで表示されます。サポートに問い合わせるときは、「コンテキストをコピー」でコピーした内容を添えると、状況が伝わりやすくなります。

ログが表示されないとき

「ログがありません」と表示される: Bot がまだ何も動作していない可能性があります。Bot が起動して動作すると、自動的にログが記録されます。
「一致するログがありません」と表示される: 検索キーワードやフィルターの条件で絞り込みすぎている可能性があります。「すべて解除」や「検索クリア」で条件を見直してください。
ライブ受信が始まらない / すぐ切断される: Bot が稼働しているか確認してください。停止中の Bot ではライブ受信を利用できません。

次のステップ・関連ページ

Bot概要 — Bot の全体的な状態を確認する
サーバー — Bot が参加しているサーバーを確認する
ストレージ — Bot が保存しているデータを確認する
全コマンド管理 — Bot のコマンドを管理する

ログ