5. Appendix
5.1. Troubleshooting
The zhmcclient Troubleshooting section also applies to the exporter project.
There are no additional exporter-specific troubleshooting hints at the moment.
5.2. Glossary
- Exporter
A server application for exposing metrics to Prometheus
- IBM Z
IBM’s mainframe product line
- Prometheus
A server application for monitoring and alerting
- Z HMC
Hardware Management Console for IBM Z
- Jinja2 expression
A Jinja2 expression without surrounding double curly braces.
See https://jinja.palletsprojects.com/en/3.1.x/templates/#expressions for a description.
When putting Jinja2 expressions into YAML files, it is recommended to put the expression into double or single quotes to protect it from being interpreted as YAML. An example where that makes a difference is a Jinja2 expression that is a literal string: The Jinja2 expression
'abc'
must be put into double quotes in YAML to protect the single quotes and becomesvalue: "'abc'"
.- Metric service based metrics
Metrics that are retrieved from the HMC using the “Get Metric Context” operation. For more details, see Available metrics.
- Resource property based metrics
Metrics that are obtained from properties of HMC resources. For more details, see Available metrics.
5.3. Bibliography
- HMC API
The Web Services API of the z Systems Hardware Management Console, described in the following books:
- HMC API 2.11.1
IBM SC27-2616, System z Hardware Management Console Web Services API (Version 2.11.1)
- HMC API 2.12.0
IBM SC27-2617, System z Hardware Management Console Web Services API (Version 2.12.0)
- HMC API 2.12.1
IBM SC27-2626, System z Hardware Management Console Web Services API (Version 2.12.1)
- HMC API 2.13.0
IBM SC27-2627, z Systems Hardware Management Console Web Services API (Version 2.13.0)
- HMC API 2.13.1
IBM SC27-2634, z Systems Hardware Management Console Web Services API (Version 2.13.1)
- HMC API 2.14.0
IBM SC27-2636, IBM Z Hardware Management Console Web Services API (Version 2.14.0)
- HMC API 2.14.1
IBM SC27-2637, IBM Z Hardware Management Console Web Services API (Version 2.14.1)
- HMC API 2.15.0
IBM SC27-2638, IBM Z Hardware Management Console Web Services API (Version 2.15.0) (covers both GA1 and GA2)
- HMC Security