Repository moved https://github.com/mnellemann/hmci

Go to file

Mark Nellemann e3717529b5 More robust re-discovery and retry logic.		2020-08-21 08:51:47 +02:00
doc	More robust re-discovery and retry logic.	2020-08-21 08:51:47 +02:00
gradle/wrapper	Initial code commit	2020-08-07 08:13:48 +02:00
src	More robust re-discovery and retry logic.	2020-08-21 08:51:47 +02:00
.editorconfig	Support for configuration file and multiple HMC's.	2020-08-13 17:50:26 +02:00
.gitattributes	Initial code commit	2020-08-07 08:13:48 +02:00
.gitignore	Initial code commit	2020-08-07 08:13:48 +02:00
bitbucket-pipelines.yml	Make the artifact upload more robust.	2020-08-18 07:55:29 +02:00
build.gradle	More testing, coverage setup and aa try-catch to avoid exits on errors	2020-08-17 14:23:15 +02:00
gradle.properties	More robust re-discovery and retry logic.	2020-08-21 08:51:47 +02:00
gradlew	Initial code commit	2020-08-07 08:13:48 +02:00
gradlew.bat	Initial code commit	2020-08-07 08:13:48 +02:00
LICENSE	Added LICENSE information	2020-08-18 13:49:48 +02:00
README.md	More robust re-discovery and retry logic.	2020-08-21 08:51:47 +02:00
settings.gradle	Initial code commit	2020-08-07 08:13:48 +02:00

README.md

HMC Insights

Small utility to fetch metrics from one or more HMC's and push those to an InfluxDB time-series database.

Usage Instructions

Ensure you have correct date/time and NTP running to keep it accurate!
Install .deb or .rpm file from downloads or compile from source
Copy the doc/hmci.groovy.tpl configuration template into /etc/hmci.groovy and edit the configuration to suit your environment
Configure Grafana to communicate with your InfluxDB and import dashboards from doc/ into Grafana (The dashboards are slightly modified versions of the dashboard provided by the nmon2influxdb tool)
Run the bin/hmci program in a shell, as a @reboot cron task or setup a proper service :)

Development Information

You need JDK version 8 or later.

Build & Test

Use the gradle-wrapper build tool

./gradlew clean build

InfluxDB for local testing

Start the InfluxDB container

docker run --name=influxdb --rm -d -p 8086:8086 influxdb

To use the Influx client from the same container

docker exec -it influxdb influx

Grafana for local testing

Start the Grafana container, linking it to the InfluxDB container

docker run --name grafana --link influxdb:influxdb --rm -d -p 3000:3000 grafana/grafana:7.1.3

Configure a new InfluxDB datasource on http://influxdb:8086 named hmci to connect to the InfluxDB container. The database must be created beforehand, this can be done by running the hmci tool first. Grafana dashboards can be imported from the doc/ folder.