ログシステム

一般

LibreChatには、バックエンド（api）に組み込まれた一元的なロギング機能があります。

• Docker インストールでは、ログファイルは /logs に保存されます。

• npm インストールでは、ログファイルは /api/logs に保存されます。

エラーログはデフォルトで保存されます。デバッグログもデフォルトで有効になっていますが、不要な場合はオフにすることができます。

これにより、the ELK stack のような、ログファイルを検査する外部ツールを通じてサーバーを監視できるようになります。

デバッグログは、開発作業や問題の修正に不可欠です。LibreChatの実行中に何らかの問題が発生した場合は、可能な限りその状況を再現し、./api/logs/debug-%DATE%.log にあるログを添えて 問題を報告 してください。

エラーログも同じ場所に保存されます: ./api/logs/error-%DATE%.log。Meilisearchを設定している場合、それ専用のログファイルも別途作成されます。

セットアップ

• 以下の環境変数を使用して、デバッグログの切り替えが可能です。デフォルトでは、この変数を設定しなくてもデバッグログが生成されますが、FALSEに設定することで無効化するオプションがあります。

注: 本番環境ではデバッグログを無効にすることを推奨します。

• コンソール/ターミナルで詳細なサーバー出力を表示するには、以下を TRUE に設定します。

ただし、出力が非常に冗長になる可能性があるため、これは推奨されません。デフォルトでは無効になっており、必要な場合にのみ有効にしてください。

• クラウドデプロイメント（GCPやAWSなど）でコンソールログを扱う際、これを有効にすると、ログがUTCタイムスタンプ付きでJSON形式として出力されます。

デフォルトでは、JSON文字列の長さは255文字に切り詰められます。これは以下の環境変数で設定できます：

• ファイルベースのログ転送はデフォルトで有効になっています。デプロイメントでログをstdout/stderrのみに出力する必要がある場合は、LOG_TO_FILE=false を設定してください。

OpenTelemetry Tracing

LibreChatは、サーバー、データベース、Redis、およびアウトバウンドHTTPの可視化のために、バックエンドのOpenTelemetryトレースを出力できます。Redisコマンドレベルのスパンはオプトイン形式であるため、デフォルトのトレースは高レベルに保たれます。これは、GenAI特有のプロンプトやモデルの可観測性において推奨されるオプションであるLangfuseとは別個のものです。