MCP Academy · Lezione

Impostare i livelli di log in esecuzione

Permetta ai client di aumentare o ridurre il livello di dettaglio.

Lezione 4 di 413 passaggi

Impostare i livelli di log in esecuzione è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.

Dettagli su richiesta

A volte un utente desidera log ridotti, altre volte dettagli approfonditi. MCP consente al client di impostare un livello di log durante l'esecuzione, senza riavviare il server.

La richiesta setLevel

Il client invia una richiesta logging/setLevel indicando il livello minimo desiderato. Poiché si tratta di una richiesta, il server risponde per confermare.

{"method": "logging/setLevel",
 "params": {"level": "warning"}}

Dichiarare la capability

Un server riceve setLevel solo se ha dichiarato la capability logging durante l'handshake di inizializzazione. FastMCP la abilita automaticamente.

Una soglia, non un elenco

Il livello scelto è una soglia. Impostarlo su warning significa consentire warning e tutti i livelli più gravi; i messaggi meno importanti vengono scartati.

Come funziona il filtraggio

Dopo setLevel, il server confronta la gravità di ogni log con la soglia. Qualsiasi messaggio inferiore alla soglia non viene semplicemente inviato a quel client.

# floor = warning  -> info and debug are dropped

Alzare il livello

Per eseguire il debug di un'esecuzione complessa, un client può impostare il livello su debug. A quel punto ogni messaggio, comprese le tracce più rumorose, viene trasmesso per l'ispezione.

{"method": "logging/setLevel",
 "params": {"level": "debug"}}

Abbassare il livello

Per una visualizzazione ordinata in produzione, lo imposti su error. Arrivano solo gli errori, mantenendo lo schermo dell'utente libero dai messaggi ordinari.

{"method": "logging/setLevel",
 "params": {"level": "error"}}

Impostazione per sessione

Il livello si applica alla sessione di quel client. Modificarlo in seguito sposta semplicemente la soglia; non servono una nuova connessione o un ricaricamento.

Un valore predefinito sensato

Prima dell'arrivo di qualsiasi setLevel, il server usa la propria soglia predefinita, spesso info. Registri sempre informazioni dettagliate e lasci al client la scelta di cosa conservare.

Perché è utile

I livelli impostabili durante l'esecuzione consentono di distribuire una sola build, silenziosa per impostazione predefinita ma pronta a diventare verbosa non appena un utente segnala un bug difficile da individuare.

Si applica ai Suoi log

Questa manopola controlla le stesse chiamate a ctx.info e ctx.debug che scrive. Il client sceglie la soglia; il codice registra semplicemente i messaggi al livello corretto.

await ctx.debug("seen only when floor is debug")

Verifica rapida

Ragioni su quali messaggi venga effettivamente filtrati da un determinato livello di log.

Riepilogo: livelli di log

Ha imparato che logging/setLevel imposta una soglia durante l'esecuzione, come il filtraggio elimina i messaggi meno importanti e perché questo mantiene flessibile un'unica build. Eccellente!

Gratis per iniziare

Impara Python con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
30
Lezioni
120

Domande Frequenti

La lezione «Impostare i livelli di log in esecuzione» è gratuita?

Sì — il testo completo di «Impostare i livelli di log in esecuzione» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.

Cosa imparerò in «Impostare i livelli di log in esecuzione»?

Permetta ai client di aumentare o ridurre il livello di dettaglio. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare MCP Academy?

Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Impostare i livelli di log in esecuzione»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione MCP Academy?

Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Inviare l'avanzamento delle attività lunghe
  2. Gestire le richieste di annullamento
  3. Logging strutturato verso il client
  4. Impostare i livelli di log in esecuzione
← Torna a MCP Academy