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.