2013-02-10 08:53:02 -05:00
|
|
|
# munin-graphite
|
|
|
|
|
|
|
|
|
|
Collect Munin statistics, and convert their naming structure to submit to Graphite for visualization.
|
|
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
|
|
|
|
* Munin
|
|
|
|
|
* Python
|
|
|
|
|
* Graphite (with a Carbon cache or relay)
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
Clone the Git repository from [https://github.com/jforman/munin-graphite](https://github.com/jforman/munin-graphite)
|
|
|
|
|
|
2014-03-28 07:36:09 +01:00
|
|
|
## Program invocation
|
2013-02-10 08:53:02 -05:00
|
|
|
|
2014-03-28 07:36:09 +01:00
|
|
|
Optimal way is to run m2g-poller using **nohup** and define all hosts within an configuration file:
|
2013-02-10 08:53:02 -05:00
|
|
|
|
2014-03-28 07:36:09 +01:00
|
|
|
Example:
|
|
|
|
|
nohup ./m2g-poller.py --config /etc/munin-graphite/hosts.cfg &
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Configuration file looks like:
|
|
|
|
|
```
|
|
|
|
|
[node-001]
|
|
|
|
|
carbon=carbon01.company.com:2004
|
|
|
|
|
host=node-001.infra.company.com
|
|
|
|
|
interval=60
|
|
|
|
|
prefix=munin
|
|
|
|
|
|
|
|
|
|
[node-002]
|
|
|
|
|
carbon=carbon99.company.com:2004
|
|
|
|
|
host=node-002.infra.company.com
|
|
|
|
|
interval=120
|
|
|
|
|
prefix=munin
|
|
|
|
|
```
|
|
|
|
|
Runing with config above will start two threads, each thread for one node's section and these threads will in defined
|
|
|
|
|
intervals fetch data from munin-node on targets.
|
|
|
|
|
|
|
|
|
|
If you do not specify all parameters they will be set to default values as described in --help option.
|
|
|
|
|
|
|
|
|
|
You can run m2g-poller.py from commandline with parameters directly to override some or all of supported options,
|
|
|
|
|
in that case all specified option will be use instead of built-in defaults for nodes in configuration file.
|
|
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
./m2g-poller.py --host node-003.company.com --displayname node-003 --carbon carbon01.infra.company.com:2004 --interval 90 --prefix someprefix
|
|
|
|
|
|
|
|
|
|
## Signal handling
|
|
|
|
|
|
|
|
|
|
* you can send SIGTERM to m2g-poller.py program. This would terminate program's run after all threads will finish its
|
|
|
|
|
current cycle.
|
|
|
|
|
* pressing CTRL+C when running from command line will terminate the program as well.
|
|
|
|
|
* you can send SIGHUP to m2g-poller.py program. This would signalize the program it should reload list of plugins of all
|
|
|
|
|
nodes from target list.
|
|
|
|
|
|
|
|
|
|
## System log
|
|
|
|
|
|
|
|
|
|
Program logs information into syslog, using prefix MUNIN-GRAPHITE and identification of originating thread.
|
|
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
MUNIN-GRAPHITE: INFO Thread node-009.company.com: Finished querying host node-009.company.com (Execution Time: 5.12 sec).
|
|
|
|
|
|
|
|
|
|
## Metrics
|
|
|
|
|
|
|
|
|
|
Metrics paths are created using the hostname and various plugin data. The processes count plugin for Munin would produce
|
|
|
|
|
metrics and values like the following:
|
2013-02-10 08:53:02 -05:00
|
|
|
|
|
|
|
|
servers.localhost.processes.processes.uninterruptible, value: 0
|
|
|
|
|
servers.localhost.processes.processes.processes, value: 224
|
|
|
|
|
servers.localhost.processes.processes.runnable, value: 3
|
|
|
|
|
servers.localhost.processes.processes.dead, value: 0
|
|
|
|
|
servers.localhost.processes.processes.sleeping, value: 221
|
|
|
|
|
servers.localhost.processes.processes.zombie, value: 0
|
|
|
|
|
servers.localhost.processes.processes.paging, value: 0
|
|
|
|
|
servers.localhost.processes.processes.stopped, value: 0
|
|
|
|
|
|
|
|
|
|
These paths of data are then sent to Carbon via the pickle port.
|
|
|
|
|
|
