Enable OpenTelemetry tracing for all Lambdas except for web app

OpenTelemetry aggregates logs across multiple AWS services to form
distributed traces.

Enable it for all Lambdas except for the one that powers our web
app, because the OpenTelemetry layer increases cold-start time.

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",