Serverless AWS Lambda Development · Lezione

Tracciamento distribuito con AWS X-Ray

Tracciamento distribuito con AWS X-Ray è una lezione Serverless AWS Lambda Development gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Serverless AWS Lambda Development, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Serverless AWS Lambda Development include 4 lezioni in totale.

Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.

Tracing Serverless Requests

In serverless applications, a single user request often travels through many services, like an API Gateway, multiple Lambda functions, and databases. Understanding this journey can be complex!

This is where distributed tracing comes in. It's a technique to track a request as it flows across these different services, providing a complete end-to-end view.

Meet AWS X-Ray

AWS X-Ray is a service that helps developers analyze and debug distributed applications built using microservices. It provides an end-to-end view of requests as they travel through your application.

With X-Ray, you can:

Visualize service interactions.
Identify performance bottlenecks.
Debug errors across distributed systems.

X-Ray Segments Explained

The basic unit of data in X-Ray is a segment. Each service (like a Lambda function or an API Gateway) that's part of your application sends its own segment to X-Ray.

A segment contains information about the work done by that service, including:

The service's name and ID.
Details about the incoming request.
Timing information (start and end times).
Any errors or faults that occurred.

Deeper Dive: Subsegments

Within a service's segment, you can create subsegments for more detailed tracing. Subsegments represent discrete units of work within that service.

For example, a Lambda function's segment might contain subsegments for:

Calls to a database (like DynamoDB).
HTTP requests to an external API.
Specific business logic within your code.

They help pinpoint exactly where time is being spent inside a service.

Traces and The Service Map

All segments and subsegments generated by a single request are grouped together to form a trace. This trace provides a complete, end-to-end view of the request's journey.

X-Ray then uses these traces to generate a service map. This is a visual representation of your application's components and the connections between them, showing latency and error rates.

Enable X-Ray for Lambda

To start tracing your Lambda functions, you first need to enable X-Ray tracing for them. This can be done easily through the AWS Management Console or via Infrastructure as Code (like AWS SAM or CloudFormation).

In the Console:

Go to your Lambda function.
Under 'Configuration', select 'Monitoring and operations tools'.
Edit and enable 'Active tracing' for AWS X-Ray.

This sets up Lambda to send basic function invocation data to X-Ray.

Instrument Python Lambda Code

While enabling X-Ray captures basic data, for deeper insights (like custom subsegments or tracing non-AWS SDK calls), you need to instrument your code using the X-Ray SDK.

Here's a Python example:

from aws_xray_sdk.core import xray_recorder
from aws_xray_sdk.core import patch_all

# Patch all AWS SDK calls automatically
patch_all()

def lambda_handler(event, context):
    # Start a custom subsegment for specific logic
    with xray_recorder.in_subsegment('## my_custom_logic'):
        print("Executing custom business logic...")
        # Simulate some work
        import time
        time.sleep(0.05)

    # Any AWS SDK calls after patch_all() will be automatically traced.
    # For example, a DynamoDB put_item() call.

    return {
        'statusCode': 200,
        'body': 'Hello from Lambda with X-Ray!'
    }

# For local testing (not typically deployed with Lambda)
if __name__ == '__main__':
    print(lambda_handler({}, {}))

Instrument Node.js Lambda Code

Similarly, for Node.js Lambda functions, you use the aws-xray-sdk package to instrument your code. This allows you to capture custom subsegments and ensure AWS SDK calls are traced.

Here's a Node.js example:

const AWSXRay = require('aws-xray-sdk');

// Patch all AWS SDK calls automatically.
// This ensures calls to other AWS services are traced.
AWSXRay.captureAWS(require('aws-sdk'));

exports.handler = async (event, context) => {
    // Get the current segment created by Lambda's X-Ray integration.
    const segment = AWSXRay.getSegment();

    // Create a custom subsegment to trace specific logic.
    if (segment) { // Ensure segment exists for safe local execution
        const customSubsegment = segment.addNewSubsegment('## MyCustomLogic');
        try {
            console.log("Executing custom business logic...");
            await new Promise(resolve => setTimeout(resolve, 50)); // Simulate work
        } finally {
            customSubsegment.close();
        }
    } else {
        console.log("X-Ray segment not found, executing without tracing.");
        await new Promise(resolve => setTimeout(resolve, 50)); // Simulate work
    }

    return {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda with X-Ray!'),
    };
};

// For local execution, you can simulate a call to the handler.
if (require.main === module) {
    console.log("Running handler locally...");
    exports.handler({}, {}).then(result => console.log(result));
}

Reading the Service Map

Once X-Ray collects trace data, you can view the service map in the X-Ray console. This map visually represents your application's components as nodes and their interactions as edges.

Look for:

Nodes: Represent services (Lambda, API Gateway, DynamoDB).
Edges: Show connections and data flow between services.
Colors: Indicate service health (green for healthy, red for errors).
Latency: Visual cues and metrics on edges show request duration.

Pinpointing Bottlenecks

The real power of X-Ray is in identifying performance issues. By examining a trace's timeline, you can see how long each segment and subsegment took to complete.

This helps you:

Identify slow services: Which service is taking the most time?
Find inefficient code: Which subsegment within a function is causing delays?
Detect external dependencies: Is a third-party API call or database query slowing things down?

X-Ray Tracing Check

Let's test your understanding of AWS X-Ray's capabilities.

Tracing the Path Forward

Congratulations! You've learned how AWS X-Ray provides invaluable visibility into your serverless applications.

By enabling X-Ray, instrumenting your code, and interpreting the service map and trace timelines, you can effectively:

Understand complex request flows.
Diagnose latency issues and errors.
Optimize your application's performance.

Embrace X-Ray to build more robust and performant serverless systems!

Domande Frequenti

La lezione «Tracciamento distribuito con AWS X-Ray» è gratuita?

Sì — il testo completo di «Tracciamento distribuito con AWS X-Ray» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Serverless AWS Lambda Development, passa a CoddyKit PRO. Il corso Serverless AWS Lambda Development include 4 lezioni in totale.

Cosa imparerò in «Tracciamento distribuito con AWS X-Ray»?

Implementate e interpretate il tracciamento distribuito con AWS X-Ray per visualizzare il flusso delle richieste attraverso la vostra architettura serverless e identificare i colli di bottiglia delle… Eserciti Serverless AWS Lambda Development con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Serverless AWS Lambda Development?

Non è richiesta alcuna esperienza precedente. Serverless AWS Lambda Development su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Tracciamento distribuito con AWS X-Ray»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Serverless AWS Lambda Development?

Sì. Ogni lezione Serverless AWS Lambda Development include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

Policy e autorizzazioni IAM avanzate
Gestione dei segreti con AWS Secrets Manager
Tracciamento distribuito con AWS X-Ray
Logging strutturato e correlation ID

← Torna a Serverless AWS Lambda Development