The nagios-plugin-ekg package

[maintain]

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


[Skip to ReadMe]

Properties

Versions0.1.0.0, 0.1.1.0, 0.1.1.0
Dependenciesaeson, base (>=4.7 && <5), bytestring, containers, lens, nagios-check (>=0.3.1), nagios-plugin-ekg, optparse-applicative, text, transformers, unordered-containers, wreq [details]
LicenseMIT
Copyright2015 Sharif Olorin and Anchor Systems
AuthorSharif Olorin
Maintainersio@tesser.org
CategorySystem
Home pagehttps://github.com/fractalcat/nagios-plugin-ekg
Source repositoryhead: git clone git@github.com:fractalcat/nagios-plugin-ekg.git
Executablescheck_ekg
UploadedFri Jun 26 01:51:47 UTC 2015 by fractalcat

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for nagios-plugin-ekg-0.1.1.0

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.