PluginBench
Skill
Pass
Audit score 90

troubleshooting-application-failures

aws/agent-toolkit-for-aws

Diagnose application failures by analyzing CloudWatch logs for error patterns and root causes.

What is troubleshooting-application-failures?

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.

  • Discovers relevant CloudWatch log groups automatically
  • Searches for error patterns and stack traces in logs
  • Performs root cause analysis on application failures
  • Generates prioritized remediation recommendations
  • Handles large log groups with optimized query strategies

How to install troubleshooting-application-failures

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill troubleshooting-application-failures
Prerequisites
  • AWS credentials configured with logs:DescribeLogGroups, logs:DescribeLogStreams, logs:StartQuery, and logs:GetQueryResults permissions
  • Access to CloudWatch Logs in your AWS account
  • Knowledge of your application's log group naming conventions
Claude Code
Cursor
Windsurf
Cline

How to use troubleshooting-application-failures

  1. 1.Provide the application name or specific log group names to analyze
  2. 2.Follow the Application failure troubleshooting procedure to guide the diagnosis
  3. 3.Allow the skill to discover and query relevant log groups
  4. 4.Review identified error patterns and root cause analysis
  5. 5.Implement the prioritized remediation recommendations provided

Use cases

Good for
  • Diagnose Lambda function failures using CloudWatch Logs
  • Investigate API Gateway errors and performance issues
  • Analyze custom application log groups for error patterns
  • Identify root causes of recurring application failures
  • Generate actionable remediation steps from log analysis
Who it's for
  • DevOps engineers
  • Application support teams
  • Backend developers troubleshooting production issues
  • AWS infrastructure operators

troubleshooting-application-failures FAQ

What if no log groups are found?

Provide specific log group names. Common patterns include /aws/lambda/function-name, /aws/apigateway/api-name, or your custom application log group names.

What permissions are required?

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

How are large log groups handled?

The skill reduces time windows or limits results for large log groups. Multiple smaller queries may be required to avoid timeouts.

Can it analyze custom application logs?

Yes, it can analyze any CloudWatch log group, including custom application logs beyond AWS services.

Full instructions (SKILL.md)

Source of truth, from aws/agent-toolkit-for-aws.


name: troubleshooting-application-failures 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. version: 1

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.

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.