mirror of
https://github.com/haskell-servant/servant-ekg.git
synced 2024-11-23 03:29:43 +01:00
Update to work with LTS-12.x and Servant 0.14
This commit is contained in:
parent
4a280658d9
commit
9c5a6ce1a3
6 changed files with 92 additions and 29 deletions
14
.travis.yml
14
.travis.yml
|
@ -1,6 +1,6 @@
|
||||||
# This Travis job script has been generated by a script via
|
# This Travis job script has been generated by a script via
|
||||||
#
|
#
|
||||||
# haskell-ci '--output=.travis.yml' '--branches=master' 'cabal.project'
|
# haskell-ci '--output=.travis.yml' '--config=cabal.haskell-ci' 'cabal.project'
|
||||||
#
|
#
|
||||||
# For more information, see https://github.com/haskell-CI/haskell-ci
|
# For more information, see https://github.com/haskell-CI/haskell-ci
|
||||||
#
|
#
|
||||||
|
@ -115,5 +115,15 @@ script:
|
||||||
# Build without installed constraints for packages in global-db
|
# Build without installed constraints for packages in global-db
|
||||||
- rm -f cabal.project.local; ${CABAL} new-build -w ${HC} --disable-tests --disable-benchmarks all;
|
- rm -f cabal.project.local; ${CABAL} new-build -w ${HC} --disable-tests --disable-benchmarks all;
|
||||||
|
|
||||||
# REGENDATA ["--output=.travis.yml","--branches=master","cabal.project"]
|
# Constraint sets
|
||||||
|
- rm -rf cabal.project.local
|
||||||
|
|
||||||
|
# Constraint set servant-0.15
|
||||||
|
- ${CABAL} new-build -w ${HC} --disable-tests --disable-benchmarks --constraint='servant ==0.15.*' all
|
||||||
|
|
||||||
|
# Constraint set servant-0.16
|
||||||
|
- ${CABAL} new-build -w ${HC} --disable-tests --disable-benchmarks --constraint='servant ==0.16.*' all
|
||||||
|
|
||||||
|
|
||||||
|
# REGENDATA ["--output=.travis.yml","--config=cabal.haskell-ci","cabal.project"]
|
||||||
# EOF
|
# EOF
|
||||||
|
|
41
README.md
Normal file
41
README.md
Normal file
|
@ -0,0 +1,41 @@
|
||||||
|
# servant-ekg
|
||||||
|
|
||||||
|
[![Build Status](https://travis-ci.org/haskell-servant/servant-ekg.png)](https://travis-ci.org/haskell-servant/servant-ekg)
|
||||||
|
|
||||||
|
# Servant Performance Counters
|
||||||
|
|
||||||
|
This package lets you track peformance counters for each of your Servant endpoints using EKG.
|
||||||
|
|
||||||
|
# Usage
|
||||||
|
|
||||||
|
Servant-EKG knows how to handle all official Servant combinators out of the box.
|
||||||
|
|
||||||
|
## Instrumenting your API
|
||||||
|
To use Servant-EKG, you'll need to wrap your WAI application with the Servant-EKG middleware.
|
||||||
|
|
||||||
|
```
|
||||||
|
import Network.Wai.Handler.Warp
|
||||||
|
import System.Metrics
|
||||||
|
import Servant.Ekg
|
||||||
|
|
||||||
|
wrapWithEkg :: Proxy api -> Server api -> IO Application
|
||||||
|
wrapWithEkg api server = do
|
||||||
|
store <- newStore
|
||||||
|
metrics <- newMVar mempty
|
||||||
|
|
||||||
|
return $ monitorEndpoints api store metrics (serve api server)
|
||||||
|
|
||||||
|
main :: IO ()
|
||||||
|
main = do
|
||||||
|
let api = ...
|
||||||
|
server = ...
|
||||||
|
|
||||||
|
app <- wrapWithEkg api server
|
||||||
|
|
||||||
|
run 8080 app
|
||||||
|
```
|
||||||
|
|
||||||
|
## Runtime overhead
|
||||||
|
Instrumenting your API introduces a non-zero runtime overhead, on the order of 200 - 600 µsec depending upon your machine. It's a good idea to run the benchmarks on your intended production platform to get an idea of how large the overhead will be. You'll need to have `wrk` installed to run the benchmarks.
|
||||||
|
|
||||||
|
In general, the runtime overhead should be effectively negligible if your handlers are issuing network requests, such as to databases. If you have handlers that are small, CPU-only, and requested frequently, you will see a performance hit from Servant-EKG.
|
9
cabal.haskell-ci
Normal file
9
cabal.haskell-ci
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
branches: master
|
||||||
|
|
||||||
|
constraint-set servant-0.15
|
||||||
|
ghc: >= 8.0 && <8.8
|
||||||
|
constraints: servant ==0.15.*
|
||||||
|
|
||||||
|
constraint-set servant-0.16
|
||||||
|
ghc: >= 8.0 && <8.8
|
||||||
|
constraints: servant ==0.16.*
|
|
@ -4,10 +4,10 @@
|
||||||
{-# LANGUAGE FlexibleInstances #-}
|
{-# LANGUAGE FlexibleInstances #-}
|
||||||
{-# LANGUAGE KindSignatures #-}
|
{-# LANGUAGE KindSignatures #-}
|
||||||
{-# LANGUAGE OverloadedStrings #-}
|
{-# LANGUAGE OverloadedStrings #-}
|
||||||
|
{-# LANGUAGE PolyKinds #-}
|
||||||
{-# LANGUAGE RecordWildCards #-}
|
{-# LANGUAGE RecordWildCards #-}
|
||||||
{-# LANGUAGE ScopedTypeVariables #-}
|
{-# LANGUAGE ScopedTypeVariables #-}
|
||||||
{-# LANGUAGE TypeOperators #-}
|
{-# LANGUAGE TypeOperators #-}
|
||||||
{-# LANGUAGE PolyKinds #-}
|
|
||||||
module Servant.Ekg where
|
module Servant.Ekg where
|
||||||
|
|
||||||
import Control.Concurrent.MVar
|
import Control.Concurrent.MVar
|
||||||
|
@ -116,6 +116,7 @@ instance (KnownSymbol (path :: Symbol), HasEndpoint (sub :: *))
|
||||||
return (p:end, method)
|
return (p:end, method)
|
||||||
_ -> Nothing
|
_ -> Nothing
|
||||||
|
|
||||||
|
|
||||||
instance (KnownSymbol (capture :: Symbol), HasEndpoint (sub :: *))
|
instance (KnownSymbol (capture :: Symbol), HasEndpoint (sub :: *))
|
||||||
=> HasEndpoint (Capture' mods capture a :> sub) where
|
=> HasEndpoint (Capture' mods capture a :> sub) where
|
||||||
getEndpoint _ req =
|
getEndpoint _ req =
|
||||||
|
@ -147,8 +148,10 @@ instance HasEndpoint (sub :: *) => HasEndpoint (QueryFlag h :> sub) where
|
||||||
instance HasEndpoint (sub :: *) => HasEndpoint (ReqBody' mods cts a :> sub) where
|
instance HasEndpoint (sub :: *) => HasEndpoint (ReqBody' mods cts a :> sub) where
|
||||||
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
||||||
|
|
||||||
|
#if MIN_VERSION_servant(0,15,0)
|
||||||
instance HasEndpoint (sub :: *) => HasEndpoint (StreamBody' mods framing ct a :> sub) where
|
instance HasEndpoint (sub :: *) => HasEndpoint (StreamBody' mods framing ct a :> sub) where
|
||||||
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
||||||
|
#endif
|
||||||
|
|
||||||
instance HasEndpoint (sub :: *) => HasEndpoint (RemoteHost :> sub) where
|
instance HasEndpoint (sub :: *) => HasEndpoint (RemoteHost :> sub) where
|
||||||
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
||||||
|
@ -168,19 +171,17 @@ instance HasEndpoint (sub :: *) => HasEndpoint (WithNamedContext x y sub) where
|
||||||
instance ReflectMethod method => HasEndpoint (Verb method status cts a) where
|
instance ReflectMethod method => HasEndpoint (Verb method status cts a) where
|
||||||
getEndpoint _ req = case pathInfo req of
|
getEndpoint _ req = case pathInfo req of
|
||||||
[] | requestMethod req == method -> Just ([], method)
|
[] | requestMethod req == method -> Just ([], method)
|
||||||
_ -> Nothing
|
_ -> Nothing
|
||||||
where method = reflectMethod (Proxy :: Proxy method)
|
where method = reflectMethod (Proxy :: Proxy method)
|
||||||
|
|
||||||
instance ReflectMethod method => HasEndpoint (Stream method status framing ct a) where
|
instance ReflectMethod method => HasEndpoint (Stream method status framing ct a) where
|
||||||
getEndpoint _ req = case pathInfo req of
|
getEndpoint _ req = case pathInfo req of
|
||||||
[] | requestMethod req == method -> Just ([], method)
|
[] | requestMethod req == method -> Just ([], method)
|
||||||
_ -> Nothing
|
_ -> Nothing
|
||||||
where method = reflectMethod (Proxy :: Proxy method)
|
where method = reflectMethod (Proxy :: Proxy method)
|
||||||
|
|
||||||
instance HasEndpoint (Raw) where
|
instance HasEndpoint Raw where
|
||||||
getEndpoint _ _ = Just ([],"RAW")
|
getEndpoint _ _ = Just ([],"RAW")
|
||||||
|
|
||||||
#if MIN_VERSION_servant(0,8,1)
|
|
||||||
instance HasEndpoint (sub :: *) => HasEndpoint (CaptureAll (h :: Symbol) a :> sub) where
|
instance HasEndpoint (sub :: *) => HasEndpoint (CaptureAll (h :: Symbol) a :> sub) where
|
||||||
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
getEndpoint _ = getEndpoint (Proxy :: Proxy sub)
|
||||||
#endif
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
cabal-version: >=1.10
|
cabal-version: >=1.10
|
||||||
name: servant-ekg
|
name: servant-ekg
|
||||||
version: 0.2.1.0
|
version: 0.2.2.0
|
||||||
synopsis: Helpers for using ekg with servant
|
synopsis: Helpers for using ekg with servant
|
||||||
description: Helpers for using ekg with servant, e.g.. counters per endpoint.
|
description: Helpers for using ekg with servant, e.g.. counters per endpoint.
|
||||||
license: BSD3
|
license: BSD3
|
||||||
|
@ -24,13 +24,13 @@ library
|
||||||
hs-source-dirs: lib
|
hs-source-dirs: lib
|
||||||
build-depends:
|
build-depends:
|
||||||
base >=4.9 && <4.13
|
base >=4.9 && <4.13
|
||||||
, ekg-core >=0.1.1.6 && <0.2
|
, ekg-core >=0.1.1.4 && <0.2
|
||||||
, http-types >=0.12.2 && <0.13
|
, http-types >=0.12.2 && <0.13
|
||||||
, servant >=0.15 && <0.17
|
, servant >=0.14 && <0.17
|
||||||
, text >=1.2.3.0 && <1.3
|
, text >=1.2.3.0 && <1.3
|
||||||
, time >=1.6.0.1 && <1.9
|
, time >=1.6.0.1 && <1.9
|
||||||
, unordered-containers >=0.2.9.0 && <0.3
|
, unordered-containers >=0.2.9.0 && <0.3
|
||||||
, wai >=3.2.2 && <3.3
|
, wai >=3.2.0 && <3.3
|
||||||
|
|
||||||
default-language: Haskell2010
|
default-language: Haskell2010
|
||||||
|
|
||||||
|
|
|
@ -1,28 +1,34 @@
|
||||||
{-# LANGUAGE CPP #-}
|
{-# LANGUAGE CPP #-}
|
||||||
{-# LANGUAGE DataKinds #-}
|
{-# LANGUAGE DataKinds #-}
|
||||||
{-# LANGUAGE DeriveGeneric #-}
|
{-# LANGUAGE DeriveGeneric #-}
|
||||||
{-# LANGUAGE OverloadedStrings #-}
|
{-# LANGUAGE OverloadedStrings #-}
|
||||||
{-# LANGUAGE PolyKinds #-}
|
{-# LANGUAGE PolyKinds #-}
|
||||||
{-# LANGUAGE TypeFamilies #-}
|
{-# LANGUAGE RankNTypes #-}
|
||||||
{-# LANGUAGE TypeOperators #-}
|
{-# LANGUAGE TypeFamilies #-}
|
||||||
|
{-# LANGUAGE TypeOperators #-}
|
||||||
|
|
||||||
module Servant.EkgSpec (spec) where
|
module Servant.EkgSpec (spec) where
|
||||||
|
|
||||||
import Control.Concurrent
|
import Control.Concurrent
|
||||||
import Data.Aeson
|
import Data.Aeson
|
||||||
import Data.Monoid
|
import qualified Data.HashMap.Strict as H
|
||||||
|
import Data.Monoid ((<>))
|
||||||
import Data.Proxy
|
import Data.Proxy
|
||||||
import qualified Data.HashMap.Strict as H
|
|
||||||
import Data.Text
|
import Data.Text
|
||||||
import GHC.Generics
|
import GHC.Generics
|
||||||
import Network.HTTP.Client (defaultManagerSettings, newManager)
|
import Network.HTTP.Client (defaultManagerSettings,
|
||||||
|
newManager)
|
||||||
import Network.Wai
|
import Network.Wai
|
||||||
import Network.Wai.Handler.Warp
|
import Network.Wai.Handler.Warp
|
||||||
import Servant
|
import Servant
|
||||||
import Servant.Client
|
import Servant.Client
|
||||||
import Servant.Test.ComprehensiveAPI (comprehensiveAPI)
|
#if MIN_VERSION_servant(0,15,0)
|
||||||
|
import Servant.Test.ComprehensiveAPI (comprehensiveAPI)
|
||||||
|
#else
|
||||||
|
import Servant.API.Internal.Test.ComprehensiveAPI (comprehensiveAPI)
|
||||||
|
#endif
|
||||||
import System.Metrics
|
import System.Metrics
|
||||||
import qualified System.Metrics.Counter as Counter
|
import qualified System.Metrics.Counter as Counter
|
||||||
import Test.Hspec
|
import Test.Hspec
|
||||||
|
|
||||||
import Servant.Ekg
|
import Servant.Ekg
|
||||||
|
@ -38,7 +44,7 @@ spec = describe "servant-ekg" $ do
|
||||||
|
|
||||||
let getEp :<|> postEp :<|> deleteEp = client testApi
|
let getEp :<|> postEp :<|> deleteEp = client testApi
|
||||||
|
|
||||||
it "collects number of request" $ do
|
it "collects number of request" $
|
||||||
withApp $ \port mvar -> do
|
withApp $ \port mvar -> do
|
||||||
mgr <- newManager defaultManagerSettings
|
mgr <- newManager defaultManagerSettings
|
||||||
let runFn :: ClientM a -> IO (Either ClientError a)
|
let runFn :: ClientM a -> IO (Either ClientError a)
|
||||||
|
@ -101,11 +107,7 @@ server = helloH :<|> postGreetH :<|> deleteGreetH
|
||||||
|
|
||||||
postGreetH = return
|
postGreetH = return
|
||||||
|
|
||||||
#if MIN_VERSION_servant(0,8,0)
|
|
||||||
deleteGreetH _ = return NoContent
|
deleteGreetH _ = return NoContent
|
||||||
#else
|
|
||||||
deleteGreetH _ = return ()
|
|
||||||
#endif
|
|
||||||
|
|
||||||
-- Turn the server into a WAI app. 'serve' is provided by servant,
|
-- Turn the server into a WAI app. 'serve' is provided by servant,
|
||||||
-- more precisely by the Servant.Server module.
|
-- more precisely by the Servant.Server module.
|
||||||
|
|
Loading…
Reference in a new issue