skills.rest
macgregor
macgregorCOMMUNITY
Explore all skills by this author →
GitHub

homelab-investigator

Correlate VictoriaMetrics metrics and VictoriaLogs logs to assess homelab infrastructure health.

10|Updated Jul 30, 2022
Search Tags:#troubleshooting#logs#metrics#observability#diagnostics#homelab#correlation
One-click install
npx skills add https://github.com/macgregor/homelab --skill homelab-investigator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: homelab-investigator
Source: https://github.com/macgregor/homelab/tree/main/.claude/skills/homelab-investigator
Command: npx skills add https://github.com/macgregor/homelab --skill homelab-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate homelab infrastructure health by querying VictoriaMetrics (metrics) and VictoriaLogs (logs). Read-only analysis -- query, correlate, classify, recommend.

Core Features & Use Cases

  • Health snapshot and phase-driven diagnostics across nodes, pods, infrastructure, and logs.
  • Cross-subsystem correlation to identify root causes and validate findings with evidence.
  • Reusable workflow and commands via the obs-query tool and referenced docs for consistent investigations.

Quick Start

Run the health overview to begin a system health check across all nodes.

Frequently Asked Questions about homelab-investigator

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

FAQPage Schema
How do I troubleshoot homelab infrastructure health using VictoriaMetrics and VictoriaLogs?▼

Homelab health troubleshooting queries VictoriaMetrics and VictoriaLogs to correlate metrics and logs. It identifies root causes across nodes, pods, storage, and networks by cross-referencing signals to validate findings with evidence.

What is the best way to diagnose Raspberry Pi cluster node issues from metrics and logs?▼

Diagnosing Raspberry Pi cluster node issues requires correlating VictoriaMetrics metrics with VictoriaLogs data. The process uses a phase-driven diagnostic workflow to assess node health, pod issues, and storage constraints with read-only queries.

Can I investigate NAS and router health problems using read-only observability data?▼

Investigating NAS and router health problems uses read-only observability data by querying VictoriaMetrics and VictoriaLogs. It classifies infrastructure issues and validates findings with evidence without modifying the live environment.

How do I correlate metrics and logs to find the root cause of pod issues?▼

Correlating metrics and logs to find pod issue root causes involves cross-subsystem analysis using the obs-query tool. It matches VictoriaMetrics health signals with VictoriaLogs entries to pinpoint and validate failures.

Does homelab observability require write access to VictoriaMetrics and VictoriaLogs?▼

Homelab observability does not require write access, as it relies entirely on read-only analysis. It queries VictoriaMetrics and VictoriaLogs to assess infrastructure health, classify issues, and recommend fixes without modifying data.

Related Skills

Explore More Data & Analytics Skills→
VictoriaMetricsVictoriaMetrics
45

investigating-with-observability

Correlate metrics, logs, and traces to investigate Kubernetes incidents.

Official
Advanced
openeuler-mirroropeneuler-mirror
3

fault-rca-report-generation

Generate structured root cause analysis reports from system logs and performance metrics.

Official
Advanced
zangxin75zangxin75

prometheus-configuration

Configure Prometheus for metric collection, storage, and alerting via Helm and Docker Compose.

Community
Advanced
wanghao9610wanghao9610
39

star-expt-analyst

Audit AI experiment runs by verifying artifacts, logs, and metrics against plan criteria.

Community
Advanced