📊 Monitoring Stack — Beelink Home Server

Sistema de observabilidad completo desplegado en servidor doméstico Beelink

Monitorización en tiempo real de CPU, RAM, Red y métricas del sistema Linux

---

🏗️ Arquitectura

┌─────────────────────────────────────────────────┐
│                 Beelink Home Server              │
│                                                 │
│  ┌──────────────┐    ┌──────────────┐           │
│  │ Node Exporter│───▶│  Prometheus  │           │
│  │  (métricas)  │    │  (TSDB)      │           │
│  └──────────────┘    └──────┬───────┘           │
│                             │                   │
│                      ┌──────▼───────┐           │
│                      │   Grafana    │           │
│                      │ :3000        │           │
│                      └──────────────┘           │
└─────────────────────────────────────────────────┘

Componente	Rol	Puerto
Node Exporter	Agente de recolección de métricas del sistema	9100
Prometheus	Base de datos de series temporales (TSDB)	9090
Grafana	Visualización y dashboards en tiempo real	3000

---

📸 Galería — Pruebas de Vida

Contenedores activos en el servidor

Dashboard en tiempo real (Grafana)

---

🚀 Despliegue

Prerequisites

• Docker + Docker Compose
• Servidor Linux (local o remoto)

1. Clonar el repositorio

git clone https://github.com/HEO-80/monitoring-stack.git
cd monitoring-stack

2. Levantar el stack

docker-compose up -d

3. Acceder a Grafana

http://localhost:3000

4. Importar el dashboard

En Grafana → Dashboards → Import → ID: 1860 (Node Exporter Full)

---

🕵️ Guía de Verificación Manual

Pasos para reconectar y verificar el estado del sistema desde cero:

1. Conectar al servidor vía SSH

# Alias rápido (configurado en el perfil de terminal)
bee

# O comando completo
ssh heo@192.168.1.139

2. Verificar contenedores activos

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Deben aparecer los 3 contenedores en verde:

Nombre	Estado esperado
grafana	Up X hours
prometheus	Up X hours
node-exporter	Up X hours

3. Acceso a Grafana

URL:      http://192.168.1.139:3000

---

⚙️ Configuración

El stack incluye prometheus.yml con configuración personalizada para conectar los servicios automáticamente sin intervención manual.

Estructura

monitoring-stack/
├── docker-compose.yml      # Orquestación de los 3 servicios
├── prometheus.yml          # Scrape config y targets
├── img/                    # Capturas de pantalla
└── README.md

---

🗺️ Roadmap (Ideas futuras)

• Alertas automáticas vía Telegram (Alertmanager)
• Dashboard personalizado para métricas de Docker
• Monitorización de servicios adicionales (Nginx, bases de datos)
• Acceso remoto seguro via Tailscale / VPN

---

🧑‍💻 Autor

Héctor Oviedo — Backend Developer & Home Lab Enthusiast

---

_{Desplegado en un Beelink Mini PC desde casa · Zaragoza, España 🏠}