troubleshoot-uwsgi

Diagnose uWSGI failure modes using Netdata signals via MCP queries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of quickly triaging uWSGI incidents—such as worker exhaustion, harakiri storms, memory creep, stuck workers, and reload failures—using the same Netdata operator playbook logic but driven through MCP queries.

Core Features & Use Cases

  • Signal-driven diagnostic tree: Guides a coding agent through an 8-domain triage flow aligned to Netdata’s uWSGI operator playbook failure patterns, mapping each symptom to the appropriate rule file and next MCP query.
  • MCP-based verification: Actively queries Netdata via MCP to validate which uWSGI signal contexts are anomalous over a relevant time window, then re-checks after remediation to confirm the fix “holds.”
  • Remediation-focused remediation loop: Recommends corrective actions implied by the playbook/rule file and enforces before/after signal re-verification to avoid false fixes.

Use cases: On-call incident response for a misbehaving uWSGI service, debugging elevated errors/latency/saturation, and investigating unexpected restarts or reload-related failures after deployments.

Quick Start

Use the troubleshoot-uwsgi skill when you ask: "My uWSGI workers are failing—can you diagnose the root cause using Netdata and MCP and tell me what remediation to try."

Frequently Asked Questions about troubleshoot-uwsgi

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

FAQPage Schema
How do I troubleshoot uWSGI worker exhaustion using Netdata metrics?

To troubleshoot uWSGI worker exhaustion with Netdata metrics, query MCP for node discovery and retrieve context-scoped uwsgi.* signals to identify anomalous worker saturation during incident triage.

What causes uWSGI harakiri storms and how can I diagnose them?

uWSGI harakiri storms occur when workers are forcefully killed for exceeding timeouts. Diagnose them by querying Netdata MCP for anomaly ranking across uwsgi.* contexts to pinpoint which workers are consistently timing out.

How do I verify a uWSGI memory creep fix worked after remediation?

Verify a uWSGI memory creep fix by re-querying Netdata MCP to retrieve uwsgi.* metrics and comparing before and after anomaly rankings to confirm the remediation holds under load.

Can I diagnose stuck uWSGI workers and reload failures through MCP queries?

Yes, you can diagnose stuck uWSGI workers and reload failures through MCP queries by applying an 8-domain triage flow that maps symptoms to rule files and retrieves load-bearing uwsgi.* contexts for verification.

Does this uWSGI incident triage method require a specific Netdata setup?

This uWSGI incident triage method requires Netdata metrics to be available and reachable via MCP for the specific host, enabling context-scoped metric retrieval and anomaly ranking during diagnosis.

Why are my uWSGI workers failing after a deployment and how do I find the root cause?

uWSGI workers failing after a deployment often stem from reload failures or memory creep. Find the root cause by using MCP to query Netdata for anomaly ranking across uwsgi.* contexts and applying the operator playbook diagnostic tree.