@hackage / monad-logger-extras

monad-logger-extras

Composable logging, syslog integration, and more with monad-logger.

Description

This package provides a way to compose logging actions so that you can conveniently log to multiple destinations. It also includes implementations of a few common logging actions: logging to stdout, stderr, nowhere (similar to NoLoggingT), and to a posix syslog (using hsyslog).

Logs can be emitted in color by using the colorize or colorizeWith function on your Logger.

This package also contains a couple of orphan instances for LoggingT: MonadPlus and Alternative.

Example usage

Watch for the system log message by running:

journalctl --user -t log-test -f

This example can be built and run using cabal (either cabal repl example or cabal build example).

> {-# LANGUAGE OverloadedStrings #-}
> 
> import Control.Monad.Logger
> import Control.Monad.Logger.Extras
> 
> main :: IO ()
> main = do
>   let logger = colorize logToStdout <> logToStderr <> logToSyslog "log-test"
>   flip runLoggerLoggingT logger $ do
>     logInfoN "This is a test. You should see this on stdout, stderr, and in your system log."
>     logDebugN "This is a debug message."
>     logWarnN "This is a warning."
>     logErrorN "This is an error!"

This should produce output that looks like this (note that the stdout log has been colorized):