The nagios-plugin-ekg package

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

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


[Skip to Readme]

Properties

Versions 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 repository head: git clone git@github.com:fractalcat/nagios-plugin-ekg.git
Uploaded Fri Jun 26 01:52:06 UTC 2015 by fractalcat
Distributions NixOS:0.1.1.0
Executables check_ekg
Downloads 288 total (12 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-06-26 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


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.