| Copyright | (c) Tim Watson 2013 - 2014 |
|---|---|
| License | BSD3 (see the file LICENSE) |
| Maintainer | Tim Watson <watson.timothy@gmail.com> |
| Stability | experimental |
| Portability | non-portable (requires concurrency) |
| Safe Haskell | None |
| Language | Haskell98 |
Control.Distributed.Process.Extras.SystemLog
Description
This module provides a general purpose logging facility, implemented as a
distributed-process Management Agent. To start the logging agent on a
running node, evaluate systemLog with the relevant expressions to handle
logging textual messages, a cleanup operation (if required), initial log
level and a formatting expression.
We export a working example in the form of systemLogFile, which logs
to a text file using buffered I/O. Its implementation is very simple, and
should serve as a demonstration of how to use the API:
systemLogFile :: FilePath -> LogLevel -> LogFormat -> Process ProcessId systemLogFile path lvl fmt = do h <- liftIO $ openFile path AppendMode liftIO $ hSetBuffering h LineBuffering systemLog (liftIO . hPutStrLn h) (liftIO (hClose h)) lvl fmt
- data LogLevel
- type LogFormat = String -> Process String
- data LogClient
- type LogChan = ()
- data LogText = LogText {}
- class ToLog m where
- class Logger a where
- logMessage :: a -> LogMessage -> Process ()
- mxLogId :: MxAgentId
- systemLog :: (String -> Process ()) -> Process () -> LogLevel -> LogFormat -> Process ProcessId
- client :: Process (Maybe LogClient)
- logChannel :: LogChan
- addFormatter :: Routable r => r -> Closure (Message -> Process (Maybe String)) -> Process ()
- systemLogFile :: FilePath -> LogLevel -> LogFormat -> Process ProcessId
- report :: Logger l => (l -> LogText -> Process ()) -> l -> String -> Process ()
- debug :: (Logger l, ToLog m) => l -> m -> Process ()
- info :: (Logger l, ToLog m) => l -> m -> Process ()
- notice :: (Logger l, ToLog m) => l -> m -> Process ()
- warning :: (Logger l, ToLog m) => l -> m -> Process ()
- error :: (Logger l, ToLog m) => l -> m -> Process ()
- critical :: (Logger l, ToLog m) => l -> m -> Process ()
- alert :: (Logger l, ToLog m) => l -> m -> Process ()
- emergency :: (Logger l, ToLog m) => l -> m -> Process ()
- sendLog :: (Logger l, ToLog m) => l -> m -> LogLevel -> Process ()
Types exposed by this module
Methods
logMessage :: a -> LogMessage -> Process () Source
Mx Agent Configuration / Startup
Arguments
| :: (String -> Process ()) | This expression does the actual logging |
| -> Process () | An expression used to clean up any residual state |
| -> LogLevel | The initial |
| -> LogFormat | An expression used to format logging messages/text |
| -> Process ProcessId |
Start a system logger process as a management agent.
systemLogFile
systemLogFile :: FilePath -> LogLevel -> LogFormat -> Process ProcessId Source
Start a system logger that writes to a file.
This is a very basic file logging facility, that uses regular buffered
file I/O (i.e., System.IO.hPutStrLn et al) under the covers. The handle
is closed appropriately if/when the logging process terminates.
See Control.Distributed.Process.Management.mxAgentWithFinalize for futher
details about management agents that use finalizers.