実行時にログレベルを設定する

ユーザーが静かなログを望むこともあれば、詳しい情報を必要とすることもあります。MCPでは、サーバーを再起動せずに、実行時にクライアントからlog levelを設定できます。

クライアントは、必要とする最低レベルを指定したlogging/setLevelリクエストを送信します。これはリクエストなので、サーバーは確認のために応答します。

サーバーがinitializeハンドシェイク中にlogging機能を通知している場合に限り、setLevelを受信します。FastMCPではこれが自動的に有効になります。

選択したレベルはthresholdです。warningに設定すると、warningとそれより重大なメッセージが通過し、それより静かなメッセージは破棄されます。

setLevelの後、サーバーは各ログの重大度を下限と比較します。belowのメッセージは、そのクライアントには送信されません。

問題の調査が難しい実行をデバッグするには、クライアントがレベルをdebugに設定できます。これで、情報量の多いトレースを含むすべてのメッセージが調査用に送信されます。

本番環境を簡潔に表示するには、errorに設定します。失敗だけが届くため、ユーザーの画面に通常の細かなメッセージが表示されません。

このレベルは、そのクライアントのsessionに適用されます。後から変更しても下限が移動するだけで、新しい接続や再読み込みは必要ありません。

setLevelが届くまでは、サーバー独自のdefaultの下限が使われます。多くの場合はinfoです。常に十分な情報をログに記録し、残す内容はクライアントに選ばせてください。

実行時にレベルを変更できれば、デフォルトでは静かなまま、見つけにくいバグが報告された瞬間にverboseに切り替えられるビルドを1つだけ提供できます。

このダイヤルは、コードに記述したctx.infoやctx.debugの呼び出しを制御します。下限を選ぶのはクライアントであり、コード側は適切なレベルでログを記録するだけです。

logging/setLevelが実行時の下限を設定すること、フィルタリングによってより静かなメッセージが破棄されること、そしてこれにより1つのビルドを柔軟に保てる理由を学びました。すばらしいです。