A prometheus.io exporter for metrics from the IBM Z HMC
$ pip3 install zhmc-prometheus-exporter
The exporter itself
Set up your exporter. Edit your credentials YAML file. A sample credentials YAML is provided. Enter the IP address of the HMC, your username, and your password there. Put this file and metrics.yaml into /etc/zhmc-prometheus-exporter/. The latter defines the metrics and descriptions, you do not have to edit it. You can then run
The default port is 9291, you can change it with -p. If you do not want to put hmccreds.yaml and metrics.yaml into /etc/zhmc-prometheus-exporter, you can also specify them with -c and -m respectively.
If you want a quick “three simple metrics” setup with Prometheus and Grafana you can proceed as follows:
Set up a Prometheus server. Get it from Prometheus. A sample configuration YAML is provided. Fill in the IP and port the exporter will run on. If you left it at default, the port will be 9291. You can then run:
$ ./prometheus --config.file=prometheus.yaml
See also Prometheus’ guide.
Set up a Grafana server. Get it from Grafana. You can then run:
$ ./bin/grafana-server web
By default it will be on localhost:3000. You will have to set IP and port of the Prometheus server. If you didn’t change it, it’s localhost:9090. See also Prometheus’ guide on Grafana.
- Create the dashboard in Grafana. A sample JSON is provided. If you want it to work natively, you will have to name your source ZHMC_Prometheus.
The following image illustrates what the setup described above could look like.
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|
|zhmc_prometheus_exporter-0.2.0-py2.py3-none-any.whl (14.5 kB) Copy SHA256 hash SHA256||Wheel||py2.py3|
|zhmc_prometheus_exporter-0.2.0.tar.gz (37.8 kB) Copy SHA256 hash SHA256||Source||None|