Strumentazione del codice Ruby in AWS Lambda

Lambda si integra con AWS X-Ray per consentirti di tracciare, eseguire il debug e ottimizzare le applicazioni Lambda. È possibile utilizzare X-Ray per tracciare una richiesta mentre attraversa le risorse dell'applicazione, dal frontend allo storage e API al database sul backend. Aggiungendo semplicemente la SDK libreria X-Ray alla configurazione di build, è possibile registrare errori e latenza per ogni chiamata effettuata dalla funzione a un servizio. AWS

Dopo aver configurato il tracciamento attivo, è possibile osservare richieste specifiche tramite l'applicazione. Il grafico dei servizi X-Ray mostra informazioni sull'applicazione e tutti i suoi componenti. L'esempio seguente mostra un'applicazione con due funzioni. La funzione principale elabora gli eventi e talvolta restituisce errori. La seconda funzione in alto elabora gli errori che compaiono nel gruppo di log della prima e utilizza X-Ray, Amazon Simple Storage Service (Amazon S3) e Amazon Logs. AWS SDK CloudWatch

Per attivare il tracciamento attivo sulla funzione Lambda con la console, attenersi alla seguente procedura:

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 AWSXRayDaemonWriteAccesspolicy al ruolo di esecuzione.

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. Non puoi configurare la frequenza di campionamento dei raggi X per le tue 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.

Questo esempio espande il AWS::Lambda::Function segmento per mostrarne i tre sottosegmenti.

Il segmento di funzioni vecchio stile contiene i seguenti sottosegmenti:

Il segmento di funzione di nuovo stile non contiene un sottosegmento. Invocation I sottosegmenti dei clienti vengono invece collegati direttamente al segmento di funzioni. Per ulteriori informazioni sulla struttura dei segmenti di funzione di vecchio e nuovo stile, vedere. Informazioni sui monitoraggi di X-Ray

È possibile strumentare il codice del gestore per registrare i metadati e tracciare le chiamate a valle. Per registrare i dettagli delle chiamate effettuate dal gestore verso altre risorse e servizi, utilizzate SDK X-Ray for Ruby. Per ottenere ilSDK, aggiungete il aws-xray-sdk pacchetto alle dipendenze dell'applicazione.

# Gemfile
source 'https://rubygems.org'

gem 'aws-xray-sdk', '0.11.4'
gem 'aws-sdk-lambda', '1.39.0'
gem 'test-unit', '3.3.5'

Per strumentare AWS SDK i client, richiedi il aws-xray-sdk/lambda modulo dopo aver creato un client nel codice di inizializzazione.

# lambda_function.rb
require 'logger'
require 'json'
require 'aws-sdk-lambda'
$client = Aws::Lambda::Client.new()
$client.get_account_settings()

require 'aws-xray-sdk/lambda'

def lambda_handler(event:, context:)
  logger = Logger.new($stdout)
  ...

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.

Questo esempio espande il AWS::Lambda::Function segmento per mostrarne i tre sottosegmenti.

Il segmento di funzioni vecchio stile contiene i seguenti sottosegmenti:

Il segmento di funzione di nuovo stile non contiene un sottosegmento. Invocation I sottosegmenti dei clienti vengono invece collegati direttamente al segmento di funzioni. Per ulteriori informazioni sulla struttura dei segmenti di funzione di vecchio e nuovo stile, vedere. Informazioni sui monitoraggi di X-Ray

È inoltre possibile strumentare HTTP i client, registrare SQL le interrogazioni e creare sottosegmenti personalizzati con annotazioni e metadati. Per ulteriori informazioni, vedere The X-Ray SDK for Ruby nella Developer Guide. AWS X-Ray

Abilitare il tracciamento attivo con Lambda API

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à.

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à.

Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      Tracing: Active
      ...

Memorizzazione delle dipendenze di runtime in un layer

Se utilizzate X-Ray SDK per strumentare AWS SDK i client del codice della funzione, il pacchetto di implementazione può diventare piuttosto grande. Per evitare di caricare le dipendenze di runtime ogni volta che aggiorni il codice della funzione, impacchetta X-Ray in SDK un layer Lambda.

L'esempio seguente mostra una AWS::Serverless::LayerVersion risorsa che memorizza X-Ray SDK for Ruby.

Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: function/.
      Tracing: Active
      Layers:
        - !Ref libs
      ...
  libs:
    Type: AWS::Serverless::LayerVersion
    Properties:
      LayerName: blank-ruby-lib
      Description: Dependencies for the blank-ruby sample app.
      ContentUri: lib/.
      CompatibleRuntimes:
        - ruby2.5

Con questa configurazione, si aggiorna il livello della libreria solo se si modificano le dipendenze di runtime. Poiché il pacchetto di implementazione della funzione contiene solo il codice, questo può contribuire a ridurre i tempi di caricamento.

La creazione di un layer per le dipendenze richiede modifiche alla compilazione per generare l'archivio dei layer prima della distribuzione. Per un esempio funzionante, vedere l'applicazione di esempio blank-ruby .