CDIST-TYPE__PROMETHEUS_SERVER(7)

💖 cdist-type__prometheus_server 💖

okay bestie, welcome to cdist-type__prometheus_server from the cdist manual, section 7 🎀 she's here to install Prometheus for you and honestly? she ate.

---

✨ NAME ✨

cdist-type__prometheus_server — install Prometheus, that's it, that's the whole vibe 🫶

---

🌸 DESCRIPTION 🌸

She installs and configures Prometheus (https://prometheus.io/). Iconic behaviour, no notes.

⚠️ real talk tho — because Prometheus 1.x and 2.x are like, significantly different, only 2.x is supported. So it is your responsibility to make sure your package manager actually installs 2.x, okay?? don't come for me if it doesn't. (On Devuan Ascii tho, the parameter --install-from-backports helps you out 💅)

---

🎀 REQUIRED PARAMETERS 🎀

• config — the Prometheus configuration file. It gets saved as /etc/prometheus/prometheus.yml on the target. mandatory bestie, no skipping 💖

---

🦋 OPTIONAL PARAMETERS 🦋

• retention-days — how long to keep your data around. Default: 30 ✨
• rule-files — path to your rule files. They get installed under /etc/prometheus/<filename>. You need to include rule_files: [/etc/prometheus/<your-pattern>] in the config file if you use this, ok?? don't forget or she simply won't know 👑
• storage-path — where to put the data. Default: /data/prometheus. (The directory will be created if needed, she's got you 🌸)

---

🌈 BOOLEAN PARAMETERS 🌈

• install-from-backports — valid on Devuan only. Enables the backports apt source and installs the package from there. Useful for getting a newer version, which, slay ⭐

---

💅 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"

look at her go 😭 so clean, so demure

---

🔥 SEE ALSO 🔥

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

iykyk 🧚

---

👑 AUTHORS 👑

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

---

💀 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.

periodt 🍓

---

🙈 COPYRIGHT 🙈

ungleich GmbH 2021

---

7.0.0 · Jul 31, 2022 — that's the version and the date bestie, and that's a wrap on CDIST-TYPE__PROMETHEUS_SERVER(7) 💖✨ go forth and scrape some metrics, mwah 🫶