Log strutturati ricercabili
Emetta log JSON con correlazione delle richieste.
Log strutturati ricercabili è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 2 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.
Log realmente utilizzabili
I log in testo semplice sono facili da leggere per una persona, ma diventano problematici su larga scala. I log strutturati memorizzano ogni evento come dati, così i computer possono filtrarli e cercarli rapidamente. 🔎
Perché JSON è la scelta migliore
Emetta ogni riga di log come un oggetto JSON. Ogni campo diventa ricercabile, quindi può eseguire query per strumento, stato o durata senza ricorrere a un'analisi del testo fragile.
Anatomia di un evento di log
Un buon evento contiene un timestamp, un livello, un messaggio e campi di contesto. Insieme indicano che cosa è successo, quando e perché.
{"ts": "2026-01-01T10:00:00Z",
"level": "info",
"msg": "tool called",
"tool": "search"}Scelga livelli sensati
Utilizzi i livelli di log con criterio: debug per i dettagli, info per il flusso normale, warning per i problemi, error per i malfunzionamenti. I livelli consentono di aumentare o ridurre il rumore.
Il correlation ID
Assegni a ogni richiesta un correlation ID univoco e lo riporti in ogni log che produce. In questo modo, una sola ricerca restituisce la cronologia completa di una singola chiamata.
Generi un ID
Un UUID è un ottimo correlation ID: è sufficientemente univoco da evitare collisioni tra le richieste.
import uuid
request_id = str(uuid.uuid4())
print(request_id)Scriva su stderr, non su stdout
Attraverso stdio, stdout trasporta il protocollo MCP stesso. Invii sempre i log a stderr, così non corromperanno mai i messaggi JSON-RPC.
Il modulo logging di Python
Il modulo integrato logging di Python offre gratuitamente livelli e handler. Indirizzi un handler verso stderr e avrà già fatto metà del lavoro.
import logging, sys
logging.basicConfig(stream=sys.stderr,
level=logging.INFO)
log = logging.getLogger("mcp")Aggiunga campi, non stringhe
Eviti di inserire i valori nel testo del messaggio. Li passi come campi aggiuntivi, così in seguito ciascuno resterà una propria colonna ricercabile.
log.info("tool finished",
extra={"tool": "search",
"ms": 42})Non registri mai i segreti
I log vengono trasmessi e persistono, quindi oscuri token, chiavi e dati personali prima di scriverli. Un segreto trapelato in un log costituisce una vera violazione della sicurezza. 🔒
Mantenga una riga per ogni evento
Scriva un oggetto JSON per riga. Questo formato delimitato da righe è quello che gli strumenti di raccolta e ricerca dei log si aspettano di acquisire correttamente.
Controllo rapido
C'è un dettaglio che mette in difficoltà molti autori di MCP.
Riepilogo
Ha imparato a scrivere JSON ricercabile: un evento per riga, livelli utili, un correlation ID, segreti oscurati e output su stderr. 📋
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 «Log strutturati ricercabili» è gratuita?
Sì — il testo completo di «Log strutturati ricercabili» è 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 «Log strutturati ricercabili»?
Emetta log JSON con correlazione delle richieste. 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 2 di 4.
Quanto tempo richiede la lezione «Log strutturati ricercabili»?
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
- Che cosa misurare in un server
- Log strutturati ricercabili
- Seguire una chiamata a uno strumento dall'inizio alla fine
- Generare avvisi per errori e abusi