nagios-plugin-ekg: Monitor ekg metrics via Nagios

[ library, mit, program, system ] [ Propose Tags ]

A generic Nagios plugin which retrieves metrics from an application which uses ekg.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.1.1.0
Dependencies aeson, base (>=4.7 && <5), bytestring, containers, lens, nagios-check (>=0.3.1), nagios-plugin-ekg, optparse-applicative, text, transformers, unordered-containers, wreq [details]
License MIT
Copyright 2015 Sharif Olorin and Anchor Systems
Author Sharif Olorin
Maintainer sio@tesser.org
Category System
Home page https://github.com/fractalcat/nagios-plugin-ekg
Source repo head: git clone git@github.com:fractalcat/nagios-plugin-ekg.git
Uploaded by fractalcat at 2015-06-26T01:52:06Z
Distributions
Executables check_ekg
Downloads 1483 total (4 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-06-26 [all 1 reports]

Readme for nagios-plugin-ekg-0.1.1.0

[back to package description]

nagios-plugin-ekg

This package provides check_ekg, a generic plugin for Nagios (and compatible) monitoring systems which translates metrics exposed by ekg into perfdata suitable for use with pnp4nagios and similar tools.

There is currently no support for threshold checks; the plugin will always return an OK result if it can obtain and parse output from the EKG endpoint. Its primary function is to allow gathering performance data over time from EKG-enabled Haskell applications; there are no current plans to add support for thresholds/alerting, though I'd consider it in the future if there was demand.

Usage

The plugin can either be executed directly on the Nagios host or invoked via NRPE.

Example invocation:

$ check_ekg -e http://haskell-app.example.com:8000
OK: perfdata only | iterations=60614c;;;; rts_gc_bytes_allocated=0c;;;; rts_gc_bytes_copied=0c;;;; rts_gc_cpu_ms=0c;;;; rts_gc_cumulative_bytes_used=0c;;;; rts_gc_current_bytes_slop=0.0;;;; rts_gc_current_bytes_used=0.0;;;; rts_gc_gc_cpu_ms=0c;;;; rts_gc_gc_wall_ms=0c;;;; rts_gc_max_bytes_slop=0.0;;;; rts_gc_max_bytes_used=0.0;;;; rts_gc_mutator_cpu_ms=0c;;;; rts_gc_mutator_wall_ms=0c;;;; rts_gc_num_bytes_usage_samples=0c;;;; rts_gc_num_gcs=0c;;;; rts_gc_par_avg_bytes_copied=0.0;;;; rts_gc_par_max_bytes_copied=0.0;;;; rts_gc_par_tot_bytes_copied=0.0;;;; rts_gc_peak_megabytes_allocated=0.0;;;; rts_gc_wall_ms=0c;;;; ekg_server_timestamp_ms=1435214338224c;;;;
$ echo $?
0

Requirements

nagios-plugin-ekg has been tested with GHC 7.8.4 and GHC 7.10.1.