Nascent Personality Manifestation

    TypeScript icon, indicating that this package has built-in type declarations

    0.30.0 • Public • Published

    OpenTelemetry AWS Lambda Instrumentation for Node.js

    NPM Published Version dependencies devDependencies Apache License

    component owners: @willarmiros @NathanielRN

    This module provides automatic instrumentation for AWS Lambda.

    This module is currently under active development and not ready for general use.

    Compatible with OpenTelemetry JS API and SDK 1.0+.


    npm install --save @opentelemetry/instrumentation-aws-lambda


    Create a file to initialize the instrumentation, such as lambda-wrapper.js.

    const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
    const { AwsLambdaInstrumentation } = require('@opentelemetry/instrumentation-aws-lambda');
    const { registerInstrumentations } = require('@opentelemetry/instrumentation');
    const provider = new NodeTracerProvider();
      instrumentations: [
        new AwsLambdaInstrumentation({
            // see under for available configuration

    In your Lambda function configuration, add or update the NODE_OPTIONS environment variable to require the wrapper, e.g.,

    NODE_OPTIONS=--require lambda-wrapper

    AWS Lambda Instrumentation Options

    Options Type Description
    requestHook RequestHook (function) Hook for adding custom attributes before lambda starts handling the request. Receives params: span, { event, context }
    responseHook ResponseHook (function) Hook for adding custom attributes before lambda returns the response. Receives params: span, { err?, res? }
    disableAwsContextPropagation boolean By default, this instrumentation will try to read the context from the _X_AMZN_TRACE_ID environment variable set by Lambda, set this to true to disable this behavior
    eventContextExtractor EventContextExtractor (function) Function for providing custom context extractor in order to support different event types that are handled by AWS Lambda (e.g., SQS, CloudWatch, Kinesis, API Gateway). Applied only when disableAwsContextPropagation is set to true. Receives params: event, context

    Hooks Usage Example

    const { AwsLambdaInstrumentation } = require('@opentelemetry/instrumentation-aws-lambda');
    new AwsLambdaInstrumentation({
        requestHook: (span, { event, context }) => {
            span.setAttributes('', context.functionName);
        responseHook: (span, { err, res }) => {
            if (err instanceof Error) span.setAttributes('faas.error', err.message);
            if (res) span.setAttributes('faas.res', res);

    Useful links


    Apache 2.0 - See LICENSE for more information.


    npm i @opentelemetry/instrumentation-aws-lambda

    DownloadsWeekly Downloads






    Unpacked Size

    46.8 kB

    Total Files


    Last publish


    • bogdandrutu
    • dyladan