ログセンター

ログセンターは、WebUI で Nekro Agent の稼働ログを確認するための機能です。デプロイ、アダプター、モデル呼び出し、プラグイン、ワークスペース、サンドボックス関連の問題の切り分けに適しています。

ログには機密情報が含まれる可能性があります

問題を切り分ける際には、ログ内のチャンネル名、ユーザー情報、リクエストアドレス、エラーコンテキストなどの内容に注意してください。公開で助けを求める前に、マスキング処理を行うことをお勧めします。

ログセンターでできること

機能	説明
過去のログを閲覧	最近の稼働記録とエラーメッセージを遡って確認
ソースでフィルタリング	特定のカテゴリのモジュールやサービスの出力のみを表示
リアルタイムログストリーム	ページを開いたまま新しいログを継続的に確認
ログのダウンロード	ログファイルを保存してフィードバックやアーカイブに利用
レベル別に切り分ける	INFO、WARNING、ERROR などのレベルに基づいて問題を特定

いつログを確認すべきか

以下の状況では、ログセンターを開くことをお勧めします：

• Bot が応答しないが、アダプターはオンラインと表示されている
• モデル呼び出しが失敗、タイムアウト、または異常な応答を返す
• プラグインコマンドの実行が失敗する
• ワークスペースまたは Claude Code サンドボックスの起動が失敗する
• ナレッジベースのアップロード、ベクトル化、検索に異常がある
• WebUI のページに不明なエラーが表示される

ログレベルの見方

レベル	意味	推奨事項
DEBUG	詳細なデバッグ情報	切り分け時のみ一時的に有効化
INFO	正常な稼働情報	日常的な確認で十分
WARNING	機能に影響する可能性のある問題	頻繁に発生する場合は設定を確認
ERROR	機能の実行が失敗	優先的に対処
CRITICAL	重大な異常	できるだけ早くサービスの状態を切り分ける

より詳細なログが必要な場合は、「システム設定」で APP_LOG_LEVEL を調整できます。切り分けが完了したら、デフォルトレベルに戻してログの過多を避けることをお勧めします。

切り分けの推奨事項

アダプターの接続問題

まずアダプター名でフィルタリングまたは検索してください。例えば、OneBot、Telegram、Discord、Feishu、WeCom など。以下に重点を置いてください：

• 認証失敗
• Webhook アドレスの誤り
• ネットワーク接続の失敗
• メッセージ解析の失敗

モデル呼び出しの問題

モデルグループ名、Base URL、またはエラーキーワードで検索してください。一般的な原因には以下が含まれます：

• API Key の誤りまたは残高不足
• Base URL の非互換性
• モデル名の入力ミス
• リクエストのタイムアウト
• アップストリームサービスのレート制限

ワークスペースとサンドボックスの問題

ワークスペースのタスクが失敗した場合は、まずワークスペースページの表示を確認し、その後ログセンターで workspace、sandbox、Claude Code などのキーワードで検索してください。

一般的な原因には、イメージのプル失敗、ポート範囲不足、サンドボックスの起動タイムアウト、ワークスペースパスの異常などがあります。

プラグインの問題

プラグイン関連のエラーには通常、プラグイン名やコマンド名が含まれています。切り分けの際は、最近追加または更新したプラグインを一時的に無効にして、問題の範囲を確認してください。

ログをダウンロードしてフィードバックする

コミュニティや開発者に問題を報告する際は、以下を同時に提供することをお勧めします：

1. 問題が発生したおおよその時間
2. 対応するログの抜粋
3. 使用しているアダプターとデプロイ方法
4. 最近バージョンを更新したり、設定を変更したりしたかどうか

送信前に、キー、トークン、Cookie、内部ネットワークアドレスなどの機密情報を削除してください。

関連設定

ログ関連の設定は 高度な設定 を参照してください。よく使う設定には以下が含まれます：

• APP_LOG_LEVEL
• SAVE_PROMPTS_LOG
• DEBUG_IN_CHAT

関連ドキュメント

• ダッシュボード
• 高度な設定
• よくある質問