The prometheus package

[Tags:bsd3, library]
Prometheus Haskell Client

A simple and modern, type safe, idiomatic Haskell client for Prometheus monitoring. Specifically there is no use of unsafe IO or manual ByteString construction from lists of bytes. Batteries-included web server.

Usage Example
 module Example where

 import           Control.Monad.IO.Class                         (liftIO)
 import           System.Metrics.Prometheus.Concurrent.Http      (serveHttpTextMetricsT)
 import           System.Metrics.Prometheus.Concurrent.RegistryT
 import           System.Metrics.Prometheus.Metric.Counter       (inc)
 import           System.Metrics.Prometheus.MetricId

 main :: IO ()
 main = runRegistryT $ do
     -- Labels can be defined as lists or added to an empty label set
     connectSuccessGauge <- registerGauge "example_connections" (fromList [("login", "success")])
     connectFailureGauge <- registerGauge "example_connections" (addLabel "login" "failure" mempty)
     connectCounter <- registerCounter "example_connection_total" mempty
     latencyHistogram <- registerHistogram "example_round_trip_latency_ms" mempty [10, 20..100]

     liftIO $ inc connectCounter -- increment a counter

     -- [...] pass metric handles to the rest of the app

     serveHttpTextMetricsT 8080 ["metrics"] -- http://localhost:8080/metric server

Advanced Usage

A Registry and StateT-based RegistryT are available for unit testing or generating lists of `[IO a]` actions that can be sequenced and returned from pure code to be applied.


[Skip to Readme]

Properties

Versions 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.1, 0.2.0, 0.3.0, 0.3.1, 0.3.2, 0.3.2.1, 0.4.0, 0.4.1
Dependencies atomic-primops (==0.8.*), base (>=4.7 && <4.10), bytestring (==0.10.*), containers (==0.5.*), http-types (>=0.8 && <0.10), text (==1.2.*), transformers (>=0.4 && <0.6), wai (==3.2.*), warp (==3.2.*) [details]
License BSD3
Copyright Bitnomial, Inc. (c) 2016
Author Luke Hoersten
Maintainer luke@hoersten.org, opensource@bitnomial.com
Category Metrics, Monitoring, Web, System
Home page http://github.com/LukeHoersten/prometheus#readme
Bug tracker http://github.com/LukeHoersten/prometheus/issues
Source repository head: git clone https://github.com/LukeHoersten/prometheus
Uploaded Sun Oct 23 20:04:13 UTC 2016 by LukeHoersten
Distributions NixOS:0.4.1
Downloads 350 total (38 in the last 30 days)
Votes
0 []
Status Docs available [build log]
Last success reported on 2016-10-29 [all 1 reports]

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for prometheus

Readme for prometheus-0.4.1

Prometheus Haskell Client

A simple and modern, type safe, idiomatic Haskell client for Prometheus monitoring. Specifically there is no use of unsafe IO or manual ByteString construction from lists of bytes. Batteries-included web server. . [Usage Example]

Usage Example

{-# LANGUAGE OverloadedStrings #-}

module Example where

import           Control.Monad.IO.Class                         (liftIO)
import           System.Metrics.Prometheus.Concurrent.Http      (serveHttpTextMetricsT)
import           System.Metrics.Prometheus.Concurrent.RegistryT
import           System.Metrics.Prometheus.Metric.Counter       (inc)
import           System.Metrics.Prometheus.MetricId

main :: IO ()
main = runRegistryT $ do
    -- Labels can be defined as lists or added to an empty label set
    connectSuccessGauge <- registerGauge "example_connections" (fromList [("login", "success")])
    connectFailureGauge <- registerGauge "example_connections" (addLabel "login" "failure" mempty)
    connectCounter <- registerCounter "example_connection_total" mempty
    latencyHistogram <- registerHistogram "example_round_trip_latency_ms" mempty [10, 20..100]

    liftIO $ inc connectCounter -- increment a counter

    -- [...] pass metric handles to the rest of the app

    serveHttpTextMetricsT 8080 ["metrics"] -- http://localhost:8080/metric server

Advanced Usage

A Registry and StateT-based RegistryT are available for unit testing or generating lists of [IO a] actions that can be sequenced and returned from pure code to be applied.

Tasks

  • [ ] Implement help docstrings.
  • [ ] Implement GHC-specific metrics.
  • [ ] Implement summary metric.
  • [ ] Encode name and labels on register.
  • [x] Implement ReaderT for Concurrent Registry.
  • [x] Library documentation and example.
  • [ ] Name and label validation