render-debug

Diagnose failed Render deployments by analyzing logs, metrics, and PostgreSQL database state.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/DingJun1028/esggo-kv --skill render-debug-dingjun1028
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: render-debug
Source: https://github.com/DingJun1028/esggo-kv/tree/main/.agents/skills/render-debug
Command: npx skills add https://github.com/DingJun1028/esggo-kv --skill render-debug-dingjun1028

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deployments on Render fail for many reasons—missing environment variables, port binding errors, out-of-memory crashes, or database connection failures—and finding the root cause requires digging through logs, metrics, and database state manually. This Skill provides a systematic debugging workflow that identifies the error pattern and applies the correct fix. ## Core Features & Use Cases - Log-Based Error Detection: Query build, runtime, and HTTP error logs via Render MCP tools or CLI, then match errors against a catalog of 15 known patterns (missing env vars, EADDRINUSE, OOM, health check timeouts, and more). - Metrics and Database Diagnosis: Inspect CPU, memory, HTTP latency, and connection metrics, plus run direct PostgreSQL queries to find slow queries, lock contention, and connection pool exhaustion. - Guided Fix and Verification: Apply fixes such as updating environment variables, then verify with deploy status, error logs, and request metrics. - Use Case: Your web service keeps crashing after deploy. The skill pulls error logs, detects a missing DATABASE_URL pattern, adds the variable via update_environment_variables, and confirms the next deploy goes live. ## Quick Start Debug why my Render service failed to deploy and suggest a fix using the logs and metrics.

Frequently Asked Questions about render-debug

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

FAQPage Schema
How do I debug a failed Render deployment?▼

Start by listing recent deploys to find the failure, then retrieve build logs filtered for errors. Match the error against known patterns like missing environment variables or build command failures, apply the fix, and redeploy.

How do I fix EADDRINUSE port binding errors on Render?▼

Port binding errors happen when the app hardcodes a port or binds to localhost. Configure the app to read the PORT environment variable and bind to 0.0.0.0, then push the change to trigger a redeploy.

Why does my Render service crash with exit code 137?▼

Exit code 137 indicates the process was killed, usually from exceeding the memory limit. Check memory usage metrics before the crash, optimize data processing with streams or chunks, or upgrade to a plan with more RAM.

Can I debug Render issues without the MCP server?▼

Yes, the Render CLI works as a fallback for logs and deploy status using commands like render logs and render services. However, metrics queries and direct PostgreSQL queries require the Render MCP server.

How do I find slow PostgreSQL queries on Render?▼

Query pg_stat_statements through the query_render_postgres MCP tool, ordering by mean_exec_time to find the slowest queries. Then check pg_stat_user_tables for tables with high sequential scans that may need indexes.

Why does my Render health check keep timing out?▼

Health check timeouts usually mean the app is not binding to 0.0.0.0 on the correct port, lacks a health endpoint, or starts too slowly. Add a /health endpoint, set healthCheckPath in render.yaml, and defer slow initialization until after the server starts.