prometheus-formula/docs
semantic-release-bot b042c49075 chore(release): 1.1.0 [skip ci]
# [1.1.0](https://github.com/alxwr/prometheus-formula/compare/v1.0.0...v1.1.0) (2019-04-30)

### Bug Fixes

* **FreeBSD:** elegantly prevent service hang ([a7fad98](https://github.com/alxwr/prometheus-formula/commit/a7fad98)), closes [/github.com/saltstack/salt/issues/44848#issuecomment-487016414](https://github.com//github.com/saltstack/salt/issues/44848/issues/issuecomment-487016414)

### Features

* **args:** handle service arguments the same way ([94078fe](https://github.com/alxwr/prometheus-formula/commit/94078fe))
* **exporters:** added node_exporter ([34ada49](https://github.com/alxwr/prometheus-formula/commit/34ada49))
2019-04-30 20:08:10 +00:00
..
AUTHORS.rst chore(release): 1.1.0 [skip ci] 2019-04-30 20:08:10 +00:00
CHANGELOG.rst chore(release): 1.1.0 [skip ci] 2019-04-30 20:08:10 +00:00
README.rst feat(exporters): added node_exporter 2019-04-29 13:54:40 +02:00

prometheus-formula ================

Travis CI Build Status Semantic Release

Manage Prometheus.

Table of Contents

General notes

See the full SaltStack Formulas installation and usage instructions.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

See Formula Versioning Section for more details.

Contributing to this repo

Please see https://github.com/saltstack-formulas/prometheus-formula/blob/master/docs/CONTRIBUTING.rst

Available states

prometheus ^^^^^^^^^^^^

Meta-state (This is a state that includes other states).

This installs the prometheus package, manages the prometheus configuration file and then starts the associated prometheus service.

prometheus.package ^^^^^^^^^^^^^^^^^^^^

This state will install the prometheus package only.

prometheus.config ^^^^^^^^^^^^^^^^^^^

This state will configure the prometheus service and has a dependency on prometheus.install via include list.

prometheus.service ^^^^^^^^^^^^^^^^^^^^

This state will start the prometheus service and has a dependency on prometheus.config via include list.

prometheus.clean ^^^^^^^^^^^^^^^^^^

Meta-state (This is a state that includes other states).

this state will undo everything performed in the prometheus meta-state in reverse order, i.e. stops the service, removes the configuration file and then uninstalls the package.

prometheus.service.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will stop the prometheus service and disable it at boot time.

prometheus.config.clean ^^^^^^^^^^^^^^^^^^^^^^^^^

This state will remove the configuration of the prometheus service and has a dependency on prometheus.service.clean via include list.

prometheus.package.clean ^^^^^^^^^^^^^^^^^^^^^^^^^^

This state will remove the prometheus package and has a depency on prometheus.config.clean via include list.

prometheus.exporters

This state will manage prometheus exporters according to Pillar prometheus:exporters. It includes sub-states like prometheus.exporters.node. If you don't want to use Pillar data for this you may use the sub-states directly.