メインコンテンツまでスキップ

MCP ログについて

このドキュメントは、Ateliers.Ai.Mcp におけるログの概要を説明します。

1. ログの目的​

MCP のログは、主に以下の目的で使用されます：

  • 実行状態の観測（Observability）: MCP の動作状況を把握し、問題の早期発見と解決を支援します。
  • デバッグ支援: 開発中および運用中の問題解決のための情報を提供します。
  • 監査とトレーサビリティ: 重要な操作やイベントの記録を保持し、後で参照できるようにします。
  • パフォーマンス分析: システムのパフォーマンスを評価し、最適化のためのデータを提供します。

2. ログの種類​

MCP では、以下の種類のログが生成されます：

  • 実行ログ（Process Log）: MCP の通常の動作に関する情報を記録します。例：処理の開始・終了、主要な状態変化など。
  • エラーログ（Error Log）: エラーや例外に関する情報を記録します。例：操作失敗、例外発生など。
  • トレースログ（Trace Log）: 詳細なデバッグ情報を記録します。例：LLM の思考過程、内部状態など。

3. ログの管理​

MCP のログは、適切に管理されるように設計されています。具体的には以下の方針に従います：

  • ログレベルの設定: ログの重要度に応じて、適切なログレベル（Trace、Debug、Info、Warn、Error、Critical）を使用します。
  • ログの保持期間: ログは無期限に保持されず、カテゴリごとに定められた保持期間に基づいて管理されます。
  • ログの保存場所: ログは指定されたディレクトリに保存され、必要に応じて整理・削除されます。
  • ログのフォーマット: ログは一貫したフォーマットで記録され、解析や検索が容易になるようにします。