README.md

AWS managed OpenTelemetry Lambda Layers

As a downstream Repo of opentelemetry-lambda, aws-otel-lambda publishes AWS managed OpenTelemetry Lambda layers that are preconfigured for use with AWS services and bundle the reduced ADOT Collector. Users can onboard to OpenTelemetry in their existing Lambda functions by adding these ready-made layers directly.

• Python layer aws-otel-python-<amd64|arm64>-ver-1-16-0 contains OpenTelemetry Python v1.16.0 and ADOT Collector for Lambda v0.27.0
• Nodejs layer aws-otel-nodejs-<amd64|arm64>-ver-1-9-1 contains OpenTelemetry JavaScript Core v1.9.1 with AWS Lambda Instrumentation v0.35.0 and ADOT Collector for Lambda v0.27.0
• Java-Wrapper layer aws-otel-java-wrapper-<amd64|arm64>-ver-1-23-0 contains OpenTelemetry Java v1.23.0 and ADOT Collector for Lambda v0.27.0
• Java-Agent layer aws-otel-java-agent-<amd64|arm64>-ver-1-23-0 contains AWS Distro for OpenTelemetry Java Instrumentation v1.23.0 and ADOT Collector for Lambda v0.27.0
• Collector layer aws-otel-collector-<amd64|arm64>-ver-0-72-0 contains ADOT Collector for Lambda v0.27.0. Compatible with .NET and Go runtimes.

Sample Apps

We provide SAM and Terraform sample applications for AWS managed OpenTelemetry Lambda layers. You can play with these samples by the following:

1. Install AWS Cli, AWS SAM, Terraform, and configure AWS credentials correctly.

2. Checkout the current Repo by

   git clone --recurse-submodules https://github.com/aws-observability/aws-otel-lambda.git
   

3. Go to the language folder, such as python, java, run

   ./build.sh
   

4. Go to a sample application folder, such as sample-apps/aws-sdk/deploy/wrapper/.

5. Deploy sample application by,

   For Terraform sample application

   terraform init
   terraform apply -auto-approve
   

To Deploy SAM sample application, navigate to sample-apps/python-aws-sdk-aiohttp-sam/ and run. ./run.sh

ADOT Lambda Layer available components

This table represents the components that the ADOT Lambda Layer will support and can be used in the custom configuration for ADOT collector on Lambda. The highlighted components below are developed by AWS in-house.

Receiver	Exporter	Extensions
otlpreceiver	awsemfexporter	sigv4authextension
	awsxrayexporter
	prometheusremotewriteexporter
	loggingexporter
	otlpexporter
	otlphttpexporter

Security

See CONTRIBUTING for more information.

Support

Please note that as per policy, we're providing support via GitHub on a best effort basis. However, if you have AWS Enterprise Support you can create a ticket and we will provide direct support within the respective SLAs.

License

This project is licensed under the Apache-2.0 License.