Prometheus Exporter for Salt highstate metrics run from the Salt master.
Project description
Prometheus Exporter for Salt highstate metrics run from the Salt master. The exporter must have permissions to execute commands locally.
Note: Python 2 is not supported. Instead use Python 3.8 or higher.
Prerequisites
Install salt
Be on the salt master node
Configuration
usage: main.py [-h] [--listen-addr LISTEN_ADDR] [--listen-port LISTEN_PORT] [--highstate-interval HIGHSTATE_INTERVAL] [--batch-size BATCH_SIZE] [--salt-target SALT_TARGET] [--log-level LOG_LEVEL] optional arguments: -h, --help show this help message and exit --listen-addr LISTEN_ADDR Address to bind to --listen-port LISTEN_PORT Port to bind to --highstate-interval HIGHSTATE_INTERVAL Seconds between each highstate test run --batch-size BATCH_SIZE Batch size to use in salt --salt-target SALT_TARGET Salt target to be used --log-level LOG_LEVEL log level
Metrics
Currently, the exporter exposes metrics for highstate conformity only:
Metric |
Description |
---|---|
saltstack_states_total |
Number of states which apply to the minion in highstate |
sa ltstack_nonhigh_states |
Number of states which would change on state.highstate |
saltstack_error_states |
Number of states which returns an error on highstate dry-run |
salt_highstate_error |
Error in trying to apply highstate |
sa ltstack_last_highstate |
Timestamp of the last highstate test run |
Output
# HELP saltstack_last_highstate_total Timestamp of the last highstate test run
# TYPE saltstack_last_highstate_total counter
saltstack_last_highstate_total 1.674730426e+09
# HELP saltstack_states_total Number of states which apply to the minion in highstate
# TYPE saltstack_states_total gauge
saltstack_states_total{minion="3.mymachine"} 253.0
# HELP saltstack_nonhigh_states Number of states which would change on state.highstate
# TYPE saltstack_nonhigh_states gauge
saltstack_nonhigh_states{minion="3.mymachine"} 0.0
# HELP saltstack_error_states Number of states which returns an error on highstate dry-run
# TYPE saltstack_error_states gauge
saltstack_error_states{minion="3.mymachine"} 0.0
# HELP saltstack_states_total Number of states which apply to the minion in highstate
# TYPE saltstack_states_total gauge
saltstack_states_total{minion="3.mymachine"} 253.0
saltstack_states_total{minion="2.mymachine"} 253.0
# HELP saltstack_nonhigh_states Number of states which would change on state.highstate
# TYPE saltstack_nonhigh_states gauge
saltstack_nonhigh_states{minion="3.mymachine"} 0.0
saltstack_nonhigh_states{minion="2.mymachine"} 0.0
# HELP saltstack_error_states Number of states which returns an error on highstate dry-run
# TYPE saltstack_error_states gauge
saltstack_error_states{minion="3.mymachine"} 0.0
saltstack_error_states{minion="2.mymachine"} 0.0
# HELP saltstack_states_total Number of states which apply to the minion in highstate
# TYPE saltstack_states_total gauge
saltstack_states_total{minion="3.mymachine"} 253.0
saltstack_states_total{minion="2.mymachine"} 253.0
saltstack_states_total{minion="1.mymachine"} 253.0
# HELP saltstack_nonhigh_states Number of states which would change on state.highstate
# TYPE saltstack_nonhigh_states gauge
saltstack_nonhigh_states{minion="3.mymachine"} 0.0
saltstack_nonhigh_states{minion="2.mymachine"} 0.0
saltstack_nonhigh_states{minion="1.mymachine"} 0.0
# HELP saltstack_error_states Number of states which returns an error on highstate dry-run
# TYPE saltstack_error_states gauge
saltstack_error_states{minion="3.mymachine"} 0.0
saltstack_error_states{minion="2.mymachine"} 0.0
saltstack_error_states{minion="1.mymachine"} 0.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for prometheus-salt-exporter-0.1.0rc1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1e43749a64d502300edf6e9e1ce98a62b4d2c6ecd540113891a6d7cf990adcc1 |
|
MD5 | a7009c420b1c075809dc5597522a3106 |
|
BLAKE2b-256 | 29f8dd828e0e91a252d412a70cb606a7ed9cf395bcddd8fdecbacead18f644a3 |
Hashes for prometheus_salt_exporter-0.1.0rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5fa71bc11cb42cc4ee43680f760433158d8dad4533c4c21a27e8486fe7b3b25 |
|
MD5 | 09be018723a366a5a0fedcecdeca68df |
|
BLAKE2b-256 | 1c0763cf777217c270dd474ad610c0a435c67a920680a4992a90efd16717a4e0 |