lambda-leak

Simple utility to detect resource leaks in AWS Lambda handlers using Node.js that can lead to expensive charges lengthy operations or failures from timeouts.

Features

• Detects socket leaks
• Detects excess timers
• Works with mocha's timeout system
• Works with Node 6.10.x

Installation

Install via npm.

npm install lambda-leak

Getting Started

The lambda-leak detector should be used within a unit testing environment, like mocha, to capture and diagnose potential resource leaks. The following example demonstrates how to use the leak detector inside a unit test.

1'use strict';
2
3const lambdaLeak = require( 'lambda-leak' );
4
5const handler = require( 'my-lambda-handler-module' );
6
7describe( 'myModule', function() {
8
9    describe( 'handler', function() {
10
11        it( 'detect leak in my handler', function( done ) {
12
13            const state = lambdaLeak.capture();
14
15            handler( {/* event*/, { /* context */}, function( err, result ) {
16
17                if( err ) {
18
19                    return done( err );
20                }
21
22                let difference = state..getDifferenceInHandles();
23
24                if( difference.length > 0 ) {
25
26                    console.log( 'leaks', difference );
27
28                    // leaks detected
29                    done( new Error( 'leaks detected' ) );
30                }
31
32                done();
33            });
34        });
35    });
36});

Projects Using lambda-leak

• lambda-tester - reduce the time and effort to test AWS Lambda handlers.

Feedback

We'd love to get feedback on how you're using lambda-tester and things we could add to make this tool better. Feel free to contact us at feedback@vandium.io

License

BSD-3-Clause