metrics-server-debug

Diagnose Kubernetes metrics-server failures and generate structured health reports.

1|1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/dapperdivers/roundtable-arsenal --skill metrics-server-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metrics-server-debug
Source: https://github.com/dapperdivers/roundtable-arsenal/tree/main/infra/metrics-server-debug
Command: npx skills add https://github.com/dapperdivers/roundtable-arsenal --skill metrics-server-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kubectl, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill helps Kubernetes operators identify and resolve metrics-server failures that prevent kubectl top, autoscaling, and monitoring workflows from retrieving cluster metrics.

Core Features & Use Cases

  • Health Diagnostics: Checks metrics-server deployments, pods, API aggregation status, RBAC configuration, and recent logs for common failures.
  • Connectivity & TLS Troubleshooting: Investigates kubelet scraping issues, certificate validation problems, and node communication failures.
  • Use Case: When a Kubernetes cluster reports unavailable metrics or an HPA cannot scale workloads, use this Skill to generate a structured diagnostic report with likely causes and remediation steps.

Quick Start

Run the metrics-server debug skill to analyze the Kubernetes cluster and identify issues affecting metrics collection.

Frequently Asked Questions about metrics-server-debug

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

FAQPage Schema
Why does kubectl top fail with metrics unavailable in Kubernetes?

Kubectl top fails when metrics-server cannot scrape kubelet data or faces TLS, RBAC, or API aggregation errors. This Skill diagnoses those metrics-server failures and generates a structured health report with remediation steps.

How do I troubleshoot metrics-server TLS validation and kubelet connectivity issues?

Troubleshoot metrics-server TLS and kubelet connectivity by checking certificate validation and node communication. This Skill investigates kubelet scraping issues and certificate problems to identify the root cause of metric collection failures.

How do I fix HPA metric retrieval failures when metrics-server is deployed?

Fix HPA metric retrieval failures by analyzing metrics-server deployments, pods, and RBAC configuration. This Skill checks API aggregation status and recent logs to identify why your HPA cannot scale workloads.

Do I need kubectl and jq installed to diagnose Kubernetes metrics-server errors?

Yes, you need kubectl and jq installed to execute automated read-only diagnostics. This Skill relies on these dependencies to analyze your cluster and produce structured health reports for metrics-server failures.

What is the best way to debug Kubernetes metrics-server RBAC misconfigurations?

The best way to debug metrics-server RBAC misconfigurations is running automated read-only diagnostics. This Skill checks RBAC configuration, API aggregation status, and recent logs to locate permission issues blocking metric retrieval.

metrics-server is not working, what are the common limitations and causes to check?

Common causes when metrics-server is not working include kubelet connectivity problems, TLS validation failures, API aggregation failures, and RBAC misconfigurations. This Skill checks deployments and recent logs to pinpoint these specific limitations.