Skip to main content

A Nagios plugin that collects response times from logs.

Project description

A Nagios plugin that collects response times from logs.

Usage: check_responsetime --logfile /path/to/logfile

The plugin remembers the timestamp of the latest log entry it has seen on each run, and on the next run only considers log entries that are more recent.

Log format

The supported log format is as follows:

<timestamp> "<http-verb> <path> <http-version>" <responsetime>
  • timestamp: %d/%b/%Y:%H:%M:%S %z
  • http-verb: GET, POST
  • path: the requested URL path
  • http-version: e.g. HTTP/1.1
  • responsetime in seconds, e. g. 0.5

Example:

17/May/2011:14:11:18 +0200 "GET /index.html HTTP/1.1" 0.289

An example configuration for the nginx server looks like this:

http {
    log_format timing '$time_local "$request" $upstream_response_time';

    server {
        access_log /path/to/timing.log timing;
    }
}

Future directions

One obvious additional feature is the ability to define thresholds (e.g. “a mean responsetime above 3 seconds is WARN, above 5 CRITICAL”)

Development

The source code is available in the mercurial repository at https://code.gocept.com/hg/public/nagios.responsetime

Please report any bugs you find to Wolfgang Schnerring.

Changes

1.0.4 (2012-12-07)

  • Explicitly declare our dependency on nagiosplugin < 0.5
  • Fix API incompatibility in test suite.

1.0.3 (2011-12-08)

  • If no records are availble for this check period, return empty performance values (all zero) to avoid UNKNOWN state that is only noise.

1.0.2 (2011-11-14)

  • Fixed divide by zero bug when there is only a single entry (#9332).

1.0.1 (2011-09-04)

  • Fixed bug when there are no log entries for the current interval (#9332).

1.0 (2011-07-01)

  • Fixed bug with incomplete log file lines (“invalid literal for float(): -“).

1.0rc1 (2011-06-10)

  • First release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nagios.responsetime-1.0.4.tar.gz (8.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page