troubleshoot-tomcat

Diagnose Apache Tomcat incidents using Netdata MCP metric queries.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/netdata/skills --skill troubleshoot-tomcat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot-tomcat
Source: https://github.com/netdata/skills/tree/main/skills/troubleshoot-tomcat
Command: npx skills add https://github.com/netdata/skills --skill troubleshoot-tomcat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Troubleshoots Apache Tomcat incidents by identifying likely failure archetypes (thread pool exhaustion, heap/GC death spirals, classloader leaks, stuck threads, and connection saturation) using Netdata operator playbook logic and MCP-based signal queries.

Core Features & Use Cases

  • Structured triage for Tomcat archetypes: guides a coding agent through a diagnostic tree aligned to Netdata operator domains (Availability, Throughput, Latency, Errors, Saturation, Internal State).
  • MCP-driven verification using Tomcat metrics: queries Tomcat-relevant Netdata contexts via MCP to validate current symptoms and detect anomalies.
  • Remediation validation loop: re-runs the same verification queries after remediation to confirm the signals return to expected ranges.

Quick Start

Use the troubleshoot-tomcat skill by asking: “Diagnose why my Apache Tomcat instance is timing out and shows rising errors; triage it with Netdata MCP and recommend the most likely fix.”

Frequently Asked Questions about troubleshoot-tomcat

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

FAQPage Schema
How do I troubleshoot Apache Tomcat thread pool exhaustion or stuck threads?

To troubleshoot Tomcat thread pool exhaustion or stuck threads, you match reported symptoms to Netdata operator failure archetypes using MCP queries against Tomcat metrics. This process validates thread pool saturation and recommends targeted remediation.

How does Netdata diagnose Tomcat heap or GC death spirals?

Netdata diagnoses Tomcat heap or GC death spirals by querying anomalous metrics via MCP within the tomcat.* domains. It follows a diagnostic tree to identify resource exhaustion and verify if signals return to normal after remediation.

Can I use MCP to triage Apache Tomcat connection saturation and rising errors?

Yes, you can use MCP to triage Apache Tomcat connection saturation and rising errors. The skill queries Netdata Tomcat contexts to detect anomalies, validate symptoms, and run verification re-queries after recommending a fix.

What is the best way to identify classloader leaks on Tomcat redeploy?

The best way to identify classloader leaks on Tomcat redeploy is applying a structured diagnostic tree. By querying Netdata metrics for internal state anomalies, the skill matches symptoms to classloader leak archetypes and verifies remediation.

Do I need MCP access to query_metrics for Tomcat troubleshooting?

Yes, you need MCP access to query_metrics, find_anomalous_metrics, and list_nodes signals for tomcat.* domains. This access is required to follow the skill's diagnostic tree and verify that Tomcat signals return to expected ranges.

Why is my Apache Tomcat instance timing out and showing rising errors?

Your Apache Tomcat instance timing out with rising errors indicates failure archetypes like thread pool exhaustion or connection saturation. The skill triages these symptoms using Netdata MCP queries to pinpoint the exact failure domain and recommend fixes.