Ansible Prometheus

Устанавливает и управляет сервисом Prometheus, Alertmanager, PushGateway и множеством экспортеров Prometheus.

Эта роль разработана для того, чтобы легко добавлять новых экспортеров. Регулярные релизы обеспечивают всегда актуальное программное обеспечение Prometheus.

Эта роль может регистрировать клиентские экспортеры на сервере Prometheus автоматически (см. управление группами ниже).

Требования

• Ansible >= 2.8.0
• Необходимо собрать факты (gather_facts: true)

Поддерживаемое ПО и операционные системы

Поддерживаемые операционные системы, дистрибутивы и архитектуры

Этот модуль предназначен для поддержки как можно большего количества дистрибутивов и архитектур. В следующей таблице указаны комбинации, которые в настоящее время тестируются. Большинство экспортеров также будут работать на архитектурах ARM:

ОС	Версия	Архитектуры
Alpine	3.2 до 3.11, edge	x86_64 (amd64)
AmazonLinux	1 и 2	x86_64 (amd64)
ArchLinux	Текущая	x86_64 (amd64)
Enterprise Linux	6, 7, 8	x86_64 (amd64)
Fedora	20 до 31, rawhide	x86_64 (amd64)
Gentoo (openrc)	Текущая	x86_64 (amd64)
Gentoo (systemd)	Текущая	x86_64 (amd64)
OpenSUSE	13.1 до tumbleweed	x86_64 (amd64)
Oracle Linux	6, 7, 8	x86_64 (amd64)
Ubuntu	16.04 до 20.04	x86_64 (amd64)

Управляемое ПО Prometheus

Следующее основное ПО Prometheus поддерживается помимо списка экспортеров ниже. Это ПО полноценно тестируется на всех поддерживаемых ОС, дистрибутивах и архитектурах.

ПО Prometheus	Использование	Автор	CI протестировано
prometheus	использование	prometheus	Да
alertmanager	использование	prometheus	Да
push_gateway	использование	prometheus	Да

Управляемые экспортеры

Все экспортеры проверены на установку. В настоящее время некоторые модули проходят тестирование через CI (непрерывная интеграция) и Inspec.

См. страницу использования каждого экспортера для получения дополнительных сведений:

Экспортер	Использование	Автор	CI протестировано
389ds_exporter_terrycain	использование	terrycain	Да
apache_exporter_lusitaniae	использование	Lusitaniae	Да
aerospike_exporter_alicebob	использование	alicebob	Да
bigip_exporter_expressenab	использование	ExpressenAB	Да
... (и так далее для остальных экспортеров) ...

Скрипты текстовых файлов управляемого node_exporter

Поддерживается множество скриптов для node_exporter и их можно установить через следующие переменные. Эти скрипты по умолчанию устанавливаются по пути '/opt/prometheus/scripts':

Скрипт node_exporter	Источник	Переменная для включения
apt.sh	примеры node_exporter	prometheus_script_apt: true
btrfs_stats.py	примеры node_exporter	prometheus_script_btrfs_stats: true
... (и так далее для остальных скриптов) ...

Переменные роли

Переменная 'prometheus_components' используется для указания ПО Prometheus для установки. Этот пример устанавливает все поддерживаемые компоненты prometheus:

# Только для демонстрации. Клиенты должны иметь только применимое ПО и экспортеры:
prometheus_components:
 # Основные компоненты:
 - alertmanager
 - prometheus
 - push_gateway
 # Экспортеры
 - 389ds_exporter_terrycain
 - apache_exporter_lusitaniae
 - ... (и так далее для остальных экспортеров) ...

Документация по скриптам Mesaguy

• promcron для мониторинга выполнения задач cron
• promrun для мониторинга выполнения команд
• sssd_check для мониторинга состояния SSSD

Общие переменные

По умолчанию, если установка бинарного файла ПО Prometheus или экспортера не удалась, установка завершается неудачей. Этот параметр можно переопределить, вызвав установку из исходников, установив глобальную переменную 'prometheus_fallback_to_build' или специфическое переоположение ПО. Например, чтобы разрешить экспортеру blackbox_exporter собираться из исходников, если бинарный файл не найден:

prometheus_blackbox_exporter_fallback_to_build: true

... (и так далее, продолжая переводить оставшуюся часть текста) ...

Лицензия

MIT Смотрите файл LICENSE

Информация об авторе

Mesaguy

• https://github.com/mesaguy