De nieuwe Het pakket in Go 1.21 brengt gestructureerd loggen naar de standaardbibliotheek. gestructureerde logs gebruiken sleutelwaardeparen, zodat ze snel en betrouwbaar kunnen worden geselecteerd, gefilterd, gezocht en geanalyseerd. Voor servers is loggen een belangrijke manier voor ontwikkelaars om het gedetailleerde gedrag van het systeem te observeren, en vaak de eerste plaats waar ze gaan om het te debuggen. log/slog De standaardbibliotheek heeft een logboekpakket, , sinds de eerste release van Go meer dan een decennium geleden. Na verloop van tijd hebben we geleerd dat gestructureerd loggen belangrijk is voor Go-programmeurs. Het is consequent hoog gerangschikt in onze jaarlijkse enquête en veel pakketten in het Go-ecosysteem bieden het. , wordt gebruikt in meer dan 100.000 andere pakketten. log Logeren Met veel gestructureerde logpakketten om uit te kiezen, zullen grote programma's vaak uiteindelijk meer dan één door hun afhankelijkheden bevatten.Het hoofdprogramma moet misschien elk van deze logpakketten configureren zodat de logoutput consistent is: het gaat allemaal naar dezelfde plaats, in hetzelfde formaat. Door gestructureerd loggen in de standaardbibliotheek op te nemen, kunnen we een gemeenschappelijk kader bieden dat alle andere gestructureerde logpakketten kunnen delen. Een tour van Slag Slag Hier is het eenvoudigste programma dat gebruikt wordt : slog package main

import "log/slog"

func main() {
    slog.Info("hello, world")
}
 Naar aanleiding van dit schrijven drukt het: 2023/08/04 16:09:19 INFO hello, world
 De De functie afdrukt een bericht op het Info-logniveau met behulp van de standaardlogger, die in dit geval de standaardlogger van de pakket – dezelfde logger die je krijgt wanneer je schrijft Dat verklaart waarom de output er zo vergelijkbaar uitziet: alleen de "INFO" is nieuw. En het origineel Het pakket werkt samen om het gemakkelijk te maken om te beginnen. Info log log.Printf slog log Naast , er zijn functies voor drie andere niveaus - - het en Maar ook een meer algemene functie die het niveau als argument inneemt. in , niveaus zijn slechts gehele getallen, dus je bent niet beperkt tot de vier genoemde niveaus. Het is nul en is 4, dus als uw logsysteem een niveau tussen deze heeft, kunt u er 2 voor gebruiken. Info Debug Warn Error Log slog Info Warn In tegenstelling tot de In het pakket kunnen we eenvoudig sleutelwaardeparen toevoegen aan onze output door ze na het bericht te schrijven: log slog.Info("hello, world", "user", os.Getenv("USER"))
 De output ziet er nu zo uit: 2023/08/04 16:27:19 INFO hello, world user=jba
 Zoals ik al zei, De top-level functies gebruiken de standaard logger.We kunnen deze logger expliciet krijgen en de methoden noemen: slog logger := slog.Default()
logger.Info("hello, world", "user", os.Getenv("USER"))
 Elke bovenniveaufunctie komt overeen met een methode op een De output is hetzelfde als voorheen. slog.Logger In eerste instantie gaat de output van slog door de standaard , het produceren van de output die we hierboven hebben gezien. We kunnen de output wijzigen door de gebruikt door de logger. met twee ingebouwde handlers. a Alle log-informatie in het formulier Dit programma maakt een nieuwe logger met een en doet dezelfde oproep aan de De methode: log.Logger Handelen slog TextHandler key=value TextHandler Info logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Nu ziet de output er zo uit: time=2023-08-04T16:56:03.786-04:00 level=INFO msg="hello, world" user=jba
 Alles is omgezet in een sleutel-waardepaar, met strengen geciteerd als nodig om de structuur te behouden. Voor de JSON-uitvoer installeert u de ingebouwde In plaats daarvan: JSONHandler logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Nu is onze output een reeks JSON-objecten, één per loggoproep: {"time":"2023-08-04T16:58:02.939245411-04:00","level":"INFO","msg":"hello, world","user":"jba"}
 Je bent niet beperkt tot de ingebouwde handlers. Iedereen kan een handelaar schrijven door de Een handelaar kan output genereren in een bepaald formaat, of het kan een andere handelaar wikkelen om functionaliteit toe te voegen. In de Documentatie laat zien hoe u een verpakkingsbeheerder schrijft die het minimale niveau wijzigt waarop logberichten worden weergegeven. slog.Handler Voorbeelden slog De alternatieve sleutelwaarde-syntax voor attributen die we tot nu toe hebben gebruikt, is handig, maar voor vaak uitgevoerde logverklaringen kan het efficiënter zijn om de type en bel de methode. Deze werken samen om geheugenallocaties te minimaliseren. s uit strengen, getallen en andere gemeenschappelijke typen. Attr LogAttrs Attr Deze oproep tot produceert dezelfde output als hierboven, maar doet het sneller: LogAttrs slog.LogAttrs(context.Background(), slog.LevelInfo, "hello, world",
    slog.String("user", os.Getenv("USER")))
 Er is veel meer om : slog 
 
 
 
 
 Zoals de oproep naar LogAttrs laat zien, kunt u een context.Context doorgeven aan sommige logfuncties, zodat een handelaar contextuele informatie, zoals trace ID's, kan extraheren. (Het verwijderen van de context voorkomt niet dat de loginvoer wordt geschreven.) U kunt Logger.With bellen om attributen toe te voegen aan een logger die zal verschijnen in al zijn output, effectief factoring uit de gemeenschappelijke delen van verschillende logverklaringen. Dit is niet alleen handig, maar het kan ook prestaties helpen, zoals hieronder besproken. Dit kan meer structuur toevoegen aan uw logout en kan helpen bij het ontrafelen van sleutels die anders identiek zouden zijn. U kunt controleren hoe een waarde in de logboeken wordt weergegeven door het type ervan te verstrekken met een LogValue-methode die kan worden gebruikt om de velden van een struct als een groep te loggen of gevoelige gegevens te bewerken, onder andere. De beste plek om te leren over alle Het is de . slog Pakket documentatie Prestaties We wilden om snel te zijn.Voor grootschalige prestatiewinsten hebben we ontworpen interface om optimalisatiemogelijkheden te bieden. de De methode wordt aan het begin van elk loggebeurtenis genoemd, waardoor de handelaar de kans krijgt om ongewenste loggebeurtenissen snel te laten vallen. en methode laat de handelaar formatteren attributen toegevoegd Deze pre-formatering kan een aanzienlijke versnelling bieden wanneer grote attributen, zoals een , worden toegevoegd aan a en vervolgens gebruikt in veel loggerende oproepen. slog De Handler Enabled WithAttrs WithGroup Logger.With http.Request Logger Om onze prestatieoptimalisatiewerkzaamheden te informeren, hebben we typische logpatronen onderzocht in bestaande open source-projecten.We ontdekten dat meer dan 95% van de oproepen naar logmethoden vijf of minder attributen doorgeven.We hebben ook de typen attributen gecategoriseerd, waarbij we ontdekten dat een handvol gemeenschappelijke typen de meerderheid vertegenwoordigen. We schreven vervolgens benchmarks die de gebruikelijke gevallen vastlegden en gebruikten ze als een gids om te zien waar de tijd is gegaan. Het ontwerpproces De Het pakket is een van de grootste toevoegingen aan de standaardbibliotheek sinds Go 1 in 2012 werd uitgebracht.We wilden onze tijd nemen om het te ontwerpen en we wisten dat feedback van de gemeenschap essentieel zou zijn. slog Tegen april 2022 hadden we voldoende gegevens verzameld om het belang van gestructureerd loggen voor de Go-gemeenschap te demonstreren. We begonnen met het bekijken van hoe de bestaande gestructureerde loggingpakketten werden ontworpen. We maakten ook gebruik van de grote collectie open source Go-code die op de Go-module-proxy is opgeslagen om te leren hoe deze pakketten daadwerkelijk werden gebruikt.Ons eerste ontwerp werd geïnformeerd door dit onderzoek en de geest van eenvoud van Go.We wilden een API die licht op de pagina is en gemakkelijk te begrijpen is, zonder prestaties op te offeren. Het was nooit een doel om bestaande logging pakketten van derden te vervangen. ze zijn allemaal goed in wat ze doen, en het vervangen van bestaande code die goed werkt is zelden een goed gebruik van de tijd van een ontwikkelaar. , dat een backend interface noemt, Op deze manier kunnen bestaande loggingpakketten met een gemeenschappelijke backend praten, zodat de pakketten die ze gebruiken, kunnen samenwerken zonder dat ze opnieuw moeten worden geschreven. - het en . Logger Handler De Zap Logeren Hclog We hebben ons oorspronkelijke ontwerp gedeeld binnen het Go-team en andere ontwikkelaars die uitgebreide ervaring hadden met loggen. We hebben wijzigingen gemaakt op basis van hun feedback en in augustus 2022 voelden we dat we een haalbaar ontwerp hadden. publiek en begon een De reactie was enthousiast en grotendeels positief.Dankzij inzichtelijke opmerkingen van de ontwerpers en gebruikers van andere gestructureerde logging pakketten hebben we verschillende wijzigingen gemaakt en een paar functies toegevoegd, zoals groepen en de We hebben de mapping twee keer veranderd van logniveaus naar integers. Experimentele implementatie GitHub discussie LogValuer Na twee maanden en ongeveer 300 opmerkingen voelden we ons klaar voor een echte en begeleiden Het onderwerp van het voorstel verzamelde meer dan 800 opmerkingen en resulteerde in veel verbeteringen van de API en de implementatie. : voorstel Ontwerp doc context.Context 
 
 
 Oorspronkelijk ondersteunde de API het toevoegen van loggers aan een context. Velen vonden dat dit een handige manier was om een logger gemakkelijk door niveaus van code te leiden die er niet om gingen. Maar anderen vonden dat het smokkelde in een impliciete afhankelijkheid, waardoor de code moeilijker werd begrepen. We weigerden in eerste instantie het standaardpatroon van het doorgeven van de context als het eerste argument omdat we niet wilden dat elke log-oproep een context vereiste, maar uiteindelijk twee sets log-methoden creëerden, een met een context en een zonder. Een wijziging die we niet maakten, was de alternatieve sleutel-en-waarde-syntax voor het uiten van attributen: slog.Info("message", "k1", v1, "k2", v2)
 Velen voelden sterk dat dit een slecht idee was. Ze vonden het moeilijk om te lezen en gemakkelijk om verkeerd te raken door een sleutel of waarde te omzeilen. slog.Info("message", slog.Int("k1", v1), slog.String("k2", v2))
 Maar we vonden dat de lichtere syntax belangrijk was om Go gemakkelijk en leuk te gebruiken, vooral voor nieuwe Go-programmeurs. - het en (met zijn ) met succes gebruikte alternatieve sleutels en waarden. we voegden een om gemeenschappelijke fouten te vangen, maar veranderde het ontwerp niet. logr go-kit/log zap SugaredLogger Zie check Op 15 maart 2023 werd het voorstel geaccepteerd, maar er waren nog enkele kleine onopgeloste kwesties.In de komende weken werden tien extra wijzigingen voorgesteld en opgelost. De uitvoering van het pakket was compleet, samen met de pakket voor het verifiëren van behandelaars en de veterinaire controle op het juiste gebruik van alternatieve sleutels en waarden. log/slog testing/slogtest En op 8 augustus werd Go 1.21 vrijgegeven, en We hopen dat je het nuttig vindt, en zo leuk om te gebruiken als het was om te bouwen. slog En een grote dank aan iedereen die deelnam aan de discussie en het voorstelproces. Onmiskenbaar wel. slog middelen De Voor de Het pakket legt uit hoe het moet worden gebruikt en geeft een aantal voorbeelden. Documentatie log/slog De heeft aanvullende middelen die door de Go-gemeenschap worden geleverd, waaronder een verscheidenheid aan managers. Wiki pagina Als u een handelaar wilt schrijven, raadpleeg dan de . Handelen met schrijven gids door Jonathan Amsterdam Foto van Jeff Smith op Unsplash Jeff Smith Unsplash Dit artikel is beschikbaar op The Go Blog onder een CC BY 4.0 DEED licentie. De Go Blog De Go Blog

Try and Download Go 

Read My Stories

Deze audio wordt geproduceerd in de originele taal van het verhaal!

Te lang; Lezen

Make resilience your competitive advantage

A Tour of Slog: Alles wat je moet weten over gestructureerd loggen met Slog

About Author

OPMERKINGEN

LABELS

DIT ARTIKEL WERD GEPRESENTEERD IN

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps