https://github.com/khalidit23/grafana
https://github.com/khalidit23/grafana
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/khalidit23/grafana
- Owner: khalidit23
- Created: 2026-04-19T04:55:55.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-19T06:44:22.000Z (about 2 months ago)
- Last Synced: 2026-04-19T07:23:25.645Z (about 2 months ago)
- Size: 2.45 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📡 MikroTik Monitoring Stack (Grafana + Prometheus + VictoriaMetrics)
A complete **Docker-based monitoring stack** for MikroTik devices using:
* 📊 Grafana (Visualization)
* 🔍 Prometheus (Metrics scraping)
* 📡 SNMP Exporter (SNMP → Prometheus)
* 🗄️ VictoriaMetrics (Long-term storage)
---
# 🧠 Architecture Diagram
```
┌──────────────┐
│ MikroTik │
│ Router │
└──────┬───────┘
│ SNMP
▼
┌─────────────────┐
│ SNMP Exporter │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Prometheus │
│ (Collector) │
└────────┬────────┘
│ remote_write
▼
┌──────────────────────────┐
│ VictoriaMetrics │
│ (Long-term Storage) │
└────────┬─────────────────┘
│
▼
┌──────────────┐
│ Grafana │
│ Dashboard UI │
└──────────────┘
```
---
# 📁 Project Structure
```
mikrotik-grafana/
│
├── docker-compose.yml
│
├── prometheus/
│ ├── prometheus.yml
│ └── data/
│
├── snmp_exporter/
│ └── snmp.yml
│
├── victoriametrics-data/
│
└── grafana/
└── provisioning/
└── datasources/
└── victoriametrics.yml
```
---
# 🚀 Quick Start
## 1️⃣ Clone Repository
```bash
git clone https://github.com/YOUR_USERNAME/mikrotik-grafana.git
cd mikrotik-grafana
```
---
## 2️⃣ Start Stack
```bash
docker compose up -d
```
---
## 3️⃣ Access Services
| Service | URL |
| --------------- | -------------------------- |
| Grafana | http://localhost:3000 |
| Prometheus | http://localhost:9090 |
| VictoriaMetrics | http://localhost:8428 |
| VM UI | http://localhost:8428/vmui |
| SNMP Exporter | http://localhost:9116 |
---
# 🔐 Default Login (Grafana)
```
Username: admin
Password: admin
```
---
# 📊 Example Metrics
## CPU Load
```promql
avg(hrProcessorLoad{instance="YOUR_ROUTER_IP"})
```
## RAM Usage %
```promql
(
hrStorageUsed{hrStorageDescr="main memory"}
/
hrStorageSize{hrStorageDescr="main memory"}
) * 100
```
## WAN Traffic
```promql
rate(ifHCInOctets{ifName="ether1-WAN"}[5m]) * 8
```
# 🧱 Features
* 📡 MikroTik SNMP Monitoring
* 📊 Real-time + Historical metrics
* 🗄️ 1 Year Data Retention (VictoriaMetrics)
* 📈 Grafana Dashboards
* ⚡ Lightweight Docker Setup
* 🔧 Easy to extend
---
# ⚙️ Configuration
## Prometheus → VictoriaMetrics
```yaml
remote_write:
- url: http://victoriametrics:8428/api/v1/write
```
---
## VictoriaMetrics Retention
```yaml
--retentionPeriod=12
```
👉 Keeps data for **12 months**
---
# 🎯 Dashboard Layout (Recommended)
## Row 1 (Stat Cards)
* Uptime
* CPU Load
* RAM Usage
## Row 2 (Traffic)
* WAN Traffic
* LAN Traffic
## Row 3 (Advanced)
* WLAN
* VPN / API Traffic
---
# 🔍 How It Works
| Component | Role |
| --------------- | ----------------- |
| SNMP Exporter | Collect SNMP data |
| Prometheus | Scrape & forward |
| VictoriaMetrics | Store metrics |
| Grafana | Visualize data |
---
# 🚀 Future Improvements
* 🔔 Alerting (CPU / Link Down)
* 📜 Loki for Logs
* 🌐 Multi-device Monitoring
* 📊 NOC Dashboard Layout
* ☁️ Cloud Storage Backup
---
# 🛠 Troubleshooting
## Prometheus not starting
```bash
docker logs prometheus
```
## Grafana datasource error
* Ensure only **one `isDefault: true`**
---
# 📚 Resources
* https://grafana.com
* https://prometheus.io
* https://docs.victoriametrics.com
---
# 🧾 License
MIT License
---
# ❤️ Author
**Your Name / GitHub**
---
⭐ If this project helped you, please star the repository!