Definir níveis de registro em tempo de execução
Permita que os clientes aumentem ou reduzam o nível de detalhamento.
Definir níveis de registro em tempo de execução é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Detalhamento sob demanda
Às vezes, o usuário quer registros silenciosos; outras vezes, quer detalhes profundos. O MCP permite que o cliente defina um nível de registro em tempo de execução, sem reiniciar o servidor.
A solicitação setLevel
O cliente envia uma solicitação logging/setLevel indicando o nível mínimo desejado. Como isso é uma solicitação, o servidor responde para confirmar.
{"method": "logging/setLevel",
"params": {"level": "warning"}}Declare a capacidade
Um servidor só recebe setLevel se tiver anunciado a capacidade de logging durante o handshake de inicialização. O FastMCP habilita isso para você.
Um limite, não uma lista
O nível escolhido é um limiar. Defini-lo como warning significa que warning e tudo que for mais grave passará; as mensagens menos importantes serão descartadas.
Como funciona a filtragem
Depois de setLevel, o servidor compara a gravidade de cada registro com o limite. Tudo que estiver abaixo do limiar simplesmente não será enviado a esse cliente.
# floor = warning -> info and debug are droppedAumente o nível
Para depurar uma execução complicada, um cliente pode definir o nível como debug. Agora todas as mensagens, até mesmo os rastreamentos excessivos, são transmitidas de volta para análise.
{"method": "logging/setLevel",
"params": {"level": "debug"}}Reduza o nível
Para uma visão tranquila em produção, defina-o como error. Somente as falhas chegarão, mantendo a tela do usuário livre de mensagens rotineiras.
{"method": "logging/setLevel",
"params": {"level": "error"}}Configuração por sessão
O nível se aplica à sessão desse cliente. Alterá-lo depois apenas move o limite; não é necessária uma nova conexão nem uma recarga.
Um padrão sensato
Antes que qualquer setLevel chegue, o servidor usa seu próprio limite padrão, geralmente info. Sempre registre informações detalhadas e deixe o cliente escolher o que manter.
Por que isso ajuda
Os níveis em tempo de execução significam que você distribui uma única compilação silenciosa por padrão, mas pronta para ficar detalhada assim que um usuário relatar um erro difícil de encontrar.
Combina com seus registros
Esse controle afeta as mesmas chamadas ctx.info e ctx.debug que você escreve. O cliente escolhe o limite; seu código apenas registra nos níveis adequados.
await ctx.debug("seen only when floor is debug")Verificação rápida
Raciocine sobre o que um nível de registro escolhido realmente filtra.
Recapitulação: níveis de registro
Você aprendeu que logging/setLevel define um limite em tempo de execução, como a filtragem descarta mensagens menos importantes e por que isso mantém uma única compilação flexível. Excelente!
Perguntas Frequentes
A aula “Definir níveis de registro em tempo de execução” é grátis?
Sim — o texto completo de “Definir níveis de registro em tempo de execução” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Definir níveis de registro em tempo de execução”?
Permita que os clientes aumentem ou reduzam o nível de detalhamento. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Definir níveis de registro em tempo de execução”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Enviar progresso para tarefas longas
- Lidar com solicitações de cancelamento
- Registro estruturado para o cliente
- Definir níveis de registro em tempo de execução