Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Visualizza le chiamate alla funzione Lambda utilizzando AWS X-Ray
Puoi utilizzarli AWS X-Ray per visualizzare i componenti dell'applicazione, identificare i punti deboli nelle prestazioni e risolvere le richieste che hanno provocato un errore. Le funzioni Lambda inviano dati di traccia a X-Ray e X-Ray elabora i dati per generare una mappa di servizio e riepiloghi di traccia ricercabili.
Se è stata abilitata l'analisi X-Ray in un servizio che richiama la funzione, Lambda invia automaticamente le tracce a X-Ray. Il servizio upstream, ad esempio Amazon API Gateway, o un'applicazione ospitata su Amazon EC2 analizzata con l'SDK X-Ray, campiona le richieste in arrivo e aggiunge un'intestazione di traccia che indica a Lambda di inviare o meno le tracce. Le tracce dei produttori di messaggi upstream, come Amazon SQS, vengono automaticamente collegate alle tracce delle funzioni Lambda downstream, creando end-to-end una visualizzazione dell'intera applicazione. Per ulteriori informazioni, consulta Tracciamento delle applicazioni guidate dagli eventi nella Guida per gli sviluppatori di AWS X-Ray .
Nota
Il tracciamento X-Ray non è attualmente supportato per le funzioni Lambda con Streaming gestito da Amazon per Apache Kafka (Amazon MSK), Apache Kafka gestito dal cliente, Amazon MQ con ActiveMQ e RabbitMQ attivi oppure mappature delle origini degli eventi Amazon DocumentDB.
Per attivare il tracciamento attivo sulla funzione Lambda con la console, attenersi alla seguente procedura:
Per attivare il tracciamento attivo
Aprire la pagina Funzioni
della console Lambda. -
Scegliere una funzione.
Scegliere Configuration (Configurazione) e quindi Monitoring and operations tools (Strumenti di monitoraggio e operazioni).
Scegli Modifica.
-
In X-Ray, attivare Active tracing (Tracciamento attivo).
-
Selezionare Salva.
Prezzi
Puoi utilizzare il tracciamento X-Ray gratuitamente ogni mese fino a un determinato limite come parte del AWS piano gratuito. Oltre la soglia, X-Ray addebita lo storage di traccia e il recupero. Per ulteriori informazioni, consultare Prezzi di AWS X-Ray
La funzione ha bisogno dell'autorizzazione per caricare i dati di traccia su X-Ray. Quando si attiva il tracciamento nella console Lambda, Lambda aggiunge le autorizzazioni necessarie al ruolo di esecuzione della funzione. Altrimenti, aggiungi la AWSXRayDaemonWriteAccess
X-Ray non traccia tutte le richieste nell'applicazione. X-Ray applica un algoritmo di campionamento per garantire che il tracciamento avvenga in modo efficiente, continuando allo stesso tempo a fornire un campione rappresentativo di tutte le richieste. La frequenza di campionamento è di una richiesta al secondo e del 5% delle altre richieste.
Nota
La frequenza di campionamento di X-Ray non può essere configurata per le funzioni.
In X-Ray, una traccia registra informazioni su una richiesta elaborata da uno o più servizi. Lambda registra 2 segmenti per traccia, il che crea due nodi sul grafico del servizio. L'immagine seguente evidenzia questi due nodi:
Il primo nodo a sinistra rappresenta il servizio Lambda che riceve la richiesta di chiamata. Il secondo nodo rappresenta la specifica funzione Lambda. L'esempio seguente mostra una traccia con questi 2 segmenti. Entrambi sono denominati my-function, ma uno ha un'origine di AWS::Lambda e l'altro ha un'origine di. AWS::Lambda::Function Se il AWS::Lambda segmento mostra un errore, il servizio Lambda presentava un problema. Se il AWS::Lambda::Function segmento mostra un errore, la funzione presentava un problema.
La funzione segment (AWS::Lambda::Function) include sottosegmenti perInitialization,Invocation, Restore (Lambda SnapStartsolo) e. Overhead Per ulteriori informazioni, consulta la sezione Ciclo di vita dell'ambiente di esecuzione Lambda.
Nota
X-Ray considera le eccezioni non gestite nella funzione Lambda come stati Error. X-Ray registra gli stati Fault solo quando Lambda presenta errori interni al server. Per maggiori informazioni, consulta Errori, malfunzionamenti ed eccezioni nella Guida per gli sviluppatori di X-Ray.
Il sottosegmento Initialization rappresenta la fase iniziale del ciclo di vita dell'ambiente di esecuzione Lambda. In questa fase, Lambda crea o sblocca un ambiente di esecuzione con le risorse configurate, scarica il codice per la funzione e tutti i livelli, inizializza le estensioni, inizializza il runtime ed esegue il codice di inizializzazione della funzione.
Il sottosegmento Invocation rappresenta la fase di invocazione in cui Lambda richiama il gestore di funzioni. Questo inizia con la registrazione del runtime e dell'estensione e termina quando il runtime è pronto per inviare la risposta.
(Solo Lambda SnapStart) Il sottosegmento Restore mostra il tempo impiegato da Lambda per ripristinare uno snapshot, caricare il runtime (JVM) ed eseguire qualsiasi hook di runtime afterRestore. Il processo di ripristino degli snapshot può includere il tempo dedicato ad attività esterne alla MicroVM. Questa volta è riportato nel segmento secondario Restore. Non ti viene addebitato il tempo trascorso fuori dalla microVM per il ripristino di una snapshot.
Il sottosegmento Overhead rappresenta la fase che si verifica tra il momento in cui il runtime invia la risposta e il segnale per la successiva invocazione. Durante questo periodo, il runtime termina tutte le attività correlate a un'invocazione e si prepara a congelare la sandbox.
Nota
Occasionalmente, potresti notare un ampio divario tra le fasi di inizializzazione e invocazione della funzione nelle tracce X-Ray. Per le funzioni che utilizzano la simultaneità fornita, ciò è dovuto al fatto che Lambda inizializza le istanze della funzione con largo anticipo rispetto all'invocazione. Per le funzioni che utilizzano la concorrenza non riservata (su richiesta), Lambda può inizializzare in modo proattivo un'istanza di funzione, anche in assenza di chiamata. Visivamente, entrambi questi casi si presentano come un intervallo di tempo tra le fasi di inizializzazione e invocazione.
Importante
In Lambda, è possibile utilizzare l'SDK X-Ray per estendere il sottosegmento Invocation con sottosegmenti aggiuntivi per chiamate a valle, annotazioni e metadati. Non è possibile accedere direttamente al segmento di funzione o registrare la parola eseguita al di fuori dell'ambito di chiamata del gestore.
Vedere i seguenti argomenti per un'introduzione specifica della lingua all'analisi in Lambda:
Per un elenco completo dei servizi che supportano la strumentazione attiva, consulta AWS Servizi supportati nella Guida per gli sviluppatori. AWS X-Ray
Sections
Autorizzazioni del ruolo di esecuzione
Lambda richiede le seguenti autorizzazioni per inviare i dati di traccia a X-Ray. Aggiungerle al ruolo di esecuzione della funzione.
Queste autorizzazioni sono incluse nella politica AWSXRayDaemonWriteAccess
Il demone AWS X-Ray
Invece di inviare dati di traccia direttamente all'API X-Ray, l'SDK X-Ray utilizza un processo daemon. Il daemon AWS X-Ray è un'applicazione che viene eseguita nell'ambiente Lambda e ascolta il traffico UDP che contiene segmenti e sottosegmenti. Memorizza i dati in entrata e li scrive su X-Ray in batch, riducendo l'elaborazione e il sovraccarico di memoria necessari per tracciare le chiamate.
Il runtime Lambda consente al daemon di raggiungere fino al 3% della memoria configurata della funzione o 16 MB, a seconda di quale sia maggiore. Se la tua funzione esaurisce la memoria durante l'invocazione, il runtime termina prima il processo daemon per liberare memoria.
Il processo daemon è completamente gestito da Lambda e non può essere configurato dall'utente. Tutti i segmenti generati dalle chiamate di funzione vengono registrati nello stesso account della funzione Lambda. Il daemon non può essere configurato per reindirizzarli a nessun altro account.
Per maggiori informazioni, consulta la sezione sul daemon X-Ray nella Guida per sviluppatori X-Ray.
Abilitazione del tracciamento attivo con l'API Lambda
Per gestire la configurazione di tracciamento con AWS CLI o AWS SDK, utilizza le seguenti operazioni API:
Il AWS CLI comando di esempio seguente abilita il tracciamento attivo su una funzione denominata my-function.
aws lambda update-function-configuration \ --function-name my-function \ --tracing-config Mode=Active
La modalità di tracciamento fa parte della configurazione specifica della versione quando si pubblica una versione della funzione. Non è possibile modificare la modalità di tracciamento in una versione pubblicata.
Abilitazione del tracciamento attivo con AWS CloudFormation
Per attivare il tracciamento su una AWS::Lambda::Function risorsa in un AWS CloudFormation modello, utilizzate la TracingConfig proprietà.
Esempio function-inline.yml
Resources: function: Type: AWS::Lambda::Function Properties:TracingConfig: Mode: Active...
Per una AWS::Serverless::Function risorsa AWS Serverless Application Model (AWS SAM), utilizzate la Tracing proprietà.
Esempio template.yml
Resources: function: Type: AWS::Serverless::Function Properties:Tracing: Active...
