Logger-kirjaston käyttö Rubiini on helppo tapa seurata, kun jokin on mennyt pieleen koodisi kanssa. Kun jokin menee pieleen, yksityiskohtaisen selvityksen tapahtumasta, joka johtaa virheeseen, voi säästää tunteja virheen löytämisessä. Kun ohjelmasi muuttuvat suuremmiksi ja monimutkaisemmiksi, kannattaa ehkä lisätä tapa kirjoittaa lokisanomia. Ruby sisältää useita hyödyllisiä luokat ja kirjastoja, joita kutsutaan vakiokirjastoiksi. Näiden joukossa on puunkorjuukirjasto, joka tarjoaa priorisoidun ja käännetyn puunkorjuun.
Peruskäyttö
Koska hakkurikirjastossa on Ruby, ei tarvitse asentaa mitään helmiä tai muita kirjastoja. Voit aloittaa hakkurikirjaston käytön yksinkertaisesti vaatia 'logger' ja luo uusi Logger-objekti. Kaikki kirjaajaobjektille kirjoitetut viestit kirjoitetaan lokitiedostoon.
#! / usr / bin / env ruby
vaadi 'puunkorjuu'
log = Logger.new ('log.txt')
log.debug "Lokitiedosto luotu"
prioriteetit
Jokaisella lokisanomalla on prioriteetti. Nämä prioriteetit helpottavat lokitiedostojen etsimistä vakavista viesteistä, samoin kuin puunkorjuukohde suodattaa automaattisesti pienemmät viestit, kun niitä ei tarvita. Voit ajatella sitä eräänlaisena kuin päivän tehtäväluettelo. Jotkut asiat on ehdottomasti tehtävä, jotkut asiat todella pitäisi saada aikaan, ja jotkut asiat voidaan lykätä, kunnes sinulla on aikaa tehdä ne.
Edellisessä esimerkissä prioriteetti oli debug, joka on tärkein kaikista painopisteistä (tehtävä lykätä, kunnes sinulla on aikaa) Tehtäväluettelosi, jos haluat). Lokisanoman prioriteetit ovat tärkeimmästä tärkeysjärjestyksessä seuraavat: debug, info, warn, virhe, ja kohtalokasta. Asettaaksesi viestien tason, hakijan tulee sivuuttaa taso määrite.
#! / usr / bin / env ruby
vaadi 'puunkorjuu'
log = Logger.new ('log.txt')
log.level = Logger:: VAROITUS
log.debug "Tätä ei huomioida"
log.error "Tätä ei jätetä huomiotta"
Voit luoda niin monta lokisanomaa kuin haluat ja voit kirjata kaikki pienet pienet asiat, jotka ohjelmasi tekee, mikä tekee prioriteetteista erittäin hyödyllisiä. Kun käytät ohjelmaa, voit jättää hakkuutason jonkin kaltaiselle varoitukselle tai virheelle tärkeiden asioiden saamiseksi. Sitten, kun jokin menee pieleen, voit laskea lokitason tasoa (joko lähdekoodissa tai komentorivikytkimellä) saadaksesi lisätietoja.
Kierto
Logger-kirjasto tukee myös lokin kiertoa. Lokien kierto estää lokien saamasta liian suuriksi ja auttaa etsimään vanhoja lokit. Kun lokin kierto on käytössä ja loki saavuttaa joko tietyn koon tai tietyn iän, hakkurikirjasto nimeää kyseisen tiedoston uudelleen ja luo uuden lokitiedoston. Vanhemmat lokitiedostot voidaan myös määrittää poistamaan (tai "putoamaan kiertämättä") tietyn iän jälkeen.
Jotta lokin kierto sallitaan, siirrä 'kuukausittain', 'viikoittain' tai 'päivittäin' Logger-rakentajalle. Valinnaisesti voit siirtää enimmäiskoko ja tiedostojen lukumäärä pyörittämiseksi rakentajalle.
#! / usr / bin / env ruby
vaadi 'puunkorjuu'
log = Logger.new ('log.txt', 'päivittäin')
log.debug "Kun lokista tulee ainakin yksi"
log.debug "päivän vanha, se nimetään uudelleen ja"
log.debug "Uusi log.txt-tiedosto luodaan."