Rakenteinen lokitus asiakkaalle
Lähettäkää tasokohtaisia lokiviestejä protokollan kautta.
Rakenteinen lokitus asiakkaalle on ilmainen MCP Academy-oppitunti CoddyKitissä. Tämä on oppitunti 3/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu MCP Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. MCP Academy-kurssilla on yhteensä 4 oppituntia.
Lokit, jotka asiakas näkee
Päätelaitteeseen tulostaminen auttaa vain teitä. MCP:n avulla palvelin voi lähettää lokiviestejä protokollan kautta, jotta myös isäntäsovellus voi näyttää ne.
Viestin notification
Lokit kulkevat notifications/message-notification-viestinä. Se sisältää tason, valinnaisen kirjaajan nimen ja tallennettavat tiedot.
{"method": "notifications/message",
"params": {"level": "info", "data": "Indexing started"}}Käyttäkää Context-objektia
Työkalun sisältä lokikirjausta käytetään Context-objektin kautta. Se on sama kahva, jota käytitte edistymisen ilmoittamiseen. Lisäasetuksia ei tarvita.
from mcp.server.fastmcp import Contextctx.info päivityksille
Yleisin apumetodi on ctx.info. Käyttäkää sitä tavallisiin, odotettuihin tilaviesteihin, jotka auttavat käyttäjää seuraamaan työkalun toimintaa.
await ctx.info("Loaded 120 records from disk")ctx.debug yksityiskohtiin
Käyttäkää ctx.debug-metodia, kun tarvitsette yksityiskohtaisia jäljitystietoja, kuten jäsennetyn arvon tai valitun haaran, jotka olisivat normaalikäytössä häiritseviä.
await ctx.debug(f"chosen strategy = {strategy}")ctx.warning yllätyksille
Käyttäkää ctx.warning-metodia, kun jokin on pielessä mutta tilanteesta voidaan palautua, esimerkiksi kun puuttuva valinnainen kenttä täytetään oletusarvolla.
await ctx.warning("timeout missing, using 30s default")ctx.error virheille
Kutsukaa ctx.error-metodia todellisissa ongelmatilanteissa. Se kertoo asiakkaalle vaiheen epäonnistuneen, mutta ei lopeta kutsua poikkeuksen nostamisen tavoin.
await ctx.error("upstream API returned 503")Vakiomuotoiset vakavuustasot
MCP noudattaa tuttua syslog-asteikkoa: debug, info, notice, warning, error, critical ja sitä korkeammat tasot. Asiakkaat voivat lajitella ja värittää viestejä tason mukaan.
Nimetkää logger
Monet apumetodit hyväksyvät logger-nimen, jotta viestit voidaan ryhmitellä komponentin mukaan, kuten Pythonin vakiomuotoinen logging-moduuli tekee.
await ctx.info("cache miss", logger="db")Älkää koskaan lokittako salaisuuksia
Lokiviestit poistuvat prosessistanne ja saapuvat asiakkaalle, joten käsitelkää niitä näkyvinä tietoina. Älkää koskaan kirjoittako salaisuuksia, kuten tokeneita tai salasanoja, lokiin.
Lokit ovat notification-viestejä
Edistymisilmoitusten tavoin jokainen loki on notification, joten se ei koskaan estä työkalua eikä odota vastausta. Voitte kirjata viestejä vapaasti työn edetessä.
await ctx.info("step 1 done")
await ctx.info("step 2 done")Pikatarkistus
Valitkaa oikea apumetodi tavallisiin tilapäivityksiin.
Kertaus: Lokikirjaus
Osaatte nyt lähettää tasokohtaisia lokeja metodeilla ctx.info, debug, warning ja error, nimetä loggerit ja pitää salaisuudet poissa lokeista. Hieno edistysaskel!
Opi Python tekoälytuutorin avulla — ilmaiseksi
Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.
- Kurssit
- 30
- Oppitunnit
- 120
Usein kysytyt kysymykset
Onko oppitunti ”Rakenteinen lokitus asiakkaalle” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa MCP Academy-oppimispolun 3 oppituntia, myös oppitunnin “Rakenteinen lokitus asiakkaalle”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. MCP Academy-kurssilla on yhteensä 4 oppituntia.
Mitä opin oppitunnilla ”Rakenteinen lokitus asiakkaalle”?
Lähettäkää tasokohtaisia lokiviestejä protokollan kautta. Harjoittelet MCP Academy-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.
Tarvitsenko kokemusta aloittaakseni MCP Academy-opiskelun?
Aiempi kokemus ei ole tarpeen. CoddyKitin MCP Academy-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.
Kuinka kauan ”Rakenteinen lokitus asiakkaalle”-oppitunnin suorittaminen kestää?
Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.
Voinko kirjoittaa ja suorittaa koodia tällä MCP Academy-oppitunnilla?
Kyllä. Jokainen MCP Academy-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.
Kaikki tämän kurssin oppitunnit
- Edistymisen lähettäminen pitkäkestoisissa tehtävissä
- Peruutuspyyntöjen käsittely
- Rakenteinen lokitus asiakkaalle
- Lokitasojen määrittäminen ajon aikana