troubleshoot-nats

Official

Diagnose NATS issues fast with Netdata

Authornetdata
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you rapidly triage NATS outages and performance pathologies by turning symptoms like slow consumer cascades, resource exhaustion, JetStream Raft instability, OOM/memory pressure, and silent message loss into an evidence-based diagnostic path.

Core Features & Use Cases

  • Evidence-driven triage: Guides an agent through a structured diagnostic tree tailored to NATS failure archetypes rather than generic health checks.
  • Netdata + MCP signal querying: Uses Netdata’s NATS collector contexts via MCP to pull the relevant metrics and rank anomalies for the incident window.
  • Remediation verification loop: Re-runs the same MCP queries after applying remediation to confirm signals return to expected ranges, reducing false fixes.
  • Use case: An on-call engineer is paged for a Netdata alert tied to a NATS instance and needs a repeatable workflow to identify root cause and next steps.

Quick Start

Use the skill when investigating NATS slowness or message loss by asking your agent to diagnose the incident using Netdata MCP NATS health signals for the affected node.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: troubleshoot-nats
Download link: https://github.com/netdata/skills/archive/main.zip#troubleshoot-nats

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.