Network.Wai.Middleware.Logging

Documentation

addThreadContext :: [Pair] -> Middleware

Add context to any logging done from the request-handling thread

addThreadContextFromRequest :: (Request -> [Pair]) -> Middleware

addThreadContext, but have the Request available

requestLogger :: HasLogger env => env -> Middleware

Log requests (more accurately, responses) as they happen

In JSON format, logged messages look like:

{
  ...
  message: {
    text: "GET foobar => 200 OK",
    meta: {
      method: GET,
      path: "foobar",
      query: "?baz=bat&quix=quo",
      status: {
        code: 200,
        message: OK
      },
      durationMs: 1322.2,
      requestHeaders: {
        Authorization: "***",
        Accept: "text/html",
        Cookie: "***"
      },
      responseHeaders: {
        Set-Cookie: "***",
        Expires: "never"
      }
    }
  }
}

requestLoggerWith :: HasLogger env => Config -> env -> Middleware

Configuration

data Config

defaultConfig :: Config

setConfigLogSource :: LogSource -> Config -> Config

Change the source used for log messages

Default is requestLogger.

setConfigGetDestinationIp :: (Request -> Maybe Text) -> Config -> Config

Change how the destinationIp field is determined

Default is looking up the x-real-ip header.