13.110. cdist-type__prometheus_server(7)¶

13.110.1. NAME¶

cdist-type__prometheus_server - install Prometheus

13.110.2. DESCRIPTION¶

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

13.110.3. REQUIRED PARAMETERS¶

config: Prometheus configuration file. It will be saved as /etc/prometheus/prometheus.yml on the target.
listen-address: Passed as web.listen-address.
alertmanager-url: Passed as alertmanager.url

13.110.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.)
target-heap-size: Passed as storage.local.target-heap-size. Default: 1/2 of RAM.

13.110.5. BOOLEAN PARAMETERS¶

with-daemontools: Create a daemontools service directory under /service/prometheus. Default: yes. Note: If you do not use this, Prometheus will not be launched, and will not reload config on change. If you use this, daemontools (or something compatible) must be installed.

13.110.6. EXAMPLES¶

PROMPORT=9090
ALERTPORT=9093

__daemontools
__golang_from_vendor --version 1.8.1  # required for prometheus and many exporters

require="__daemontools __golang_from_vendor" __prometheus_server \
    --config "$__manifest/files/prometheus.yml" \
    --retention-days 14 \
    --storage-path /data/prometheus \
    --listen-address "[::]:$PROMPORT" \
    --rule-files "$__manifest/files/*.rules" \
    --alertmanager-url "http://monitoring1.node.consul:$ALERTPORT,http://monitoring2.node.consul:$ALERTPORT"

13.110.7. SEE ALSO¶

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

13.110.8. AUTHORS¶

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

13.110.9. COPYING¶

Copyright (C) 2017 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.