Korištenje knjižnice za prijavu u sustavu Rubin jednostavan je način da pratite kada je nešto loše u vašem kodu. Ako nešto pođe po zlu, detaljni opis točno onoga što se dogodilo dovodi do pogreške može vam uštedjeti sate u pronalaženju buga. Kako se vaši programi povećavaju i složeniji, možda ćete htjeti dodati način pisanja dnevnika. Ruby dolazi s nizom korisnih klase a knjižnice nazvane standardna knjižnica. Među njima je knjižnica sječa koja daje prioritetnu i rotiranu zapisu.
Osnovna upotreba
Budući da knjižnica za prijavu dolazi s Rubyjem, nema potrebe instalirati nikakve dragulje ili druge knjižnice. Da biste započeli koristiti biblioteku zapisnika, jednostavno zahtijevati 'loger' i stvorite novi objekt Logger. Sve poruke napisane objektu Logger bit će upisane u datoteku dnevnika.
#! / usr / bin / env rubin
zahtijevati 'drvosječa'
log = Logger.new ('log.txt')
log.debug "Datoteka dnevnika stvorena"
prioriteti
Svaka poruka dnevnika ima prioritet. Ovi prioriteti pojednostavljuju pretraživanje datoteka dnevnika za ozbiljnim porukama, kao i da li objekt zapisivanja automatski filtrira manje poruka kada nisu potrebne. Možete razmišljati o tome kao da je vaš popis obaveza za dan. Neke stvari apsolutno moraju biti učinjene, neke bi se stvari doista trebale završiti, a neke se mogu odložiti dok ih nemate vremena napraviti.
U prethodnom primjeru prioritet je bio otkloniti neispravnost, što je najmanje važno od svih prioriteta ("odložite dok ne budete imali vremena" na vašem popisu obaveza, ako želite. Prioriteti poruka dnevnika, od najmanje do najvažnijih, su sljedeći: ispravljanje pogrešaka, informacije, upozorenje, greška, i kobno. Za postavljanje razine poruka koje zapisničara trebaju zanemariti, upotrijebite the nivo atribut.
#! / usr / bin / env rubin
zahtijevati 'drvosječa'
log = Logger.new ('log.txt')
log.level = Zapisnik: UPOZORENJE
log.debug "To će se zanemariti"
log.error "Ovo se neće zanemariti"
Možete stvoriti koliko god poruka dnevnika želite i možete zabilježiti svaku sitnicu koja vaš program čini, što prioritete čini izuzetno korisnim. Kada pokrećete svoj program, možete ostaviti razinu zapisnika na nešto poput upozorenja ili pogreške kako biste uhvatili važne stvari. Zatim, kad nešto pođe po zlu, možete spustiti razinu zapisnika (bilo u izvornom kodu ili pomoću prekidača naredbenog retka) da biste dobili više informacija.
rotacija
Biblioteka dnevnika također podržava rotaciju zapisnika. Rotacija dnevnika sprječava prejake zapise i pomaže u pretraživanju starijih dnevnika. Kada je omogućena rotacija dnevnika i zapisnik dosegne određenu veličinu ili određenu starost, biblioteka drvosječa preimenovat će tu datoteku i stvoriti novu datoteku dnevnika. Starije datoteke dnevnika mogu se konfigurirati i tako da se nakon određene dobi izbrišu (ili "ispadnu iz rotacije").
Da biste omogućili rotaciju dnevnika, prijeđite "mjesečno", "tjedno" ili "dnevno" konstruktoru Logger-a. Prema izboru, konstruktoru možete proslijediti maksimalnu veličinu i broj datoteka koje želite zadržati u rotaciji.
#! / usr / bin / env rubin
zahtijevati 'drvosječa'
log = Logger.new ('log.txt', 'dnevno')
log.debug "Jednom kada zapisnik postane barem jedan"
log.debug "dan star, bit će preimenovan i"
log.debug "kreirat će se nova log.txt datoteka."