
Skill
debugging-lambda-timeouts
debug AWS Lambda function timeouts
Description
Debugs AWS Lambda function timeout failures by systematically analyzing function configuration, CloudWatch logs and metrics, VPC/networking, cold starts, memory constraints, and downstream dependencies to identify root causes with actionable fixes. Use when a Lambda function is timing out or approaching its timeout limit.
SKILL.md
Debugging Lambda Timeouts
Overview
Domain expertise for systematically investigating AWS Lambda function timeout failures by analyzing function configuration, CloudWatch logs, metrics, dependencies, cold start patterns, and code. Identifies common causes such as insufficient timeout settings, external service delays, database connection issues, memory constraints, and inefficient code patterns, then provides prioritized recommendations.
Debug a Lambda timeout
To investigate and resolve Lambda timeout issues, follow the procedure exactly. See Lambda timeout debugging procedure.
The procedure collects function configuration, CloudWatch metrics and logs, dependency analysis, and cold start patterns. If Lambda code is provided, it also reviews the code for timeout-prone patterns. Results are compiled into a structured debugging report with prioritized recommendations.
Troubleshooting
Function not found
Verify the function name and region. Use aws lambda list-functions --region <region>
to list available functions.
No logs available
The function may not have been invoked recently or logging may be disabled. Check the function's log group configuration and invocation metrics.
Access denied errors
Verify AWS credentials have permissions for Lambda, CloudWatch Logs, and CloudWatch Metrics. See the full procedure for details.
Log query time range issues
If CloudWatch Logs Insights queries fail with time range errors, reduce the analysis window or check log group retention settings. See the full procedure for details.
More skills from the agent-toolkit-for-aws repository
View all 100 skillsagents-build
add capabilities to existing agent projects
Jul 12AgentsAutomationAWSEngineeringagents-connect
connect agents to external services
Jul 16AgentsAPI DevelopmentAuthenticationAWSagents-debug
debug agent and environment issues
Jul 16AgentsAWSDebuggingObservabilityagents-deploy
deploy AI agents to AWS
Jul 12AgentsAWSCI/CDDeploymentagents-get-started
scaffold and deploy new agent projects
Jul 12AgentsAWSDeploymentagents-harden
harden agents for production
Jul 16AgentsAWSBest PracticesSecurity
More from AWS (Amazon)
View publisheragents-optimize
optimize agent quality and performance
agent-toolkit-for-aws
Jul 12AgentsAWSEvalsObservability +1amazon-aurora-mysql
manage Amazon Aurora MySQL clusters
agent-toolkit-for-aws
Jul 12AWSDatabaseMySQLServerlessamazon-aurora-postgresql
configure Amazon Aurora PostgreSQL clusters
agent-toolkit-for-aws
Jul 16AWSDatabasePostgreSQLServerlessamazon-bedrock
build generative AI apps with Amazon Bedrock
agent-toolkit-for-aws
Jul 19AgentsAWSLLMamazon-documentdb
manage Amazon DocumentDB clusters
agent-toolkit-for-aws
Jul 12AWSDatabaseMongoDBNoSQLamazon-dynamodb
design and debug DynamoDB data layers
agent-toolkit-for-aws
Jul 16AWSDatabaseNoSQL