Repository navigation
Conversation
- Update the Java layer ARNs to v2.32.0 (AWSOpenTelemetryDistroJava:19 in most Regions) from the release notes. - Align the supported runtimes table with the runtimes the layers declare and Lambda supports: add Python 3.14, Node.js 24, Java 25, and .NET 10, remove the deprecated Node.js 18 and 20, and add an architectures column (.NET is x86_64 only). - Note that Java instrumentation requires a RequestHandler or RequestStreamHandler handler, and that Go, Rust, Ruby, and other provided.al2023 functions have no Application Signals layer. - Rewrite the Go guide for provided.al2023: OpenTelemetry Go SDK with otellambda, and the ADOT Collector Lambda layer configured to send traces to the X-Ray OTLP endpoint with SigV4.
Describe https://xray.<region>.amazonaws.com/v1/traces as the CloudWatch OTLP traces endpoint rather than presenting AWS X-Ray as a separate destination.
Contributor
Author
Aigeec-AWS
pushed a commit
that referenced
this pull request
Oct 31, 2026
Bring in the Lambda layer version and runtime updates and the rewritten Go guide from #863, so that the documentation changes ship in one pull request. The Go guide replaces this branch's earlier edits to the old Go page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the Lambda pages to match the published ADOT Lambda layers and current Lambda runtimes, and replaces the legacy Go guide with a tested setup that sends traces to the X-Ray OTLP endpoint.
Layer versions and runtimes
Java ARNs: updated to v2.32.0 (
AWSOpenTelemetryDistroJava:19in most Regions) for all 35 Regions, from the v2.32.0 release notes. Python (:32), JavaScript (:16), and .NET (:15) were already current.Supported runtimes: the table now lists the runtimes each layer declares and Lambda supports, with a new Architectures column:
New notes under Supported Runtimes:
RequestHandlerorRequestStreamHandler; other handlers run but produce no spans.provided.al2023functions have no Application Signals layer. The note links to the Go guide.Go guide
The previous guide targeted
provided.al2, which Lambda has deprecated, and used the collector layer's defaultawsxrayexporter. The new guide covers:provided.al2023, on x86_64 or arm64.otellambda/xrayconfig, plusotelhttpfor outgoing requests.aws-otel-collector-<arch>-ver-0-156-0:4, still the latest), with acollector.yamlthat exports tohttps://xray.<region>.amazonaws.com/v1/tracesthroughotlp_httpandsigv4auth. The file is loaded withOPENTELEMETRY_COLLECTOR_CONFIG_URI=/var/task/collector.yaml.OTEL_SERVICE_NAME. Without it, Go SDK spans have noservice.name.Testing
End to end in us-east-1 (Transaction Search enabled), each function invoked 5 times. All test resources were deleted afterwards.
AWSOpenTelemetryDistroPython:32aws/spans; listed in Application Signals (lambda:default) with Latency, Error, Fault, ThrottleAWSOpenTelemetryDistroJs:16AWSOpenTelemetryDistroJava:18and:19RequestStreamHandlerhandler)AWSOpenTelemetryDistroDotNet:15provided.al2023)aws-otel-collector-amd64-ver-0-156-0:4with the guide'scollector.yamlotellambdaserver andotelhttpclient spans inaws/spans, withservice.namefromOTEL_SERVICE_NAME; collector logged no warnings; listed in Application Signals with the same metricsThe guide's Go code and
collector.yamlare identical to the tested files. The site builds with these changes merged onto #862, with no new warnings, and all internal links on both pages resolve.Merge order
This branch is based on
main. #862 also edits four lines oflambda-go.mdx(its banner and two links), which this PR replaces, so whichever merges second needs a rebase that keeps this version of the Go page. The other files merge cleanly with #862.Follow-ups (not in this PR)
System.IO.Streamfailed under the ADOT .NET wrapper, which deserializes the event into the handler's parameter type. This was seen with a non-standard package and needs checking with a standard one.2.31.1-adot-lambda1-alphaand2.32.0-adot-lambda1-alpha. Is the "alpha" suffix intended?By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.