16.136. cdist-type__prometheus_server(7)

16.136.1. NAME

cdist-type__prometheus_server - install Prometheus

16.136.2. DESCRIPTION

Install and configure Prometheus (https://prometheus.io/).

Note that due to significant differences between Prometheus 1.x and 2.x, only 2.x is supported. It is your responsibility to make sure that your package manager installs 2.x. (On Devuan Ascii, the parameter --install-from-backports helps.)

16.136.3. REQUIRED PARAMETERS

config

Prometheus configuration file. It will be saved as /etc/prometheus/prometheus.yml on the target.

16.136.4. OPTIONAL PARAMETERS

retention-days

How long to keep data. Default: 30

rule-files

Path to rule files. They will be installed under /etc/prometheus/<filename>. You need to include rule_files: [/etc/prometheus/<your-pattern>] in the config file if you use this.

storage-path

Where to put data. Default: /data/prometheus. (Directory will be created if needed.)

16.136.5. BOOLEAN PARAMETERS

install-from-backports

Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.

16.136.6. EXAMPLES

PROMPORT=9090
ALERTPORT=9093

__prometheus_server \
    --install-from-backports \
    --config "$__manifest/files/prometheus.yml" \
    --retention-days 14 \
    --storage-path /data/prometheus \
    --rule-files "$__manifest/files/*.rules"

16.136.7. SEE ALSO

cdist-type__prometheus_alertmanager(7), cdist-type__grafana_dashboard(7), Prometheus documentation: https://prometheus.io/docs/introduction/overview/

16.136.8. AUTHORS

Kamila Součková <kamila--@--ksp.sk>

16.136.9. COPYING

Copyright (C) 2018 Kamila Součková. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.