mcpField
T
troubleshooting-application-failures

troubleshooting-application-failures

github.com/awsCloud & DevOps3.3k6.6k installsUpdated 1d ago
Repository

About troubleshooting-application-failures

A troubleshooting skill for diagnosing application failures from CloudWatch logs. It finds relevant log groups, analyzes errors and stack traces, checks related configuration, and prioritizes remediation recommendations.

Key features

  1. 01Discover relevant log groups
  2. 02Search errors and stack traces
  3. 03Analyze root causes
  4. 04Inspect related configuration
  5. 05Prioritize remediation recommendations

Use cases

  1. 01Investigating application errors in CloudWatch
  2. 02Tracing timeout or throttling problems
  3. 03Checking permissions and retry configuration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-application-failures

After installing, type/troubleshooting-application-failuresin Claude Code to confirm it loaded.

Bundled filesreferences/application-failure-troubleshooting.md

Details

From the project README

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.

Comments

Markdown supported