Jaunā Pakete Go 1.21 nodrošina strukturētu žurnalizāciju standarta bibliotēkā. Strukturētie žurnāli izmanto atslēgvārdu pāri, lai tos varētu analizēt, filtrēt, meklēt un analizēt ātri un uzticami. Serveriem žurnalizācija ir svarīgs veids, kā izstrādātāji var novērot detalizētu sistēmas uzvedību, un bieži vien pirmā vieta, kur viņi dodas, lai to labotu. log/slog Standarta bibliotēkai bija reģistrācijas pakete, , kopš Go sākotnējā izlaišanas pirms vairāk nekā desmit gadiem. Laika gaitā mēs esam uzzinājuši, ka strukturētā logēšana ir svarīga Go programmētājiem. tā mūsu ikgadējā aptaujā ir konsekventi ieņemusi augstu vietu, un daudzas paketes Go ekosistēmā to nodrošina.Daži no tiem ir diezgan populāri: viens no pirmajiem strukturētajiem logēšanas paketiem Go, , tiek izmantots vairāk nekā 100 000 citos iepakojumos. log Loģistika Ar daudzām strukturētām žurnalizācijas pakotnēm, no kurām izvēlēties, lielās programmas bieži vien galu galā iekļauj vairāk nekā vienu, izmantojot savas atkarības. Galvenajai programmai var būt jākonfigurē katrs no šiem žurnalizācijas pakotnēm tā, lai žurnalizācijas izeja būtu konsekventa: tas viss iet uz to pašu vietu, tajā pašā formātā. Ceļojums no Lāčplēša Lāčplēša Šeit ir vienkāršākā programma, kas izmanto : slog package main

import "log/slog"

func main() {
    slog.Info("hello, world")
}
 No šī raksta tā drukā: 2023/08/04 16:09:19 INFO hello, world
 Tās funkcija drukā ziņojumu Info žurnāla līmenī, izmantojot noklusējuma žurnālistu, kas šajā gadījumā ir noklusējuma žurnālists no pakete – tas pats žurnālists, kuru saņemat, rakstot Tas izskaidro, kāpēc iznākums izskatās tik līdzīgs: tikai “INFO” ir jauns. Un oriģināls Pakete darbojas kopā, lai padarītu to viegli sākt. Info log log.Printf slog log Papildus , ir funkcijas trīs citiem līmeņiem - , un Tāpat kā vispārīgāks funkcija, kas ņem līmeni kā argumentu. , līmeņi ir tikai veseli, tāpēc jūs neesat ierobežots ar četriem nosauktajiem līmeņiem. Tas ir nulle un ir 4, tāpēc, ja jūsu ierakstu sistēmai ir līmenis starp tiem, jūs varat izmantot 2 tam. Info Debug Warn Error Log slog Info Warn Atšķirībā no paketi, mēs varam viegli pievienot atslēgvārdu pāri mūsu iznākumu, rakstot tos pēc ziņojuma: log slog.Info("hello, world", "user", os.Getenv("USER"))
 Tagad produkts izskatās šādi: 2023/08/04 16:27:19 INFO hello, world user=jba
 Kā jau minējām, Top līmeņa funkcijas izmanto noklusējuma žurnālistu.Mēs varam iegūt šo žurnālistu skaidri, un sauc tās metodes: slog logger := slog.Default()
