Depuración de aplicaciones sin servidor
Descubra técnicas para depurar eficazmente funciones de Lambda, incluidas las pruebas locales, la depuración remota y la interpretación de logs de CloudWatch para resolver problemas.
Depuración de aplicaciones sin servidor es una lección gratuita de Serverless AWS Lambda Development en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Serverless AWS Lambda Development, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Serverless AWS Lambda Development incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Intro to Debugging Lambda
Debugging serverless applications, especially AWS Lambda functions, presents unique challenges. Unlike traditional applications, Lambdas are stateless and ephemeral.
In this lesson, we'll explore practical techniques for effectively identifying and resolving issues in your Lambda functions, from local testing to interpreting logs.
Why Serverless Debugging is Unique
Traditional debugging often involves stepping through code line-by-line using an IDE. With Lambda, this isn't always straightforward because:
- Ephemeral Nature: Functions run only when invoked, then disappear.
- Statelessness: No persistent memory between invocations.
- Distributed Systems: Issues can arise from interactions between many services.
We rely heavily on logs, metrics, and tracing to understand what's happening.
Local Testing with SAM CLI
One of the most effective ways to debug is to test your Lambda functions locally before deploying them to AWS.
The AWS Serverless Application Model (SAM) CLI allows you to invoke your Lambda functions on your local machine, simulating the AWS Lambda runtime environment.
- Faster feedback loop.
- Use your familiar local debugging tools.
SAM CLI Local Invoke Demo
Here's a simple Python Lambda function. For local testing, you can simulate an event and context. Try running it!
import json
def lambda_handler(event, context):
message = event.get('message', 'Hello from Lambda!')
print(f"Received event: {json.dumps(event)}")
print(f"Processing message: {message}")
return {
'statusCode': 200,
'body': json.dumps({'response': message})
}
# This block allows local execution
if __name__ == '__main__':
# Simulate an event
test_event = {'message': 'Local debug test'}
# Simulate a context object
test_context = type('obj', (object,), {'invoked_function_arn': 'local'})()
response = lambda_handler(test_event, test_context)
print("\n--- Lambda Response ---")
print(json.dumps(response, indent=2))
CloudWatch Logs for Debugging
Once your Lambda is deployed, Amazon CloudWatch Logs becomes your primary tool for understanding its behavior and debugging issues.
Every time your Lambda function is invoked, logs are sent to a dedicated log group. Each invocation gets a unique Request ID, which helps trace its execution.
- Log Groups: Contain logs for a specific function.
- Log Streams: Specific instances of your function's logs.
Finding Issues in Logs
When an error occurs, the first place to look is CloudWatch Logs. You can:
- Filter Logs: Search for keywords like "ERROR", "Exception", or specific messages.
- Log Insights: Use powerful query language to analyze logs, group errors, and identify trends.
- Request ID: Use the Request ID from the invocation to find all logs related to a specific execution.
Always check the full stack trace for detailed error information.
Debugging with Log Statements
The simplest yet most powerful debugging technique for Lambda is using print() (Python) or console.log() (Node.js) statements.
By strategically adding log statements, you can track variable values, execution paths, and function state at different points in your code. Let's see an example:
import json
def calculate_discount(price, discount_percentage):
print(f"DEBUG: Initial price: {price}")
if not isinstance(price, (int, float)) or price < 0:
raise ValueError("Price must be non-negative.")
if not isinstance(discount_percentage, (int, float)) or not (0 <= discount_percentage <= 100):
raise ValueError("Discount must be between 0 and 100.")
discount_amount = price * (discount_percentage / 100)
final_price = price - discount_amount
print(f"DEBUG: Final price: {final_price}")
return final_price
def lambda_handler(event, context):
try:
data = json.loads(event['body'])
price = data['price']
discount = data['discount']
final_price = calculate_discount(price, discount)
return {
'statusCode': 200,
'body': json.dumps({'originalPrice': price, 'finalPrice': final_price})
}
except Exception as e:
print(f"ERROR: An error occurred: {e}")
return {
'statusCode': 400,
'body': json.dumps({'error': str(e)})
}
if __name__ == '__main__':
# Test case 1: Valid input
test_event_1 = {'body': json.dumps({'price': 100, 'discount': 10})}
response_1 = lambda_handler(test_event_1, None)
print("\n--- Test Case 1 Response ---")
print(json.dumps(response_1, indent=2))
# Test case 2: Invalid discount
test_event_2 = {'body': json.dumps({'price': 50, 'discount': 110})}
response_2 = lambda_handler(test_event_2, None)
print("\n--- Test Case 2 Response ---")
print(json.dumps(response_2, indent=2))
Understanding Invocation Errors
Lambda functions can fail for various reasons. It's crucial to distinguish between different error types:
- Function Errors: Your code threw an unhandled exception. These appear in CloudWatch Logs with a stack trace.
- Invocation Errors: Issues before your code even runs, like permissions errors or payload size limits. These might not even show up in your function's logs directly.
- Timeout Errors: Your function exceeded its configured execution time.
CloudWatch metrics and X-Ray (another lesson!) help identify these.
Tracing Request Flow
In complex serverless applications, a single request might involve multiple Lambda functions, API Gateway, SQS, DynamoDB, and more.
Understanding the flow of a request across these services is key to debugging. Use the Request ID (often propagated as x-amzn-RequestId or similar) to correlate logs across different components.
AWS X-Ray (covered in a later lesson) provides visual tracing for this purpose.
Best Practices for Debugging
To minimize debugging headaches, adopt these practices:
- Comprehensive Logging: Log inputs, outputs, and key variable states.
- Structured Logging: Use JSON logs for easier parsing and querying.
- Idempotency: Design functions to produce the same result even if invoked multiple times.
- Small Functions: Easier to isolate and test.
- Automated Testing: Unit and integration tests catch issues early.
Debugging Challenge
You have a Lambda function that processes user registration. Users report that sometimes, their registration fails, but you don't see any "ERROR" messages in CloudWatch Logs for your Lambda function.
What is the most likely reason for this, and where should you investigate first?
Recap: Debugging Serverless
We've covered essential techniques for debugging your serverless applications:
- Local testing with SAM CLI for rapid iteration.
- Using CloudWatch Logs to analyze function behavior and identify errors.
- Leveraging log statements to trace execution flow.
- Understanding different types of Lambda errors.
- Best practices for building debuggable serverless functions.
Mastering these will significantly improve your ability to build robust serverless applications.
Preguntas frecuentes
¿La lección «Depuración de aplicaciones sin servidor» es gratis?
Sí — el texto completo de «Depuración de aplicaciones sin servidor» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Serverless AWS Lambda Development, actualiza a CoddyKit PRO. El curso de Serverless AWS Lambda Development incluye 4 lecciones en total.
¿Qué aprenderé en «Depuración de aplicaciones sin servidor»?
Descubra técnicas para depurar eficazmente funciones de Lambda, incluidas las pruebas locales, la depuración remota y la interpretación de logs de CloudWatch para resolver problemas. Practicas Serverless AWS Lambda Development con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Serverless AWS Lambda Development?
No se requiere experiencia previa. Serverless AWS Lambda Development en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Depuración de aplicaciones sin servidor»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Serverless AWS Lambda Development?
Sí. Cada lección de Serverless AWS Lambda Development incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Logs y métricas de CloudWatch
- Gestión de errores y reintentos
- Depuración de aplicaciones sin servidor
- Métricas personalizadas y alarmas de CloudWatch