Struktureret logning til klienten

Inde fra et værktøj får du adgang til logning via Context-objektet, det samme håndtag som du brugte til status. Der kræves ingen ekstra opsætning.

Den mest almindelige hjælper er ctx.info. Brug den til normale, forventede statusmeddelelser, som hjælper en bruger med at følge værktøjets arbejde.

Brug ctx.debug, når du vil have detaljerede spor, f.eks. en fortolket værdi eller en valgt gren, som ellers støjer i daglig brug.

Brug ctx.warning, når noget er forkert, men kan håndteres, f.eks. et manglende valgfrit felt, som du udfyldte med en standardværdi.

Kald ctx.error ved reelle problemer. Den fortæller klienten, at et trin mislykkedes, uden at rejse en undtagelse, der afslutter kaldet.

MCP følger den velkendte syslog-skala: fejlfinding, information, bemærkning, advarsel, fejl, kritisk og højere. Klienter kan sortere og farvelægge efter niveau.

Mange hjælpere accepterer et loggørnavn, så meddelelser kan grupperes efter komponent, ligesom Pythons standardmodul til logning gør.

Logmeddelelser forlader din proces og når klienten, så behandl dem som synlige. Skriv aldrig hemmeligheder som tokens eller adgangskoder i en log.

Ligesom status er hver log en notifikation, så den blokerer aldrig dit værktøj og forventer ikke et svar. Du kan logge frit, mens arbejdet udfolder sig.

Du kan nu udsende logge på forskellige niveauer med ctx.info, fejlfinding, advarsel og fejl, navngive dine loggøre og holde hemmeligheder ude. Det går rigtig godt!