Настройка уровней журналирования во время работы

Иногда пользователю нужен тихий журнал, а иногда — подробные сведения. MCP позволяет клиенту менять уровень журнала во время работы, не перезапуская сервер.

Клиент отправляет запрос logging/setLevel, указывая самый низкий нужный ему уровень. Это запрос, поэтому сервер отвечает, подтверждая его получение.

Сервер получает setLevel только в том случае, если во время рукопожатия инициализации объявил возможность журналирования. FastMCP включает её за Вас.

Выбранный уровень — это порог. Если установить его равным warning, будут передаваться warning и все более серьёзные сообщения, а менее важные — отбрасываться.

После setLevel сервер сравнивает важность каждой записи журнала с порогом. Всё, что находится ниже порога, просто не отправляется этому клиенту.

Чтобы исследовать сложный запуск, клиент может установить уровень debug. Теперь для проверки будут передаваться все сообщения, включая многословные трассировки.

Для спокойного рабочего режима установите уровень error. Будут поступать только сбои, и экран пользователя не будет загромождён обычными сообщениями.

Уровень действует в рамках сеанса этого клиента. Последующее изменение лишь перемещает порог; новое соединение или перезагрузка не требуются.

До получения setLevel сервер использует собственный порог по умолчанию, часто info. Всегда записывайте подробные сведения, а клиенту позволяйте выбирать, что оставить.

Уровни, меняемые во время работы, позволяют выпускать одну сборку, которая по умолчанию работает тихо, но готова перейти в подробный режим, как только пользователь сообщит о трудно обнаруживаемой ошибке.

Этот регулятор управляет теми же вызовами ctx.info и ctx.debug, которые Вы пишете. Клиент выбирает порог, а Ваш код просто записывает сообщения с честно выбранными уровнями.

Вы узнали, что logging/setLevel задаёт порог во время работы, как фильтрация отбрасывает менее важные сообщения и почему благодаря этому одна сборка остаётся гибкой. Превосходно!