Skip to content
cccskills
Official · AWSFreePublished on GitHub

troubleshooting-application-failures

Diagnose application failures by finding relevant CloudWatch logs and examining error patterns and stack traces. Follow clues into related AWS configuration, identify likely causes, and produce prioritized recommendations for fixing the problem.

OriginalShow the original description

Troubleshoots failing applications by discovering and analyzing CloudWatch log groups to identify error patterns, root causes, and actionable solutions. Use when an application is experiencing failures and log-based diagnosis is needed.

Run score Not tested

See how to install

Good for

  • Investigate application failures using CloudWatch logs
  • Find recurring errors and stack traces
  • Check timeout and permission settings behind errors
  • Prioritize fixes based on investigation findings

Files included (2)

  • SKILL.md1.7 KB
  • references/application-failure-troubleshooting.md16.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Application Failure Troubleshooting

Overview

Domain expertise for diagnosing application failures through CloudWatch log analysis. Discovers relevant log groups, searches for error patterns and stack traces, performs root cause analysis, and generates prioritized remediation recommendations.

Logs are where the investigation starts, not its boundary. When the logs point at a timeout, throttle, retry or permission problem, read the configuration that sets it, for example the API Gateway integration timeout, the queue's visibility timeout, or the function timeout and event source mapping. Read-only access normally includes these Describe and Get calls.

Troubleshoot a failing application

To diagnose and resolve application failures using CloudWatch logs, follow the procedure exactly. See Application failure troubleshooting procedure.

Troubleshooting

No log groups found

Ask the user for specific log group names. Common patterns: /aws/lambda/function-name, /aws/apigateway/api-name, or custom application log groups.

Access denied errors

Verify AWS credentials have logs:DescribeLogGroups, logs:DescribeLogStreams, logs:StartQuery, and logs:GetQueryResults permissions.

Query timeouts

Reduce the time window or limit results. Large log groups may require multiple smaller queries.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-advisor

Official · AWSFreeSummary

Choose where to run an AI agent on AWS through a guided assessment. Develop an architecture and rough cost estimate, then optionally create a migration plan and executable proof of concept to test the proposed setup.

  • Comparing AWS runtimes for an AI agent
  • Planning an existing AI agent's migration to AWS
  • Building an executable proof of concept
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

agents-build

Official · AWSFreeSummary

Extend an existing AgentCore agent with memory across sessions, app integration, browser access, code execution, payments, or collaboration between agents. The skill also guides private network setup, model changes, migration from Bedrock Agent, and resource removal.

  • Add memory across conversations
  • Call an agent from a web or mobile app
  • Coordinate several agents
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

agents-connect

Official · AWSFreeSummary

Connect an AgentCore agent to external APIs, MCP servers, and Lambda tools through AgentCore Gateway. Configure credentials and outbound authentication, and use Cedar policies, rules that control which tools an agent may call.

  • Connecting an agent to an external MCP server
  • Exposing Lambda functions as agent tools
  • Turning an OpenAPI specification into tools
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

agents-debug

Official · AWSFreeSummary

Diagnose AgentCore agent failures by reading logs and traces, records of execution steps. Investigate wrong answers, tool errors, timeouts, and memory problems, or check environment prerequisites when the CLI itself fails.

  • Diagnose wrong answers from an AgentCore agent
  • Find causes of failing tool calls
  • Investigate timeouts and startup errors
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

agents-deploy

Official · AWSFreeSummary

Prepare and troubleshoot AgentCore deployments to AWS by checking configuration, permissions, and deployment changes. Diagnose common failures, choose deployment targets, and manage versions through rollback, version pinning, or canary deployments that gradually introduce a new version.

  • Check configuration and permissions before deployment
  • Diagnose deployment errors
  • Preview changes for a staging deployment
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

agents-get-started

Official · AWSFreeSummary

Create a new agent project on AWS with AgentCore. Get help choosing a framework, generating the project structure, running it locally, and completing the first deployment and invocation, with explanations of the generated files.

  • Create a first agent project on AWS
  • Compare Strands, LangGraph, and other supported frameworks
  • Create and host a new MCP server
aws/agent-toolkit-for-aws3.2KUpdated Oct 24, 2026

See all skills by aws

Report a problem with this skill