PORTAFOLIO DEVOPS / SRE · LABORATORIO LOCALDEVOPS / SRE PORTFOLIO · LOCAL LAB
DevOps & SRE Observability Platform
Un laboratorio reproducible para observar infraestructura y contenedores, probar el ciclo de alertas y validar configuraciones con evidencia real.
A reproducible lab for infrastructure and container observability, alert lifecycle testing, and configuration validation backed by real evidence.
Alcance basado en configuración y evidencia; no son contadores en vivo.Scope from configuration and evidence; these are not live counters.
01 / PROJECT OVERVIEW
El proyecto conecta métricas de infraestructura con visibilidad operativa, pruebas controladas de incidentes y validaciones repetibles.
The project connects infrastructure metrics to operational visibility, controlled incident tests, and repeatable validation.
CPU, memoria, filesystem, red, uptime y disponibilidad de targets a través de Prometheus y Node Exporter.
CPU, memory, filesystem, network, uptime, and target availability through Prometheus and Node Exporter.
Un proceso Python opcional obtiene snapshots del Docker CLI en el host Windows, filtrados por etiqueta Compose.
An optional Python process collects Docker CLI snapshots on the Windows host, filtered by Compose project label.
Reglas Prometheus, agrupación de Alertmanager y registro persistente de notificaciones FIRING y RESOLVED.
Prometheus rules, Alertmanager grouping, and persistent logging of FIRING and RESOLVED notifications.
Pruebas unitarias y comprobaciones estáticas en runners de GitHub Actions, sin depender de Docker Desktop.
Unit tests and static checks on GitHub Actions runners, independent of Docker Desktop.
IMPLEMENTED STACK
Scraping, reglas y TSDB
Scraping, rules, and TSDB
Dashboards provisionados
Provisioned dashboards
Métricas del Linux del Engine
Docker Engine Linux metrics
Agrupación y notificaciones
Alert grouping and delivery
Webhook interno e historial rotado
Internal webhook and rotated history
Opcional · proceso manual en Windows
Optional · manually started Windows process
Alcance del host: CPU, RAM, red y uptime de Node Exporter representan el Linux que ve Docker Engine/WSL2, no el Windows físico.Host scope: Node Exporter CPU, memory, network, and uptime describe the Linux environment visible to Docker Engine/WSL2, not physical Windows.
02 / DASHBOARD GALLERY
Seis capturas auténticas del laboratorio. Los números reflejan el instante capturado; no son métricas actuales ni una demo cloud en vivo.
Six authentic lab screenshots. Values reflect their capture time; they are not current metrics or a live cloud demo.
KPIs de capacidad, tendencias del host Linux del motor Docker/WSL2 y salud de los dos targets de infraestructura.
Capacity KPIs, Docker Engine/WSL2 Linux host trends, and health for the two infrastructure targets.
Cinco contenedores observados por el exporter host-side, junto a CPU, memoria, red y frescura de la muestra.
Five containers observed by the host-side exporter, with CPU, memory, network, and sample freshness.
La captura muestra 3/3 targets UP; incluye container-exporter además de Prometheus y Node Exporter.
The capture shows 3/3 targets UP, including container-exporter alongside Prometheus and Node Exporter.
Cuatro reglas de infraestructura y TestIncident aparecen INACTIVE durante el estado normal de la captura.
Four infrastructure rules and TestIncident appear INACTIVE while the captured lab is in a normal state.
No había grupos de alertas activos en el momento de captura; la imagen no representa una falla del servicio.
There were no active alert groups at capture time; the image does not indicate a service failure.
Evidencia visual de la ejecución #4. El enlace CI superior lleva a una ejecución más reciente verificada en main.
Visual evidence from run #4. The CI link above points to a newer run verified on main.
Las capturas provienen de `screenshots/` y se incluyen sin recorte ni alteración de datos. Usa el visor accesible para ampliarlas.
Screenshots come from `screenshots/` and are included without cropping or changing their data. Use the accessible viewer to inspect them.
03 / ARCHITECTURE
La solución actual es local. La arquitectura cloud está en diseño y no se ha desplegado ni conectado a este host.
The current solution is local. The cloud architecture is under design and has not been deployed or connected to this host.
Node Exporter observa el Linux del Engine. Prometheus scrapea Node Exporter y sus reglas; Grafana consume Prometheus; Alertmanager reenvía incidentes al logger interno.
Node Exporter observes Engine Linux. Prometheus scrapes Node Exporter and evaluates rules; Grafana reads Prometheus; Alertmanager sends incidents to the internal logger.
Ningún contenedor monta el socket Docker. El exporter en Windows conserva acceso significativo al daemon.No container mounts the Docker socket. The Windows exporter retains significant daemon access.
El portal estático vive por separado del laboratorio. En OCI, un reverse proxy sería la única entrada web; los servicios de métricas quedarían en redes privadas.
The static portfolio is separate from the lab. On OCI, a reverse proxy would be the only web ingress; monitoring services stay on private networks.
El exporter Linux por contenedor queda fuera de la línea base hasta aprobar un límite de permisos seguro.Per-container Linux exporter stays out of the baseline until a safe privilege boundary is approved.
04 / INCIDENT LIFECYCLE
La simulación controlada verifica el flujo de reglas y notificaciones, sin presentar tiempos como un SLO de producción.
Controlled simulations validate alert and notification flow without presenting timings as a production SLO.
Métricas dentro de umbral
Metrics within thresholds
Condición sostenida
Condition sustained
Regla activa
Rule is active
Alertmanager → logger
Alertmanager → logger
Recuperación registrada
Recovery recorded
TestIncident permanece inactiva por defecto. Las capturas muestran un laboratorio en estado normal y sin grupos de alertas activos.
TestIncident stays inactive by default. The screenshots show the lab in a normal state with no active alert groups.
05 / CI & DELIVERY
Ejecución remota consultada para el commit de `main` que etiqueta v1.0.0. No valida esta rama local todavía.
Remote run checked for the `main` commit tagged v1.0.0. It does not validate this local branch yet.
Pruebas unitarias y scripts PowerShell
Unit tests and PowerShell script parsing
SUCCESS · MAINPruebas unitarias y scripts PowerShell
Unit tests and PowerShell script parsing
SUCCESS · MAINLint, dependencias, higiene y secretos
Lint, dependencies, repository hygiene, and secret scan
SUCCESS · MAINDashboards, Compose, Prometheus y Alertmanager
Dashboards, Compose, Prometheus, and Alertmanager
SUCCESS · MAINLa evidencia visual de la galería es la ejecución #4; el enlace lleva a la ejecución #40116633928 para el commit estable actual. No se habilita CD.The gallery image is from run #4; the link opens run #40116633928 for the current stable commit. No CD is enabled.
06 / SECURITY BY DESIGN
El laboratorio está aislado para aprendizaje. Una ruta de observación no debe convertirse en una API de administración expuesta.
The lab is isolated for learning. An observation path must not become an exposed administration API.
Ningún servicio recibe `/var/run/docker.sock`. El exporter host-side usa Docker CLI, pero su usuario mantiene facultades importantes sobre el daemon.
No service receives `/var/run/docker.sock`. The host-side exporter uses Docker CLI, while its user retains significant daemon privileges.
Prometheus, Alertmanager, exporters y webhook no son servicios públicos. La red local de Docker Desktop no equivale a un firewall de aplicación.
Prometheus, Alertmanager, exporters, and webhook are not public services. Docker Desktop networking is not an application firewall.
`.env` y `data/` se excluyen de Git. El portal no usa credenciales, variables secretas, base de datos ni API privada.
`.env` and `data/` are excluded from Git. The portfolio has no credentials, secret variables, database, or private API.
Las capturas son evidencias fechadas. `host.docker.internal` facilita una ruta desde Docker Desktop, pero no autentica al cliente Prometheus.
Screenshots are dated evidence. `host.docker.internal` provides a Docker Desktop route but does not authenticate the Prometheus client.
07 / ROADMAP
La fase cloud se prepara en esta rama local. La etiqueta “planned” describe el despliegue, no una infraestructura online.
Cloud work is being prepared on this local branch. “Planned” describes deployment status, not online infrastructure.
DOCUMENTATION