kiennt26/ansitheus repository overview

⁠Ansitheus

---

⁠ ⁠ ⁠

Table of contents:

• 1. Overview⁠
  • 1.1. Features⁠
  • 1.2. Components⁠
  • 1.3. Tested environment⁠
• 2. Documentation⁠
• 3. Contributors⁠

⁠1. Overview

Ansitheus's mission is to provide production-ready containers and deployment tools for operating Prometheus⁠ monitoring system. Ansitheus is highly opinionated out of the box, but allows for complete customization. This permits operators with minimal experience to deploy Prometheus quickly and as experience grows modify the Prometheus configuration to suit the operator’s exact requirements.

It is highly inspired by kolla-ansible⁠.

If you want to deploy Prometheus monitoring system as systemd service, you may want to take a look at Ansible Collection for Prometheus⁠.

⁠1.1. Features

• Allow to configure & setup the system from scratch (prepare local repostiory, install necessary packages, configure Docker daemon...).
• Deploy & configure full Prometheus⁠ monitoring system using Ansible⁠.
• Containerize Prometheus components.
• Support flexible High-availability deployment.
  • You can deploy mutiple Prometheus instances.
  • Sometimes Prometheus scrape process can cause high load on the target. Therefore, it should be only one instance scrape at time. Ansitheus supports us to deploy "stand-by" Prometheus instance which is only started if the "primary" instance was down.
• Highly flexible & configurable components.
• Support Docker private registry.
• Support Ansible vault.

⁠1.2. Components

Ansitheus allows users to configure & deploy the following components:

• Prometheus Server⁠
• Prometheus Alertmanager⁠
• Prometheus Node-exporter⁠
• Prometheus Mysqld-exporter⁠
• Prometheus Openstack-exporter⁠
• Google Cadvisor⁠
• Haproxy⁠
• Keepalived⁠
• Grafana⁠
• Other Prometheus exporters - TODO

⁠1.3. Tested environment

• CentOS 7
• Ubuntu 22.04

⁠2. Documentation

• Deployment philosophy: Ansitheus shares the same philosophy with Kolla-ansible⁠.
• Quickstart⁠.
• Troubleshooting guide⁠.

⁠3. Contributors

1. Kien Nguyen⁠
2. Dat Vu⁠
3. Duc Nguyen⁠
4. Long Cao⁠