Monitoring Stack

Self-hosted monitoring for Linux servers — Prometheus · Grafana · Alertmanager · Ansible · fail2ban.

One-command deploy, 7 pre-built dashboards, Telegram alerts, multi-server support. Ready in 15 minutes.

---

What's included

---

Dashboards

Pre-built Grafana dashboards for immediate visibility:

---

Quick Start (Docker Compose — 5 minutes)

git clone https://github.com/Airat71/monitoring-stack.git
cd monitoring-stack/prometheus-grafana
cp .env.example .env          # set GRAFANA_PASSWORD
docker compose up -d
# Grafana → http://localhost:3000  (admin / your password)

---

Full Deploy with Ansible (single command)

Deploys the complete stack to your server and optionally installs Node Exporter on any number of additional hosts:

cp ansible/group_vars/all.yml.example ansible/group_vars/all.yml
cp ansible/inventory.example.yml ansible/inventory.yml
# edit both files — set your server IP, SSH user, Telegram token
cd ansible && ansible-playbook -i inventory.yml playbook.yml

Step-by-step: INSTALLATION_GUIDE.md

---

Architecture

  [Monitored hosts]
    Node Exporter  ──┐
    fail2ban        ──┤
                     │
              [Prometheus] ──→ [Alertmanager] ──→ Telegram / Email
                     │
              [Blackbox]   (HTTP/TCP probes)
                     │
               [Grafana]   (Dashboards + Alerts UI)

---

Alerts

20 alert rules covering:

• Host down / unreachable
• CPU · memory · disk thresholds
• Service unavailable (HTTP, TCP probes)
• fail2ban ban events
• Prometheus self-monitoring

See alerts/alertmanager.example.yml for routing configuration.

---

Documentation

Full index: docs/INDEX.md

---

Requirements

---

Repository structure

monitoring-stack/
├── prometheus-grafana/     # Docker Compose stack (Prometheus, Grafana, Alertmanager, Blackbox)
├── ansible/                # Playbook + roles for full automated deployment
├── grafana-dashboards/     # Pre-built dashboard JSON files
├── alerts/                 # Alertmanager routing config example
├── scripts/                # Backup and dashboard fetch scripts
├── fail2ban/               # fail2ban integration guide
├── docs/                   # 20 guides
└── INSTALLATION_GUIDE.md   # Getting started

---

Contributing

PRs and issues are welcome — see CONTRIBUTING.md.

---

License

MIT — free for personal and commercial use.

---

Author

Built and maintained by Airat.