aws-xray-lambda-nodejs

Demo para analizar aplicaciones con AWS x-ray con el que podrías encontrar la causa raíz de los problemas y/o rendimiento.

Arquitectura

Está demo tiene como origen un bucket en S3, cuando se sube un archivo a s3 se ejecuta la función lambda que inserta los datos del archivo subido a DynamoDB

Instalar DEMO

Para probar está demo solo debes ejecutar la plantilla en CloudFormation para crear los recursos, donde se utiliza S3 como trigger para ejecutar una función Lambda quien inserta un registro en DynamoDB, todo este proceso está monitoreado por AWS x-ray.

El código fuente se encuentra publicado en nuestro bucket de la región Virginia.

aws cloudformation deploy --template-file template.yaml --stack-name aws-xray-lambda-nodejs --capabilities CAPABILITY_NAMED_IAM --region us-east-1

Instalación personalizada

Se instala el SDK del X-Ray con npm

npm install aws-xray-sdk

Puedes instalar el módulo de X-Ray con npm usando un contenedor chainio/lambda-ci-nodejs6.10

docker run -ti --privileged -v C:\Users\rctaptap\laboratorios:/data --name node_01 -d chainio/lambda-ci-nodejs6.10 /bin/bash
docker exec -ti node_01 bash

Detalle del código

Para enviar la información a x-ray se debe activar la opción "Enable active tracing", lo cual se hace en el template para cloudformation.

TracingConfig:
Mode: Active 

Y se debe iniciar el método de “capture calls” del SDK al llamar a los servicios de aws, de está forma cualquier llamado a los diferentes servicios (SQS, SNS, DynamoBD) será registrado en x-ray.

varxray=require("aws-xray-sdk");varaws=xray.captureAWS(require("aws-sdk"));

Ya si se desea un mayor detalle se puede insertar datos como si estuvieramos haciendo un console.log llamando al getSegment() que trae el “segment actual” que es inmutable (o sea, iniciado por el ALB/APIGw, o lo que sea...) y el addAnnotation() agrega una nota el segment.

vardemo_segment=xray.getSegment().addNewSubsegment("demo");demo_segment.addAnnotation("Object",object);

Con el addMetadata, también puedes agregar cualquier otro objeto el trace, aún que no sea “searchable”.

demo_segment.addMetadata(object,data);

Después de finalizar el proceso y cerrar el callback, también cerramos el segment. Debes hacerlo con cualquier segment que sea customizado, mientras los segmentos “inmutables” van a ser cerrados por el propio SDK.

demo_segment.close();callback(null,"done");

Eso es básicamente todo lo que requiere el SDK de X-Ray. De ahí, creo que puedes avanzar en hacer testeos.

Es interesante también mirar el ejemplo q tenemos (también en node...): xray node express sample

Detalle del template

La pantilla tiene 3 secciones y la creación de los recursos necesarios.

Description: Function Lambda to execute whit S3 and DynamoDB to send trace to XRAYParameters: ...Resources: MyLambdaFunction:
LambdaExecutionRole:
BucketSource:
LambdaInvokePermission:
TableDest:

Parameters

Parameters:
Owner:
Type: StringDefault: undProject:
Type: StringDefault: xrayEnvironment:
Type: StringDefault: demoType:
Type: StringDefault: serverless

Los parámetros de entrada son utilizados para ingresar el nombre de la función, s3, role IAM, política inline y la tabla dynamoDB.

• Función: und-xray-demo-serverless
• S3: und.xray.demo.serverless
• Role IAM: und.xray.demo.serverless
• Política Inline: und.xray.demo.serverless.[service]
• Tabla: und-xray-demo-serverless

Resources

MyLambdaFunction

MyLambdaFunction:
Type: "AWS::Lambda::Function"Properties:
FunctionName : !Join
- "-"
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}Handler: index.handlerRuntime: nodejs6.10Code:
S3Bucket: "bucket"S3Key: "rctaptap/aws-xray-lambda-nodejs.zip"Role: !GetAtt LambdaExecutionRole.ArnDescription: "Amazon function to send traces to xray with S3 and DynamoDB"MemorySize: 128Timeout: 3TracingConfig:
Mode: Active Environment:
Variables:
my_table: !Ref TableDestDependsOn: - TableDest
- LambdaExecutionRole

LambdaExecutionRole

LambdaExecutionRole:
Type: AWS::IAM::RoleProperties:
RoleName : !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}AssumeRolePolicyDocument:
Version: '2012-10-17'Statement:
- Effect: AllowPrincipal:
Service:
- lambda.amazonaws.comAction:
- sts:AssumeRolePath: "/"Policies:
- PolicyName: !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}
- "cloudwatchlogs"PolicyDocument: Version: "2012-10-17"Statement: - Effect: "Allow"Action:
- logs:CreateLogGroup
- logs:CreateLogStream
- logs:PutLogEventsResource: "*"
- PolicyName: !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}
- "dynamodb"PolicyDocument: Version: '2012-10-17'Statement:
- Effect: AllowAction:
- 'dynamodb:DeleteItem'
- 'dynamodb:GetItem'
- 'dynamodb:PutItem'
- 'dynamodb:Scan'
- 'dynamodb:UpdateItem'Resource: !GetAtt TableDest.Arn
- PolicyName: !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}
- "xray"PolicyDocument: Version: '2012-10-17'Statement:
- Effect: AllowAction:
- 'xray:PutTraceSegments'
- 'xray:PutTelemetryRecords'Resource: "*"DependsOn: TableDest

BucketSource

BucketSource:
Type: 'AWS::S3::Bucket'Properties:
BucketName: !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}NotificationConfiguration:
LambdaConfigurations:
- Function: !GetAtt MyLambdaFunction.ArnEvent: "s3:ObjectCreated:*"DependsOn: - LambdaInvokePermission

LambdaInvokePermission

LambdaInvokePermission:
Type: 'AWS::Lambda::Permission'Properties:
FunctionName: !GetAtt MyLambdaFunction.ArnAction: 'lambda:InvokeFunction'Principal: s3.amazonaws.comSourceAccount: !Ref 'AWS::AccountId'SourceArn: !Join
- ":"
- - "arn"
- "aws"
- "s3"
- ":"
- !Join
- "."
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}DependsOn: - MyLambdaFunction

TableDest

TableDest:
Type: 'AWS::DynamoDB::Table'Properties:
AttributeDefinitions:
- AttributeName: idAttributeType: SKeySchema:
- AttributeName: idKeyType: HASHProvisionedThroughput:
ReadCapacityUnits: 5WriteCapacityUnits: 5TableName: !Join
- "-"
- - !Sub ${Owner}
- !Sub${Project}
- !Sub${Environment}
- !Sub${Type}