raven-haskell- Haskell client for Sentry logging service.

Safe HaskellNone




Raven is a client for Sentry event server (https://www.getsentry.com/).

Start by initializing the raven Service:

l <- initRaven

Send events using register function:

register l "my.logger.name" Debug "Hi there!" id

Tags and stuff can be added using register update functions.

import Data.HashMap.Strict as HM
let tags r = r { srTags = HM.insert "spam" "sausage"
                        . HM.insert "eggs" "bacon"
                        . srTags r }
lt <- initRaven dsn tags sendRecord stderrFallback

let culprit r = r { srCulprit = "my.module.function.name" }
register lt "test.culprit" Error "It's a trap!" culprit
let extra r = r { srExtra = HM.insert "fnord" "42" $ srExtra r }
register lt "test.extra" Info "Test with tags and extra, please ignore."

The core package provides only general interface for sending events which could be wrapped to adapt it to your needs.

let debug msg = forkIO $ register l "my.logger.name" Debug msg (culprit . extra)
debug "Async stuff too."

There are some little helpers to compose your own updaters. You can use them both in initRaven and register.

l <- initRaven dsn ( tags [ ("spam", "sausage"
                          , ("eggs", "bacon") ]
                   . extra [ ("more", "stuff") ]
                   sendRecord stderrFallback

register l "test.helpers" Info "yup, i'm here." $ culprit "java.lang.NotReally"


Event service

initRaven Source


:: String

Sentry DSN

-> (SentryRecord -> SentryRecord)

Default fields updater. Use id if not needed.

-> (SentrySettings -> SentryRecord -> IO ())

Event transport from Raven.Transport.*

-> (SentryRecord -> IO ())

Fallback handler.

-> IO SentryService

Event service to use in register.

Initialize event service.

disabledRaven :: IO SentryService Source

Disabled service that ignores incoming events.

register Source


:: SentryService

Configured raven service.

-> String

Logger name.

-> SentryLevel

Sentry event level.

-> String


-> (SentryRecord -> SentryRecord)

Record updates.

-> IO () 

Ask service to store an event.

Fallback handlers

stderrFallback :: SentryRecord -> IO () Source

Show basic message on stderr.

errorFallback :: SentryRecord -> IO () Source

Crash and burn with record data.

silentFallback :: SentryRecord -> IO () Source

Ignore recording errors.

Record updaters

culprit :: String -> SentryRecord -> SentryRecord Source

Set culprit field.

tags :: [(String, String)] -> SentryRecord -> SentryRecord Source

Add record tags.

extra :: [(String, String)] -> SentryRecord -> SentryRecord Source

Add record extra information.

Lower level helpers

record Source


:: String

Logger name.

-> SentryLevel


-> String


-> (SentryRecord -> SentryRecord)

Additional options

-> IO SentryRecord 

Record an event using logging service.

recordLBS :: SentryRecord -> ByteString Source

JSON-encode record data.