Skip to content

Latest commit

 

History

History
46 lines (29 loc) · 2.31 KB

README.md

File metadata and controls

46 lines (29 loc) · 2.31 KB
Raw

HAP-Monitor

Requests HAProxy statistics and reports them to a Graphite/NodeJS backend. This version of the script is intedend to be executed as a cronjob.

A script doing the same, but runs as a daemon was created by P. Roberts and can be found here: https://github.com/phillipbroberts/HAP-Monitor

TCP vs UDP to Graphite

There are two Python scripts in this repo, hap-monitor-cron.py and hap-monitor-cronTCP.py. The first uses UDP to send stats to Graphite. The second uses TCP to send stats to Graphite.

Purpose

A simple Python script requesting the statistics of several HAProxies (http://www.haproxy.org/) and reports them into Graphite (http://graphite.wikidot.com/).

Dependencies

In order to report data to Graphite, the Python module py-statsd is used. The source code can be found here at GitHub in the repository https://github.com/sivy/py-statsd.git. Installation instructions are given in according README.md file.

Configuration

The script is configured solely by CLI argumets.

usage: hap-monitor-cron.py [-h] [--backend B] [--sockets S [S ...]] [--verbose]

optional arguments:
  -h, --help           show this help message and exit
  --backend B          Graphite server URL[:port][::scope] to which the script will report to. E.g. --backend graphite.host:8025::my.system.stats.haproxy
  --type T             Type of the backend server. Supported values are: G (Graphite) and S (statsd)
  --sockets S [S ...]  a list of socket files e.g. /var/run/haproxy_admin_process_no_1.sock
  --verbose            makes it chatty

To execute it in the desired interval define a cronjob on the host running HAProxy. For example, we want collect data with one minute intervall:

*/1 * * * * python /usr/local/bin/hap-monitor.py --backend graphite.host:8025::my.system.stats.haproxy --type G --sockets /var/run/haproxy_admin_process_no_1.sock /var/run/haproxy_admin_process_no_2.sock

Also note, that the example above assumes HAProxy running two processes reproting iwhich conequently report into two distinct sockets.

License

Copyright European Organization for Nuclear Research (CERN)

Licensed under the Apache License, Version 2.0 (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0