Establecer niveles de registro en tiempo de ejecución

A veces el usuario quiere registros discretos y otras veces necesita todos los detalles. MCP permite que el cliente establezca un log level durante la ejecución, sin reiniciar el servidor.

El cliente envía una solicitud logging/setLevel indicando el nivel mínimo que desea. Como se trata de una solicitud, el servidor responde para confirmarla.

Un servidor solo recibe setLevel si anunció la capacidad de logging durante el intercambio de initialize. FastMCP la habilita por usted.

El nivel elegido es un threshold. Establecerlo en warning significa que warning y todo lo más grave se enviará; los mensajes menos importantes se descartan.

Después de setLevel, el servidor compara la gravedad de cada registro con el límite. Todo lo que esté below el umbral simplemente no se envía a ese cliente.

Para depurar una ejecución complicada, un cliente puede establecer el nivel en debug. Entonces todos los mensajes, incluso las trazas más abundantes, se transmiten para su inspección.

Para obtener una vista de producción más tranquila, establézcalo en error. Solo llegarán los fallos y la pantalla del usuario quedará libre de mensajes rutinarios.

El nivel se aplica a la session de ese cliente. Cambiarlo después solo modifica el límite; no requiere una conexión nueva ni recargar nada.

Antes de que llegue cualquier setLevel, el servidor utiliza su propio nivel predeterminado, normalmente info. Registre siempre información detallada y deje que el cliente decida qué conservar.

Los niveles en tiempo de ejecución permiten distribuir una única compilación que, de forma predeterminada, genera pocos registros, pero que puede pasar a ser detallada en cuanto un usuario informe de un error difícil de reproducir.

Este control determina qué llamadas a ctx.info y ctx.debug escribe. El cliente elige el nivel mínimo; su código solo registra con niveles adecuados.

Ha aprendido que logging/setLevel establece un nivel mínimo en tiempo de ejecución, cómo el filtrado descarta los mensajes menos importantes y por qué esto mantiene flexible una única compilación. ¡Excelente!