mesaguy.prometheus
Ansible Prometheus
Installiert und verwaltet den Prometheus-Server, Alertmanager, PushGateway und zahlreiche Prometheus-Exporter.
Dieses Modul wurde entwickelt, um das Hinzufügen neuer Exporter zu erleichtern. Regelmäßige Releases stellen sicher, dass es immer die neueste Prometheus-Software bereitstellt.
Dieses Modul kann Client-Exporter automatisch beim Prometheus-Server registrieren (siehe die Verwaltung von Tgruppen unten).
Voraussetzungen
- Ansible >= 2.8.0
- Fakten müssen gesammelt werden (gather_facts: true)
Unterstützte Software und Betriebssysteme
Unterstützte Betriebssysteme, Distributionen und Architekturen
Dieses Modul soll so viele Distributionen und Architekturen wie möglich unterstützen. Die folgende Tabelle zeigt, welche Kombinationen derzeit getestet werden. Die meisten Exporter funktionieren auch auf ARM-Architekturen:
| OS | Version | Architekturen |
|---|---|---|
| Alpine | 3.2 bis 3.11, edge | x86_64 (amd64) |
| AmazonLinux | 1 und 2 | x86_64 (amd64) |
| ArchLinux | Aktuell | x86_64 (amd64) |
| Enterprise Linux | 6, 7, 8 | x86_64 (amd64) |
| Fedora | 20 bis 31, rawhide | x86_64 (amd64) |
| Gentoo (openrc) | Aktuell | x86_64 (amd64) |
| Gentoo (systemd) | Aktuell | x86_64 (amd64) |
| OpenSUSE | 13.1 bis tumbleweed | x86_64 (amd64) |
| Oracle Linux | 6, 7, 8 | x86_64 (amd64) |
| Ubuntu | 16.04 bis 20.04 | x86_64 (amd64) |
Verwaltete Prometheus-Software
Die folgende Kern-Prometheus-Software wird zusätzlich zu der Liste der untenstehenden Exporter unterstützt. Diese Software wird auf allen unterstützten Betriebssystemen, Distributionen und Architekturen umfassend getestet.
| Prometheus Software | Verwendung | Autor | CI getestet |
|---|---|---|---|
| prometheus | Verwendung | prometheus | Ja |
| alertmanager | Verwendung | prometheus | Ja |
| push_gateway | Verwendung | prometheus | Ja |
Verwaltete Exporter
Alle Exporter werden auf ihre Installation überprüft. Derzeit erhalten ausgewählte Module Tests über CI (Continuous Integration) und Inspec.
Siehe die Nutzungsseite jedes Exporters für weitere Details:
| Exporter | Verwendung | Autor | CI getestet |
|---|---|---|---|
| 389ds_exporter_terrycain | Verwendung | terrycain | Ja |
| apache_exporter_lusitaniae | Verwendung | Lusitaniae | Ja |
| aerospike_exporter_alicebob | Verwendung | alicebob | Ja |
| ... | ... | ... | ... |
Verwaltete node_exporter Textdatei-Skripte
Zahlreiche node_exporter Textdatei-Skripte werden unterstützt und können über die folgenden Variablen installiert werden. Diese Skripte werden standardmäßig unter '/opt/prometheus/scripts' installiert:
| node_exporter Textdatei-Skript | Quelle | Aktivierung der Variablen |
|---|---|---|
| apt.sh | Node Exporter Beispiele | prometheus_script_apt: true |
| ... | ... | ... |
Rollenvariablen
Ein 'prometheus_components' Array wird verwendet, um die zu installierende Prometheus-Software anzugeben.
# Nur zur Demonstration. Clients sollten nur anwendbare Software und Exporter definiert haben:
prometheus_components:
# Kernkomponenten:
- alertmanager
- prometheus
- push_gateway
# Exporter
- 389ds_exporter_terrycain
- apache_exporter_lusitaniae
- ...
Mesaguy-Skript-Dokumentation
- promcron zur Überwachung der Ausführung von Cron-Jobs
- promrun zur Überwachung der Ausführung von Befehlen
- sssd_check zur Überwachung des Status von SSSD
Unternehmensvariablen
Standardmäßig schlägt die Installation fehl, wenn eine Prometheus-Software oder ein Exporter-Binary nicht installiert werden kann. Dies kann durch Setzen der globalen 'prometheus_fallback_to_build'-Boolean oder einer software-spezifischen Überschreibung geändert werden.
Lizenz
MIT Siehe die LICENSE Datei
Autorinformationen
Mesaguy
install and manage prometheus and prometheus exporters
ansible-galaxy install mesaguy.prometheus