MCP Academy · Lektion

Log-Level zur Laufzeit festlegen

Lassen Sie Clients die Ausführlichkeit erhöhen oder verringern.

Log-Level zur Laufzeit festlegen ist eine kostenlose MCP Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des MCP Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.

Ausführlichkeit nach Bedarf

Manchmal möchte ein Benutzer wenige Protokolle sehen, manchmal ausführliche Details. MCP ermöglicht es dem Client, die Protokollstufe zur Laufzeit festzulegen, ohne den Server neu zu starten.

Die setLevel-Anfrage

Der Client sendet eine logging/setLevel-Anfrage und gibt die niedrigste gewünschte Stufe an. Da es sich um eine Anfrage handelt, antwortet der Server zur Bestätigung.

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

Die Fähigkeit deklarieren

Ein Server erhält setLevel nur, wenn er während des initialize-Handshakes die logging-Fähigkeit angekündigt hat. FastMCP aktiviert dies für Sie.

Eine Untergrenze, keine Liste

Die gewählte Stufe ist ein Schwellenwert. Wird sie auf warning gesetzt, werden warning und alle schwerwiegenderen Stufen übertragen; weniger wichtige Meldungen werden verworfen.

So funktioniert die Filterung

Nach setLevel vergleicht der Server den Schweregrad jedes Protokolleintrags mit der Untergrenze. Alles, was unterhalb des Schwellenwerts liegt, wird diesem Client einfach nicht gesendet.

# floor = warning  -> info and debug are dropped

Den Regler nach oben drehen

Um einen schwierigen Ablauf zu untersuchen, kann ein Client die Stufe auf debug setzen. Nun werden alle Nachrichten, auch die ausführlichen Ablaufspuren, zur Analyse zurückübertragen.

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

Den Regler nach unten drehen

Für eine übersichtliche Produktionsansicht setzen Sie die Stufe auf error. Es werden nur Fehler übertragen, sodass der Bildschirm des Benutzers frei von routinemäßigen Meldungen bleibt.

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

Einstellung pro Session

Die Stufe gilt für die session dieses Clients. Eine spätere Änderung verschiebt lediglich die Untergrenze; eine neue Verbindung oder ein Neuladen ist nicht erforderlich.

Ein sinnvoller Standardwert

Bevor setLevel eintrifft, verwendet der Server seine eigene Standarduntergrenze, häufig info. Protokollieren Sie immer ausführlich und lassen Sie den Client auswählen, was beibehalten werden soll.

Warum das hilft

Protokollstufen zur Laufzeit bedeuten, dass Sie eine standardmäßig ruhige Version ausliefern können, die sofort ausführlich wird, sobald ein Benutzer einen schwer auffindbaren Fehler meldet.

Funktioniert mit Ihren Protokollen

Dieser Regler steuert dieselben Aufrufe von ctx.info und ctx.debug, die Sie schreiben. Der Client wählt die Untergrenze; Ihr Code protokolliert einfach auf den passenden Stufen.

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

Kurze Überprüfung

Überlegen Sie, welche Meldungen eine gewählte Protokollstufe tatsächlich herausfiltert.

Rückblick: Protokollstufen

Sie haben gelernt, dass logging/setLevel eine Untergrenze zur Laufzeit festlegt, wie die Filterung weniger wichtige Meldungen entfernt und warum dadurch eine Version flexibel bleibt. Hervorragend!

Häufig gestellte Fragen

Ist die Lektion „Log-Level zur Laufzeit festlegen“ kostenlos?

Ja — der vollständige Text von „Log-Level zur Laufzeit festlegen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des MCP Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Log-Level zur Laufzeit festlegen“?

Lassen Sie Clients die Ausführlichkeit erhöhen oder verringern. Du übst MCP Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um MCP Academy zu starten?

Keine Vorkenntnisse erforderlich. MCP Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „Log-Level zur Laufzeit festlegen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser MCP Academy-Lektion Code schreiben und ausführen?

Ja. Jede MCP Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu MCP Academy