Χρησιμοποιώντας τη βιβλιοθήκη καταγραφέα στο Ρουμπίνι είναι ένας εύκολος τρόπος για να παρακολουθείτε πότε κάτι έχει πάει στραβά με τον κώδικα σας. Όταν κάτι πάει στραβά, έχοντας έναν λεπτομερή απολογισμό του τι ακριβώς συνέβη, οδηγώντας στο σφάλμα, μπορεί να σας εξοικονομήσει ώρες για να εντοπίσετε το σφάλμα. Καθώς τα προγράμματά σας γίνονται μεγαλύτερα και πιο περίπλοκα, ίσως θέλετε να προσθέσετε έναν τρόπο για να γράψετε μηνύματα καταγραφής. Ο Ruby έρχεται με μια σειρά χρήσιμων τάξεις και οι βιβλιοθήκες που ονομάζονται τυπική βιβλιοθήκη. Μεταξύ αυτών είναι η βιβλιοθήκη καταγραφέα, η οποία παρέχει καταγραφή προτεραιότητας και περιστροφή.
Βασική χρήση
Δεδομένου ότι η βιβλιοθήκη καταγραφέα έρχεται με Ruby, δεν υπάρχει ανάγκη να εγκαταστήσετε οποιαδήποτε πολύτιμους λίθους ή άλλες βιβλιοθήκες. Για να αρχίσετε να χρησιμοποιείτε τη βιβλιοθήκη καταγραφής, απλά απαιτώ 'logger' και δημιουργήστε ένα νέο αντικείμενο Logger. Οποιαδήποτε μηνύματα γραμμένα στο αντικείμενο Logger θα εγγραφούν στο αρχείο καταγραφής.
#! / usr / bin / env ruby
απαιτούν "logger"
log = Logger.new ('log.txt')
log.debug "Δημιουργήθηκε αρχείο καταγραφής"
Προτεραιότητες
Κάθε μήνυμα καταγραφής έχει προτεραιότητα. Αυτές οι προτεραιότητες καθιστούν απλή την αναζήτηση αρχείων καταγραφής για σοβαρά μηνύματα, καθώς και το αντικείμενο καταγραφής να φιλτράρει αυτόματα τα μικρότερα μηνύματα όταν δεν χρειάζονται. Μπορείτε να το σκεφτείτε σαν να έρθετε στη λίστα για να κάνετε την ημέρα σας. Κάποια πράγματα πρέπει να γίνουν απολύτως, κάποια πράγματα πρέπει πραγματικά να γίνουν, και κάποια πράγματα μπορούν να αναβληθούν μέχρις ότου έχετε χρόνο να τα κάνετε.
Στο προηγούμενο παράδειγμα, η προτεραιότητα ήταν debug, το λιγότερο σημαντικό από όλες τις προτεραιότητες (το "αναβάλλεται μέχρι να έχετε χρόνο" της λίστας σας για να κάνετε, αν θέλετε). Οι προτεραιότητες των μηνυμάτων καταγραφής, με τη σειρά από τουλάχιστον σε πιο σημαντικό, είναι οι εξής: debug, info, warn, λάθος, και θανατηφόρα. Για να ρυθμίσετε το επίπεδο μηνυμάτων που θα πρέπει να αγνοήσει ο καταγραφέας, χρησιμοποιήστε το επίπεδο Χαρακτηριστικό.
#! / usr / bin / env ruby
απαιτούν "logger"
log = Logger.new ('log.txt')
log.level = Καταγραφέας:: WARN
log.debug "Αυτό θα αγνοηθεί"
log.error "Αυτό δεν θα αγνοηθεί"
Μπορείτε να δημιουργήσετε όσα μηνύματα καταγραφής θέλετε και μπορείτε να καταγράψετε κάθε μικροσκοπικό πράγμα που κάνει το πρόγραμμά σας, πράγμα που καθιστά τις προτεραιότητες εξαιρετικά χρήσιμες. Όταν τρέχετε το πρόγραμμά σας, μπορείτε να αφήσετε το επίπεδο καταγραφής σε κάτι σαν προειδοποίηση ή λάθος για να πιάσετε τα σημαντικά πράγματα. Στη συνέχεια, όταν κάτι πάει στραβά, μπορείτε να μειώσετε το επίπεδο καταγραφής (είτε στον πηγαίο κώδικα είτε με ένα διακόπτη γραμμής εντολών) για να λάβετε περισσότερες πληροφορίες.
Περιστροφή
Η βιβλιοθήκη καταγραφέα υποστηρίζει επίσης την περιστροφή του αρχείου καταγραφής. Η περιστροφή καταγραφής διατηρεί τα αρχεία καταγραφής από υπερβολικά μεγάλες και βοηθά στην αναζήτηση παλαιότερων αρχείων καταγραφής. Όταν η περιστροφή του αρχείου καταγραφής είναι ενεργοποιημένη και το ημερολόγιο φτάσει είτε σε ένα συγκεκριμένο μέγεθος είτε σε μια συγκεκριμένη ηλικία, η βιβλιοθήκη καταγραφής θα μετονομάσει αυτό το αρχείο και θα δημιουργήσει ένα νέο αρχείο καταγραφής. Τα παλαιότερα αρχεία καταγραφής μπορούν επίσης να διαμορφωθούν για να διαγραφούν (ή να "ξεπεράσουν την περιστροφή") μετά από μια ορισμένη ηλικία.
Για να ενεργοποιήσετε την περιστροφή του λογαρίθμου, περάστε το "μηνιαίο", "εβδομαδιαίο" ή "καθημερινό" στον κατασκευαστή Logger. Προαιρετικά, μπορείτε να περάσετε ένα μέγιστο μέγεθος αρχείου και αριθμό αρχείων για να διατηρήσετε περιστροφή στον κατασκευαστή.
#! / usr / bin / env ruby
απαιτούν "logger"
log = Logger.new ('log.txt', 'καθημερινά')
log.debug "Μόλις το αρχείο καταγραφής γίνει τουλάχιστον ένα"
log.debug "ημέρα μέρα, θα μετονομαστεί και ένα"
log.debug "θα δημιουργηθεί νέο αρχείο log.txt."