app-platform-troubleshooting

Diagnose and fix DigitalOcean App Platform deployment issues via live shell access and log analysis.

35|4|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/digitalocean-labs/do-app-platform-skills --skill app-platform-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: app-platform-troubleshooting
Source: https://github.com/digitalocean-labs/do-app-platform-skills/tree/main/skills/troubleshooting
Command: npx skills add https://github.com/digitalocean-labs/do-app-platform-skills --skill app-platform-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Debugging App Platform deployments is time-consuming and error-prone. This guide provides a structured, practical approach to diagnose, analyze logs, access containers, and apply fixes quickly for DigitalOcean App Platform applications.

Core Features & Use Cases

  • Live shell access to running containers via the do_app_sandbox SDK for interactive debugging
  • Logs analysis for run and build failures, health checks, and performance patterns
  • Debug container workflows to isolate infrastructure versus application issues
  • Quick-reference fixes and escalation guidance to accelerate resolution and prevent regressions

Quick Start

Connect to a running App Platform component with the do_app_sandbox SDK and run a quick health check.

Frequently Asked Questions about app-platform-troubleshooting

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

FAQPage Schema
How do I troubleshoot a failing App Platform deployment?▼

To troubleshoot a failing App Platform deployment, analyze run and build logs, access running containers via the do_app_sandbox SDK live shell, and validate infrastructure to isolate and resolve issues quickly.

How do I access a live shell in an App Platform container for debugging?▼

Access a live shell in an App Platform container by using the do_app_sandbox SDK, which enables interactive debugging and health checks directly within your running deployment components.

What is the best way to analyze App Platform build logs and health checks?▼

Analyzing App Platform build logs and health checks involves reviewing run and build failures alongside performance patterns to identify errors, apply quick-reference fixes, and prevent regressions using guided diagnostics.

Does the doctl CLI support live troubleshooting for App Platform applications?▼

Yes, the doctl CLI supports live troubleshooting for App Platform applications by providing the command-line interface needed to run diagnostics, review logs, and interact with the do_app_sandbox SDK for debugging.

How do I isolate whether an App Platform issue is infrastructure or application-related?▼

To isolate infrastructure versus application issues on App Platform, use debug container workflows and infrastructure validation techniques to determine if the root cause lies in the deployment environment or your code.