Enable OpenTelemetry tracing for all Lambdas except for web app

app.arc

@@ -168,4 +168,5 @@ mission-cloud-platform  # Custom permissions for deployment on Mission Cloud Pla
 email-outgoing  # Grant the Lambda function permission to send email; add email templates.
 email-incoming  # Enable Lambda handlers for incoming emails
 nasa-gcn/architect-plugin-search  # Add an AWS OpenSearch Serverless collection.
+nasa-gcn/architect-plugin-tracing
 architect/plugin-lambda-invoker

app/email-incoming/circulars/index.ts

@@ -48,7 +48,15 @@ interface EmailProps {
 
 const fromName = 'GCN Circulars'
 
-export const handler = createEmailIncomingMessageHandler(
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = createEmailIncomingMessageHandler(
   async ({ content }) => {
     const parsed = await parseEmailContentFromSource(content)
     const { address: userEmail, submittedHow } = getFromAddress(parsed.from)

app/email-incoming/support/index.ts

@@ -31,10 +31,15 @@ const origData = {
   log: console.log,
 }
 
-/**
- * Forward incoming emails to Zendesk.
- */
-export const handler = createEmailIncomingMessageHandler(
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = createEmailIncomingMessageHandler(
   async ({ content, receipt: { recipients } }) => {
     let data = { recipients, emailData: content.toString(), ...origData }
     data = await transformRecipients(data)

app/scheduled/ads/index.ts

@@ -41,7 +41,15 @@ async function* getAdsEntries() {
   } while (length)
 }
 
-export async function handler() {
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = async function() {
   const db = await tables()
   const seenCircularIds = new Set<number>()
   for await (const entries of getAdsEntries()) {

app/scheduled/circulars/index.ts

@@ -10,7 +10,15 @@ import { sitemapAction } from './actions/sitemap'
 import { statsAction } from './actions/stats'
 import { jsonUploadAction, txtUploadAction } from './actions/tar'
 
-export async function handler() {
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = async function() {
   await forAllCirculars(
     jsonUploadAction,
     txtUploadAction,

app/table-streams/circulars/index.ts

@@ -39,7 +39,15 @@ async function putIndex(circular: Circular) {
   })
 }
 
-export const handler = createTriggerHandler(
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = createTriggerHandler(
   async ({ eventName, dynamodb }: DynamoDBRecord) => {
     const id = unmarshallTrigger(dynamodb!.Keys).circularId as number
     const promises = []

app/table-streams/synonyms/index.ts

@@ -36,7 +36,15 @@ async function putIndex(synonymGroup: SynonymGroup) {
   })
 }
 
-export const handler = createTriggerHandler(
+// Export handler entrypoint for instrumentation with OpenTelemetry.
+// From https://aws-otel.github.io/docs/getting-started/lambda/lambda-js#requirements:
+//
+// > For TypeScript users, if you are using esbuild (either directly or through
+// > tools such as the AWS CDK), you must export your handler function through
+// > module.exports rather than with the export keyword! The AWS mananaged layer
+// > for ADOT JavaScript needs to hot-patch your handler at runtime, but can't
+// > because esbuild makes your handler immutable when using the export keyword.
+module.exports.handler = createTriggerHandler(
   async ({ eventName, dynamodb }: DynamoDBRecord) => {
     if (!eventName || !dynamodb) return
     const { synonymId } = unmarshallTrigger(dynamodb!.NewImage) as Synonym

build/email-incoming/circulars/config.arc

@@ -0,0 +1,2 @@
+@aws
+tracing true

build/email-incoming/support/config.arc

@@ -0,0 +1,2 @@
+@aws
+tracing true

build/scheduled/ads/config.arc

@@ -1,2 +1,3 @@
 @aws
 timeout 900
+tracing true

build/scheduled/circulars/config.arc

@@ -1,3 +1,4 @@
 @aws
 timeout 900
 memory 512
+tracing true

build/table-streams/circulars/config.arc

@@ -0,0 +1,2 @@
+@aws
+tracing true

build/table-streams/synonyms/config.arc

@@ -0,0 +1,2 @@
+@aws
+tracing true

package.json

@@ -96,6 +96,7 @@
     "@babel/preset-typescript": "^7.23.3",
     "@gitlab/svgs": "^3.83.0",
     "@nasa-gcn/architect-plugin-search": "^1.4.0",
+    "@nasa-gcn/architect-plugin-tracing": "^1.1.0",
     "@nasa-gcn/eslint-config-gitignore": "^0.0.2",
     "@playwright/test": "^1.48.2",
     "@remix-run/dev": "~2.10.3",