logger.Info("hello, world", "user", os.Getenv("USER"))
 Katra augšējā līmeņa funkcija atbilst metodei uz a Izeja ir tāda pati kā iepriekš. slog.Logger Sākotnēji slog izeja iet cauri noklusējuma Mēs varam mainīt iznākumu, mainot Lietots ar logotipu. Pieejams ar diviem iebūvētiem rokturiem. a Izsūta visu žurnāla informāciju formā Šī programma izveido jaunu žurnālistu, izmantojot Tāpat viņš vērsās pie Metodiskā : log.Logger Darbojas slog TextHandler key=value TextHandler Info logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Tagad iznākums izskatās šādi: time=2023-08-04T16:56:03.786-04:00 level=INFO msg="hello, world" user=jba
 Viss ir pārveidots par atslēgvārdu pāri, ar ķēdēm, kas citētas pēc vajadzības, lai saglabātu struktūru. JSON izejas gadījumā instalējiet iebūvēto Tā vietā: JSONHandler logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Tagad mūsu izeja ir JSON objektu secība, viena uz katru žurnalizācijas zvanu: {"time":"2023-08-04T16:58:02.939245411-04:00","level":"INFO","msg":"hello, world","user":"jba"}
 Jūs neesat ierobežots ar iebūvētajiem manipulatoriem. ikviens var uzrakstīt manipulatoru, ieviešot pārvaldnieks var ģenerēt izeju noteiktā formātā, vai arī tas var iesaiņot citu pārvaldītāju, lai pievienotu funkcionalitāti. Tajā Dokumentācija parāda, kā uzrakstīt iesaiņošanas manipulatoru, kas maina minimālo līmeni, kurā tiks rādīti žurnāla ziņojumi. slog.Handler Piemēri slog Līdz šim izmantoto atribūtu alternatīvā atslēgvārdu sintakse ir ērta, bet biežāk izpildītiem žurnāla izteikumiem var būt efektīvāk izmantot atribūtu Tipisks un zvanīt Metode: Tie darbojas kopā, lai samazinātu atmiņas piešķiršanu. s no ķēdes, cipariem un citiem kopīgiem veidiem. Attr LogAttrs Attr Šis aicinājums Tas rada tādu pašu iznākumu kā iepriekš, bet tas notiek ātrāk: LogAttrs slog.LogAttrs(context.Background(), slog.LevelInfo, "hello, world",
    slog.String("user", os.Getenv("USER")))
 Ir daudz vairāk, lai : slog 
 
 
 
 
 Kā parāda izsaukums uz LogAttrs, kontekstu.Kontekstu var nodot dažām žurnālu funkcijām, lai pārzinis varētu iegūt kontekstuālo informāciju, piemēram, izsekošanas ID. (Konteksta atcelšana neliedz ierakstīt žurnāla ierakstu.) Jūs varat izsaukt Logger.With, lai pievienotu atribūtus žurnālistam, kas parādīsies visā tā iznākumā, efektīvi izskaidrojot vairāku žurnālu paziņojumu kopīgās daļas. Atribūtus var apvienot grupās.Tas var pievienot vairāk struktūras jūsu žurnāla iznākumam un var palīdzēt izjaukt atslēgas, kas citādi būtu identiskas. Varat kontrolēt, kā vērtība parādās žurnālos, nodrošinot tā tipu ar LogValue metodi, ko var izmantot, lai logotu struktūras laukus kā grupu vai rediģētu sensitīvus datus, cita starpā. Labākā vieta, kur uzzināt par visu Tā ir . slog Dokumentācijas pakete Darbība Mēs vēlējāmies lai būtu ātrs. liela mēroga snieguma ieguvumiem, mēs izstrādājām optimizācijas iespējas, lai nodrošinātu optimizāciju; Metode tiek izsaukta katra žurnāla notikuma sākumā, dodot manipulatoram iespēju ātri izlaist nevēlamus žurnāla notikumus. un metodes ļaus operatoram formatēt atribūtus, kas pievienoti ar Šāds iepriekšējs formatējums var nodrošināt ievērojamu paātrinājumu, ja lieli atribūti, piemēram, Tās tiek pievienotas a un pēc tam izmantoti daudzos logging zvanos. slog Tās Handler Enabled WithAttrs WithGroup Logger.With http.Request Logger Lai informētu par mūsu veiktspējas optimizācijas darbu, mēs pētījām tipiskos žurnalizācijas modeļus esošajos atvērtā koda projektos.Mēs konstatējām, ka vairāk nekā 95% pieprasījumu par žurnalizācijas metodēm ietver piecus vai mazāk atribūtus. Pēc tam mēs uzrakstījām kritērijus, kas uztvēra kopīgos gadījumus, un tos izmantoja kā ceļvedi, lai redzētu, kur pagājis laiks. Dizaina process Tās Pakete ir viens no lielākajiem papildinājumiem standarta bibliotēkai kopš Go 1 izlaišanas 2012. gadā. slog Līdz 2022. gada aprīlim mēs apkopojām pietiekami daudz datu, lai pierādītu strukturētas žurnalizācijas nozīmi Go kopienā. Mēs sākām ar to, ka apskatījām, kā tika izstrādāti esošie strukturētie žurnalizācijas pakotnes. Mēs arī izmantojām lielo atvērtā koda Go koda kolekciju, kas tiek glabāta Go moduļa proxy, lai uzzinātu, kā šie pakotnes faktiski tika izmantotas. Tas nekad nav bijis mērķis aizstāt esošos trešo pušu žurnalizācijas paketes.Viņi visi ir labi, ko viņi dara, un aizstājot esošo kodu, kas darbojas labi, reti ir laba izstrādātāja laika izmantošana. , ko sauc par backend interfeisu, Tādā veidā esošie logging pakotnes var runāt ar kopīgu backend, lai pakotnes, kas tos izmanto, var sadarboties bez vajadzības pārrakstīt. , un . Logger Handler Zap ir Loģistika Hokejs Mēs kopīgojām savu sākotnējo dizainu ar Go komandu un citiem izstrādātājiem, kuriem bija plaša pieredze logēšanas jomā. Mēs izdarījām izmaiņas, pamatojoties uz viņu atsauksmēm, un līdz 2022. gada augustam mēs jutām, ka mums ir funkcionāls dizains. Sabiedrība un sākums a lai uzklausītu, ko kopiena bija pateikusi.Atbilde bija entuziasma un lielā mērā pozitīva.Pateicoties pārdomātajiem komentāriem no citu strukturēto žurnālistu pakotņu dizaineriem un lietotājiem, mēs veicām vairākas izmaiņas un pievienojām dažas funkcijas, piemēram, grupas un Mēs mainījām kartēšanu no žurnāla līmeņiem uz veseliem divreiz. Eksperimentālā īstenošana GitHub diskusijas LogValuer Pēc diviem mēnešiem un aptuveni 300 komentāriem mēs jutām, ka esam gatavi reālai Un pavada Priekšlikuma tēma ieguva vairāk nekā 800 komentārus un izraisīja daudzus API un īstenošanas uzlabojumus. : Priekšlikums Dizains Doc context.Context 
 
 
 Sākotnēji API atbalstīja žurnālistu pievienošanu kontekstam. Daudzi domāja, ka tas bija ērts veids, kā viegli pārvietot žurnālistu caur koda līmeņiem, kas par to neuztraucās. Sākotnēji mēs pretojāmies standarta modelim, kas ietver kontekstu kā pirmo argumentu, jo mēs nevēlējāmies, lai katram logēšanas aicinājumam būtu vajadzīgs konteksts, bet galu galā izveidojām divus logēšanas metožu kopumus, vienu ar kontekstu un vienu bez tā. Viena no izmaiņām, ko mēs neesam izmainījuši, ir atribūtu izteiksmes atslēgas un vērtību alternatīvā sintakse: slog.Info("message", "k1", v1, "k2", v2)
 Daudzi spēcīgi uzskatīja, ka šī ir slikta ideja.Viņi atrada grūti lasīt un viegli kļūdīties, izlaižot atslēgu vai vērtību.Viņi dod priekšroku skaidriem atribūtiem, lai izteiktu struktūru: slog.Info("message", slog.Int("k1", v1), slog.String("k2", v2))
 Bet mēs uzskatījām, ka vieglāka sintakse bija svarīga, lai Go būtu viegli un jautri izmantot, it īpaši jauniem Go programmētājiem. , un (Ar savu ) veiksmīgi izmantoja mainīgās atslēgas un vērtības. Mēs pievienojām lai noķertu kopīgas kļūdas, bet nemainīja dizainu. logr go-kit/log zap SugaredLogger Pārbaudiet 2023. gada 15. martā priekšlikums tika pieņemts, bet joprojām bija dažas nelielas neatrisinātas problēmas. Nākamo nedēļu laikā tika ierosinātas un atrisinātas desmit papildu izmaiņas. Projekta īstenošana tika pabeigta kopā ar paketi, lai pārbaudītu apstrādātājus un veterinārārstu pārbaudi par pareizu mainīgo atslēgu un vērtību izmantošanu. log/slog testing/slogtest Un 8. augustā Go 1.21 tika atbrīvots, un Mēs ceram, ka jūs atradīsiet to noderīgu, un tikpat jautri izmantot, kā tas bija veidot. slog Un liels paldies visiem, kas piedalījās diskusijā un priekšlikuma procesā. Un milzīgi. slog Resursi Tās Par to Pakete izskaidro, kā to izmantot un sniedz vairākus piemērus. Dokumentācija log/slog Tās ir papildu resursi, ko nodrošina Go kopiena, tostarp dažādi pārvaldītāji. Wiki lapa Ja vēlaties uzrakstīt manipulatoru, konsultējieties ar . Rakstot rokasgrāmatu Džonata Amsterdama Attēls: Jeff Smith uz Unsplash Džefs Smits Unsplash Šis raksts ir pieejams The Go Blog ar CC BY 4.0 DEED licenci. Blogā Go Blogā Go

Try and Download Go 

Read My Stories

Šis audio ir izveidots stāsta oriģinālvalodā!

Slog tūre: viss, kas jums jāzina par strukturētu logging ar slogu

About Author

KOMENTĀRI

PAKARINĀT TAGUS

ŠIS RAKSTS TIKS PĀRSTRĀDĀTS

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps