e re Paketa në Go 1.21 sjell regjistrimin e strukturuar në bibliotekën standarde. Regjistrimet e strukturuara përdorin çifte të vlerave kyçe në mënyrë që ato të mund të analizohen, të filtrohen, të kërkohen dhe të analizohen shpejt dhe në mënyrë të besueshme. Për serverat, regjistrimi është një mënyrë e rëndësishme për zhvilluesit për të vëzhguar sjelljen e detajuar të sistemit, dhe shpesh vendi i parë që ata shkojnë për të debuguar atë. log/slog Biblioteka standarde ka pasur një paketë logging, , që nga lëshimi i parë i Go më shumë se një dekadë më parë. Me kalimin e kohës, ne kemi mësuar se logging strukturuar është e rëndësishme për programuesit Go. Ajo ka renditur vazhdimisht të lartë në sondazhin tonë vjetor, dhe shumë paketa në ekosistemin Go ofrojnë atë. Disa prej tyre janë mjaft popullore: një nga paketat e para të strukturuar logging për Go, , përdoret në më shumë se 100,000 paketa të tjera. log të arritura Me shumë paketa të rregjistrimit të strukturuar për të zgjedhur, programet e mëdha shpesh përfundojnë duke përfshirë më shumë se një përmes varësive të tyre. Programi kryesor mund të duhet të konfigurojë secilin nga këto paketa të rregjistrimit në mënyrë që prodhimi i regjistrimit të jetë i qëndrueshëm: të gjitha shkojnë në të njëjtin vend, në të njëjtin format. Një turne i slog Rrahje Këtu është programi më i thjeshtë që përdor : slog package main

import "log/slog"

func main() {
    slog.Info("hello, world")
}
 Nga ky shkrim, ai shtypi: 2023/08/04 16:09:19 INFO hello, world
 të Funksioni shtyp një mesazh në nivelin e regjistrimit të informacionit duke përdorur regjistrimin default, i cili në këtë rast është regjistrimi default nga paketë – i njëjti logger që merrni kur shkruani Kjo shpjegon pse rezultati duket aq i ngjashëm: vetëm "INFO" është i ri. dhe origjinali Paketa punon së bashku për ta bërë të lehtë për të filluar. Info log log.Printf slog log Përveç , ka funksione për tre nivele të tjera - të dhe Si dhe një më të përgjithshme funksion që merr nivelin si një argument. në , nivelet janë vetëm të plota, kështu që ju nuk jeni i kufizuar në katër nivelet e emëruara. është zero dhe është 4, kështu që nëse sistemi juaj i regjistrimit ka një nivel mes tyre, ju mund të përdorni 2 për të. Info Debug Warn Error Log slog Info Warn Ndryshe nga paketa, ne lehtë mund të shtojmë çifte me vlerë kyçe në prodhimin tonë duke i shkruar ato pas mesazhit: log slog.Info("hello, world", "user", os.Getenv("USER"))
 Produkti tani duket kështu: 2023/08/04 16:27:19 INFO hello, world user=jba
 Siç kemi përmendur, Funksionet e nivelit të lartë përdorin regjistruesin e parazgjedhur.Ne mund ta marrim këtë regjistrues në mënyrë eksplicite dhe t'i quajmë metodat e tij: slog logger := slog.Default()
logger.Info("hello, world", "user", os.Getenv("USER"))
 Çdo funksion i nivelit të lartë korrespondon me një metodë në Produkti është i njëjtë si më parë. slog.Logger Fillimisht, prodhimi i slog-it kalon nëpër default , duke prodhuar prodhimin që kemi parë më lart. Ne mund të ndryshojmë prodhimin duke ndryshuar përdorur nga logjistiku. Në dispozicion janë dy pajisje të integruara. a. Shkarkoni të gjitha informacionet në formë Ky program krijon një logger të ri duke përdorur një Kërkoni të njëjtën gjë për Metodë : log.Logger Tregojnë slog TextHandler key=value TextHandler Info logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Tani prodhimi duket kështu: time=2023-08-04T16:56:03.786-04:00 level=INFO msg="hello, world" user=jba
 Çdo gjë është shndërruar në një palë çelësash me vlera, me zinxhirë të cituara sipas nevojës për të ruajtur strukturën. Për nxjerrjen JSON, instaloni të integruar Në vend të: JSONHandler logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Tani prodhimi ynë është një sekuencë e objekteve JSON, një për thirrje logging: {"time":"2023-08-04T16:58:02.939245411-04:00","level":"INFO","msg":"hello, world","user":"jba"}
 Ju nuk jeni i kufizuar në trajtuesit e integruar. Çdokush mund të shkruajë një trajtues duke zbatuar Një operator mund të gjenerojë output në një format të caktuar, ose mund të mbështjellë një tjetër operator për të shtuar funksionalitet. Në të Dokumentacioni tregon se si të shkruani një manipulues të mbështjelljes që ndryshon nivelin minimal në të cilin do të shfaqen mesazhet e ditarit. slog.Handler shembujt slog Sinteza e alternuar e vlerave kyçe për atributet që kemi përdorur deri më tani është e përshtatshme, por për deklaratat e regjistrit të ekzekutuara shpesh mund të jetë më efikase për të përdorur Lloji dhe thirrja e metodë. Këto punojnë së bashku për të minimizuar alokimet e kujtesës. Ka funksione për ndërtimin e s nga zinxhirët, numrat dhe llojet e tjera të zakonshme. Attr LogAttrs Attr Ky thirrje për prodhon të njëjtin rezultat si më sipër, por e bën atë më të shpejtë: LogAttrs slog.LogAttrs(context.Background(), slog.LevelInfo, "hello, world",
    slog.String("user", os.Getenv("USER")))
 Ka shumë më tepër për : slog 
 
 
 
 
 Siç tregon thirrja për LogAttrs, ju mund të kaloni një kontekst.Context në disa funksione log në mënyrë që një manipulues mund të nxjerrë informacionin kontekst si ID gjurmë. (Anulimi i kontekstit nuk e pengon hyrjen e logut nga të shkruhet.) Ju mund të telefononi Logger.With për të shtuar atributet në një logger që do të shfaqet në të gjithë prodhimin e saj, duke llogaritur në mënyrë efektive pjesët e përbashkëta të deklaratave të disa log. Kjo nuk është vetëm e përshtatshme, por gjithashtu mund të ndihmojë performancën, siç diskutohet më poshtë. Kjo mund të shtojë më shumë strukturë në prodhimin tuaj të ditarit dhe mund të ndihmojë në zhbllokimin e çelësave që do të ishin ndryshe identike. Ju mund të kontrolloni se si një vlerë shfaqet në logs duke siguruar llojin e saj me një metodë LogValue. që mund të përdoret për të regjistruar fushat e një strukturë si një grup ose për të redaktuar të dhëna të ndjeshme, ndër të tjera. Vendi më i mirë për të mësuar për të gjitha Është e . slog Dokumentacioni i paketës Performancë Ne duam Për përmirësimin e performancës në shkallë të gjerë, ne kemi projektuar Interface për të ofruar mundësi optimizimi. Metoda është quajtur në fillim të çdo ngjarje log, duke i dhënë trajtuesit një shans për të hedhur ngjarjet e padëshiruara log shpejt. dhe Metodat lejojnë formatimin e formatimit të atributeve të shtuara nga Kjo para-formatim mund të sigurojë një përshpejtim të konsiderueshëm kur atributet e mëdha, të tilla si një janë shtuar në a dhe pastaj përdoret në shumë thirrje logging. slog të Handler Enabled WithAttrs WithGroup Logger.With http.Request Logger Për të informuar punën tonë të optimizimit të performancës, ne hetuam modelet tipike të logimit në projektet ekzistuese me burim të hapur. Ne gjetëm se mbi 95% e thirrjeve për metodat e logimit kalojnë pesë ose më pak atribute. Pastaj kemi shkruar kritere që kapën rastet e zakonshme, dhe i kemi përdorur ato si një udhëzues për të parë se ku ka shkuar koha. Procesi i projektimit të paketa është një nga shtesat më të mëdha në bibliotekën standarde që kur u lirua Go 1 në vitin 2012.Ne donim të merrnim kohën tonë duke e hartuar atë, dhe e dinim se reagimet e komunitetit do të ishin thelbësore. slog Deri në prill të vitit 2022, ne kishim mbledhur të dhëna të mjaftueshme për të demonstruar rëndësinë e regjistrimit të strukturuar për komunitetin Go. Ne filluam duke parë se si ishin projektuar paketat ekzistuese të logimit të strukturuar. Ne gjithashtu përfituam nga koleksioni i madh i kodit Go me burim të hapur i ruajtur në proxy-in e modulit Go për të mësuar se si këto paketa ishin përdorur në të vërtetë. Dizajni ynë i parë u informua nga ky hulumtim si dhe fryma e thjeshtësisë së Go. Ne donim një API që është e lehtë në faqe dhe e lehtë për t'u kuptuar, pa sakrifikuar performancën. Ata janë të gjithë të mirë në atë që bëjnë, dhe zëvendësimi i kodit ekzistues që punon mirë rrallë është një përdorim i mirë i kohës së një zhvilluesi. , që quhet një ndërfaqe backend, Në këtë mënyrë, paketat ekzistuese të logimit mund të flasin me një backend të përbashkët, kështu që paketat që i përdorin ato mund të ndërveprojnë pa pasur nevojë të rishkruhen. të dhe . Logger Handler Zapatë logjika Kërçovë Ne kemi ndarë dizajnin tonë fillestar brenda ekipit të Go dhe zhvilluesve të tjerë që kishin përvojë të gjerë në logging. Ne bëmë ndryshime bazuar në reagimet e tyre, dhe deri në gusht të vitit 2022 ne ndjehemi se kemi një dizajn të realizueshëm. publik dhe filloi një Përgjigja ishte entuziaste dhe kryesisht pozitive. Falë komenteve të kuptueshme nga projektuesit dhe përdoruesit e paketave të tjera të logimit të strukturuar, ne bëmë disa ndryshime dhe shtuam disa karakteristika, si grupet dhe Ne kemi ndryshuar hartimin nga nivelet e ditarit në integers dy herë. Zbatimi eksperimental Bisedë GitHub LogValuer Pas dy muajsh dhe rreth 300 komenteve, ne ndjehemi të gatshëm për një dhe shoqëruese Pjesa e propozimit mblodhi mbi 800 komente dhe rezultoi në shumë përmirësime në API dhe zbatimin. : Propozimi Dizajni doc context.Context 
 
 
 Fillimisht API mbështeti shtimin e loggers në një kontekst. Shumë mendonin se kjo ishte një mënyrë e përshtatshme për të plumb një logger lehtë përmes niveleve të kodit që nuk kujdeseshin për të. por të tjerët mendonin se ishte kontrabandë në një varësi të nënkuptuar, duke e bërë kodin më të vështirë për të kuptuar. Ne fillimisht u kundërshtuam modelit standard të kalimit të kontekstit si argumenti i parë sepse ne nuk donim që çdo thirrje për të regjistruar të kërkonte një kontekst, por në fund të fundit krijuam dy grupe metodash të regjistruar, një me kontekst dhe një pa. Një ndryshim që nuk e kemi bërë është sintazia alternative e çelësave dhe vlerave për të shprehur atributet: slog.Info("message", "k1", v1, "k2", v2)
 Shumë e ndjenin me forcë se kjo ishte një ide e keqe.Ata e gjetën të vështirë për të lexuar dhe të lehtë për të marrë gabim duke lënë pas një çelës ose vlerë.Ata preferuan atributet e qarta për të shprehur strukturën: slog.Info("message", slog.Int("k1", v1), slog.String("k2", v2))
 Por ne menduam se sintazia më e lehtë ishte e rëndësishme për të mbajtur Go të lehtë dhe argëtuese për t'u përdorur, veçanërisht për programuesit e rinj Go. të dhe (Me të ) përdorur me sukses çelësat dhe vlerat alternative. Ne shtuam një për të kapur gabimet e zakonshme, por nuk ndryshoi dizajnin. logr go-kit/log zap SugaredLogger Të kontrollojë Më 15 mars 2023, propozimi u pranua, por ende kishte disa çështje të vogla të pazgjidhura.Gjatë javëve të ardhshme, dhjetë ndryshime shtesë u propozuan dhe u zgjidhën. Projekti ishte i plotë, së bashku me paketë për verifikimin e trajtuesve dhe kontrollin veterinar për përdorimin e saktë të çelësave dhe vlerave alternative. log/slog testing/slogtest Dhe më 8 gusht, Go 1.21 u lirua, dhe Ne shpresojmë që ju të gjeni atë të dobishme, dhe si argëtim për të përdorur si ajo ishte për të ndërtuar. slog Dhe një falënderim të madh për të gjithë ata që morën pjesë në diskutim dhe procesin e propozimit. kontributi juaj u përmirësua E jashtëzakonshme slog Burimet të Për të Paketa shpjegon se si ta përdorni atë dhe jep disa shembuj. Dokumentacioni log/slog të ka burime shtesë të ofruara nga komuniteti Go, duke përfshirë një shumëllojshmëri të trajtuesve. Faqe Wiki Nëse doni të shkruani një menaxher, konsultohuni me . Menaxher për të shkruar nga Jonathan Amsterdam Foto nga Jeff Smith në Unsplash Jeff Smithi Unsplashë Ky artikull është në dispozicion në The Go Blog nën një licencë CC BY 4.0 DEED. Blog për të shkuar Blog për të shkuar

Try and Download Go 

Read My Stories

Kjo audio është prodhuar në gjuhën origjinale të tregimit!

Një turne i Slog: Çdo gjë që duhet të dini për logging strukturuar me Slog

About Author

KOMENTE

VARUR TAGS

KY ARTIKU U PARAQIT NË

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps