Bøker
Clojure
Kapittel 5. Gode kodeteknikker
Loggføring

Clojure:
Loggføring

Hvordan:

Clojure støtter seg på Javas loggingsfasiliteter, men du kan utnytte dem på en mer idiomatisk Clojure-måte. La oss se på hvordan du kan bruke clojure.tools.logging, som gir en enkel abstraksjon over flere loggingrammeverk:

Først, legg til en avhengighet for clojure.tools.logging og en logg-implementering som log4j i din project.clj:

:dependencies [[org.clojure/clojure "1.10.3"]
               [org.clojure/tools.logging "1.1.0"]
               [log4j/log4j "1.2.17"]]

Nå, la oss logge noen meldinger:

(require '[clojure.tools.logging :as log])

(defn compute-answer-to-everything []
  (log/debug "Starter intens beregning...")
  (Thread/sleep 3000) ; Simulerer en lang beregning
  (log/info "Beregning fullført. Svaret er 42.")
  42)

(compute-answer-to-everything)

Utdata vil ikke vise DEBUG meldinger som standard, ettersom loggnivåer typisk er satt til INFO:

INFO  [ditt-navnerom] - Beregning fullført. Svaret er 42.

Du kan konfigurere loggnivåer og appender i en log4j.properties-fil for å få mer detaljerte utdata etter behov.

Dypdykk

Clojures clojure.tools.logging har eksistert en stund og fungerer som en bro mellom Clojure-kode og Java-loggingsverdenen. Historisk sett har Java gjennomgått flere iterasjoner og biblioteker for logging slik som Javas innebygde logging API, log4j, slf4j, og logback.

I Clojure, mens du direkte kan bruke Javas loggingrammeverk, oppdager clojure.tools.logging og delegerer til hvilket som helst loggingrammeverk det finner i din klassebane, noe som sparer deg for å være tett koblet til en spesifikk implementering. Dette kan bidra til å holde din Clojure-kode mer portabel og modulær.

Alternativer til clojure.tools.logging innenfor Clojure-økosystemet inkluderer biblioteker som timbre, som er et rent Clojure-loggingsbibliotek med funksjoner som loggrotasjon, filtrering, og asynkron logging rett ut av boksen.

Implementeringsdetaljer er avgjørende når det kommer til logging i et flertrådet miljø som Clojure. Her gir immutabilitet og sideeffektstyring tydelige fordeler. Logging, som en sideeffekt, bør håndteres med forsiktighet for å unngå ytelsesflaskehalser og sikre trådsikkerhet, noe de fleste Java-loggingrammeverk allerede tar hånd om.

Til slutt, vurder strukturert logging, hvor logger er skrevet som strukturerte data (som JSON). Dette kan være ekstremt nyttig for senere analyse og behandling, spesielt når det gjelder storskala distribuerte systemer.

Se også

Hvis du er ivrig etter mer, vurder å sjekke ut disse ressursene:

FeilhåndteringOrganisering av kode i funksjoner