Hackage :: [Package]

ekg: Remote monitoring of processes

[ bsd3, library, network, system ] [ Propose Tags ] [ Report a vulnerability ]

This library lets you remotely monitor a running process over HTTP. It provides a simple way to integrate a monitoring server into any application.

[Skip to Readme]

Modules

[Last Documentation]

  • System
    • Remote
      • System.Remote.Counter
      • System.Remote.Gauge
      • System.Remote.Label
      • System.Remote.Monitoring

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.0.1, 0.3.0.2, 0.3.0.3, 0.3.0.4, 0.3.0.5, 0.3.1.0, 0.3.1.1, 0.3.1.2, 0.3.1.3, 0.3.1.4, 0.4.0.0, 0.4.0.1, 0.4.0.2, 0.4.0.3, 0.4.0.4, 0.4.0.5, 0.4.0.6, 0.4.0.7, 0.4.0.8, 0.4.0.9, 0.4.0.10, 0.4.0.11, 0.4.0.12, 0.4.0.13, 0.4.0.14, 0.4.0.15, 0.4.1.0, 0.4.1.1, 0.4.1.2
Change log CHANGES.md
Dependencies aeson (>=0.4 && <1.6 || >=2.0 && <2.3), base (>=4.5 && <4.22), bytestring (<1.0), ekg-core (>=0.1 && <0.2), ekg-json (>=0.1 && <0.2), filepath (<1.6), network (<3.3), snap-core (<1.1), snap-server (<1.2), text (<2.2), time (<1.15), transformers (<0.7), unordered-containers (<0.3) [details]
Tested with ghc ==8.0.2 || ==8.2.2 || ==8.4.4 || ==8.6.5 || ==8.8.3 || ==8.10.7 || ==9.0.2 || ==9.2.8 || ==9.4.8 || ==9.6.4 || ==9.6.6 || ==9.8.2 || ==9.10.1 || ==9.12.2
License BSD-3-Clause
Author Johan Tibell
Maintainer Johan Tibell <johan.tibell@gmail.com>, Mikhail Glushenkov <mikhail.glushenkov@gmail.com>
Category System, Network
Home page https://github.com/l0negamer/ekg
Bug tracker https://github.com/l0negamer/ekg/issues
Source repo head: git clone https://github.com/l0negamer/ekg.git
Uploaded by BenjaminMcRae at 2025-04-22T16:05:36Z
Distributions Debian:0.4.0.15, FreeBSD:0.4.0.8, LTSHaskell:0.4.1.1, Stackage:0.4.1.2
Reverse Dependencies 11 direct, 53 indirect [details]
Downloads 49594 total (47 in the last 30 days)
Rating 2.5 (votes: 4) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2025-04-22 [all 2 reports]

Readme for ekg-0.4.1.2

[back to package description]

EKG: Remote monitoring of running processes over HTTP Hackage version Build status

This library lets you remotely monitor a running process over HTTP. It provides a simple way to integrate a monitoring server into any application.

Getting started

Adding monitoring to your application is simple. Just launch the monitoring server as soon as your application starts

import System.Remote.Monitoring

main = do
     forkServer "localhost" 8000
     ...

and then visit http://localhost:8000/ in your web browser.

To make full use out of this module you must first enable GC statistics collection in the run-time system. To enable GC statistics collection, either run your program with

+RTS -T

or compile it with

-with-rtsopts=-T

The runtime overhead of -T is very small so it's safe to always leave it enabled.

JSON API

The monitoring server also lets you to retrieve the stats as JSON. Simply send the server an HTTP GET request with the Accept header set to "application/json":

curl -H "Accept: application/json" http://localhost:8000/

You can use the JSON API to e.g. write applications that monitor other applications.

Get involved!

Please report bugs via the GitHub issue tracker.

Master git repository:

git clone https://github.com/l0negamer/ekg.git