Network.Monitoring.Riemann

Documentation

module Network.Monitoring.Riemann.Types

module Data.Int

data Client

Constructors

UDP

Fields

• riemannHost :: Hostname
• riemannPort :: Port
• udpClient :: Either IOException (Socket, AddrInfo)

TCP

Fields

• riemannHost :: Hostname
• riemannPort :: Port
• tcpClient :: IORef TCPState

  TCP connection's state is maintained into a mutable reference in order to allow not mutating the Client structure

makeUDPClient :: Hostname -> Port -> IO Client

Attempts to bind a UDP client at the passed Hostname and Port. Failures are silently ignored---failure in monitoring should not cause an application failure...

makeTCPClient :: Hostname -> Port -> IO Client

Attempts to connect to given riemann server Returns an initialised TCP client that can later be used to send events to given riemann host/port. TCP Clients always try to reconnect to server when an event is sent and connection is either closed or in error.

isError :: MonadIO m => Client -> m Bool

Checks whether or not a given Client is in an error state.

closeClient :: Client -> IO ()

sendEventT :: Client -> Event -> ExceptT IOException IO Client

Attempts to forward an event to a client. If it fails, it'll return an IOException in the ExceptT, otherwise it returns the passed Client, possibly modified to cope for changes in state.

sendEvent :: MonadIO m => Client -> Event -> m ()

Attempts to forward an event to a client. Fails silently.