Homelab Monitoring Stack

Operate and troubleshoot a Prometheus, Grafana, Loki, and Alertmanager monitoring stack.

Updated Sep 29, 2025
One-click install
npx skills add https://github.com/LucasSantana-Dev/homelab --skill homelab-monitoring-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Homelab Monitoring Stack
Source: https://github.com/LucasSantana-Dev/homelab/tree/main/.claude/skills/homelab-monitoring
Command: npx skills add https://github.com/LucasSantana-Dev/homelab --skill homelab-monitoring-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive tools and instructions for operating, troubleshooting, and understanding the health of your homelab's monitoring infrastructure, ensuring services are running optimally and alerts are delivered effectively.

Core Features & Use Cases

  • Service Monitoring: Keep track of metrics, logs, and alerts for your homelab services.
  • Troubleshooting: Diagnose issues with Prometheus, Grafana, Loki, and Alertmanager.
  • Log Analysis: Query logs from various services to pinpoint errors or understand behavior.
  • Alert Management: Understand how alerts are configured, routed, and delivered to Discord.
  • Use Case: If you notice gaps in your Grafana dashboards, you can use this Skill to check Prometheus scrape configurations and logs to identify and resolve the issue.

Quick Start

Use the homelab monitoring skill to check the health of the Prometheus service.

Frequently Asked Questions about Homelab Monitoring Stack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot missing metrics in Prometheus and Grafana dashboards?

To troubleshoot missing Prometheus and Grafana metrics, validate scrape configurations and query Loki logs to pinpoint errors. This diagnoses service health issues and identifies exactly why specific metrics are not being collected or displayed.

How do I diagnose Alertmanager routing failures for homelab alerts?

Diagnose Alertmanager routing failures by validating configurations and checking alert delivery status. This Skill troubleshoots how alerts are configured and routed to Discord, ensuring your homelab notifications are delivered effectively.

Do I need Docker and promtool to manage a Loki and Prometheus monitoring stack?

Yes, managing this monitoring stack requires Docker, promtool, amtool, and curl for operational tasks. These tools validate configurations, query logs, and diagnose alert failures across your homelab environment.

What is the best way to check the health of a Prometheus service using watchdog timers?

Check Prometheus service health by running watchdog timers and burn-in status reports. This monitors system health continuously, validating that your homelab infrastructure is running optimally without manual metric inspection.

Why does my homelab monitoring stack show gaps in Grafana dashboards?

Grafana dashboard gaps occur when Prometheus scrape configurations fail or services drop. You can use this Skill to check Prometheus configurations and query Loki logs to identify and resolve the underlying collection issue.

Can I query Loki logs to pinpoint errors across homelab services?

Yes, you can query logs from various services using Loki to pinpoint errors and understand behavior. This log analysis capability is integrated directly into the monitoring stack troubleshooting workflow.