📈 Monitoring & Observability

The homelab uses a unified monitoring stack built around Prometheus and Grafana, providing full visibility into compute, storage, networking, and application services. This observability layer acts as the telemetry backbone of the environment, enabling early failure detection, performance analysis, and long‑term capacity planning.

This page serves as the central hub for all monitoring‑related documentation.

📡 Overview

The monitoring pipeline follows a simple, reliable flow:

Services → Exporters → Prometheus → Grafana → Alerts

• Services expose metrics directly or through exporters
• Exporters convert service‑specific data into Prometheus format
• Prometheus scrapes and stores metrics
• Grafana visualizes dashboards and alerts
• Alerting notifies when thresholds or anomalies occur

Prometheus and Grafana are both deployed and managed using Ansible, ensuring consistent, reproducible configuration across the homelab.

🗺️ Homelab-Wide Metrics Architecture

A complete breakdown of how metrics flow across the environment, including exporters, storage systems, Proxmox, Docker media stack, Plex, Pi‑hole, and network devices.

👉 See the full architecture: Homelab-Wide Metrics Architecture

🔥 Prometheus

Prometheus is the metrics collection and storage engine for the homelab. It scrapes exporters across compute, storage, networking, and application layers, storing data in a high‑performance time‑series database.

Prometheus documentation includes:

• How Prometheus works
• Exporters used across the homelab
• Scrape configuration
• Deployment via Ansible
• Integration with Grafana

To read further details, 👉 See the Prometheus page.

📊 Grafana

Grafana provides dashboards, visualizations, and alerting for all Prometheus metrics. It serves as the primary interface for exploring system health, performance trends, and service‑level insights.

Grafana documentation includes:

• Datasource configuration
• Dashboard provisioning
• Alerting setup
• Authentication and reverse proxy integration
• Deployment via Ansible

To read further details, 👉 See the Grafana page.

🖥️ Per‑Service Monitoring

Each major subsystem in the homelab has its own monitoring page:

• Compute
  • Proxmox Monitoring
  • Node Monitoring
  • Docker Monitoring
• Storage
  • Ceph Monitoring
  • Synology Monitoring
  • TrueNAS Monitoring
• Applications
  • Plex Monitoring
  • Media Stack Monitoring (Radarr, Sonarr, Lidarr, Sabnzbd, CalibreWeb, LazyLibrarian)
• Networking
  • Pi-hole Monitoring
  • Network Device Monitoring
• Reverse Proxy
  • Nginx Reverse Proxy Monitoring

These pages document exporters, dashboards, alerts, and troubleshooting workflows.

🚨 Alerting

Alerting is handled through:

• Grafana Unified Alerting
• Optional Prometheus Alertmanager integration

Alerts cover:

• Disk failures
• Container crashes
• Ceph health
• Proxmox node issues
• Network saturation
• DNS failures
• Reverse proxy errors

👉 See: Alerting