render-debug

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

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/greenmartialarts/EventCore --skill render-debug-greenmartialarts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: render-debug
Source: https://github.com/greenmartialarts/EventCore/tree/main/.junie/skills/render-debug
Command: npx skills add https://github.com/greenmartialarts/EventCore --skill render-debug-greenmartialarts

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, database connection failures—and finding the root cause requires digging through build logs, runtime logs, metrics, and database state. This Skill provides a structured debugging workflow that identifies the error pattern and applies the correct fix. ## Core Features & Use Cases - Log-Based Error Detection: Query build, runtime, and error logs via Render MCP tools or CLI, then match output against a catalog of 15 known error patterns (missing env vars, EADDRINUSE, OOM, health check timeouts, and more). - Metrics and Database Diagnosis: Inspect CPU, memory, HTTP latency, and connection counts, 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, fresh error logs, and request metrics. - Use Case: Your web service keeps crashing after deploy. The skill pulls error logs, detects a KeyError: 'DATABASE_URL', adds the variable via update_environment_variables, and confirms the next deploy goes live. ## Quick Start Ask the AI to debug why your Render service failed to deploy and have it check the logs, metrics, and database connections for the root cause.

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 with list_logs filtered by type build. Match errors against known patterns like missing environment variables or build command failures, apply the fix, and redeploy.

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

Port binding errors happen when the app hardcodes a port or binds to localhost. Read the PORT environment variable and bind to 0.0.0.0 instead, for example app.listen(process.env.PORT, '0.0.0.0') in Node.js.

Why does my Render service crash with exit code 137?

Exit code 137 means the process was killed, almost always due to exceeding the memory limit. Check memory_usage metrics before the crash, then optimize memory usage, process data in 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 -r <service-id> --level error. However, metrics and direct PostgreSQL queries require the Render MCP server configured with an API key.

How do I diagnose slow database queries on Render Postgres?

Query pg_stat_statements through query_render_postgres to find queries with the highest mean execution time, 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 PORT variable, lacks a health endpoint, or starts too slowly. Add a /health route, set healthCheckPath in render.yaml, and defer slow initialization until after the server starts.