feat(aws-serverless)!: Use function.aws span op for Lambda invocations

msonnb · claude · msonnb · commit 62dc1548ed0c · 2026-07-27T13:25:34.000+02:00
Use the registered provider-level op instead of `function.aws.lambda`.
Adds `cloud.provider`, `cloud.platform`, and `faas.name`, which the
platform-level detail now relies on but were not previously set.

Ref: JS-3105

Co-Authored-By: Claude Opus 5 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/MIGRATION.md b/MIGRATION.md
@@ -268,6 +268,7 @@ Span operations (`sentry.op`) were aligned with the values defined in `@sentry/c
 - `@sentry/ember`: Route hook spans from `instrumentRoutePerformance` now use `function` instead of `ui.ember.route.<hook>`. The hook name is available on the new `code.function.name` and `ember.route.hook` attributes.
 - `@sentry/ember`: Runloop spans now use `ui.task` instead of `ui.ember.runloop.<queue>`. The queue is available on the new `ember.runloop.queue` attribute.
 - Browser SDKs: Paint spans (`first-paint`, `first-contentful-paint`) now use the registered `browser.paint` op instead of `paint`. This does not affect Session Replay, whose performance entries keep their own `paint` type.
+- `@sentry/aws-serverless`: Lambda invocation spans now use the registered `function.aws` op instead of `function.aws.lambda`. The new `cloud.provider=aws`, `cloud.platform=aws_lambda`, and `faas.name` attributes identify the platform and function.
 
 If you reference these operations in dashboards, alerts, or `beforeSendSpan`, update them to the new values.
 
diff --git a/dev-packages/e2e-tests/test-applications/aws-serverless-layer/tests/layer.test.ts b/dev-packages/e2e-tests/test-applications/aws-serverless-layer/tests/layer.test.ts
@@ -38,14 +38,17 @@ test.describe('Lambda layer', () => {
         'sentry.sample_rate': 1,
         'sentry.source': 'custom',
         'sentry.origin': 'auto.otel.aws_lambda',
-        'sentry.op': 'function.aws.lambda',
+        'sentry.op': 'function.aws',
         'cloud.account.id': '012345678912',
+        'cloud.platform': 'aws_lambda',
+        'cloud.provider': 'aws',
         'faas.execution': expect.any(String),
         'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:LayerTracingCjs',
+        'faas.name': 'LayerTracingCjs',
         'faas.coldstart': true,
         'sentry.kind': 'server',
       },
-      op: 'function.aws.lambda',
+      op: 'function.aws',
       origin: 'auto.otel.aws_lambda',
       span_id: expect.stringMatching(/[a-f0-9]{16}/),
       status: 'ok',
@@ -106,14 +109,17 @@ test.describe('Lambda layer', () => {
         'sentry.sample_rate': 1,
         'sentry.source': 'custom',
         'sentry.origin': 'auto.otel.aws_lambda',
-        'sentry.op': 'function.aws.lambda',
+        'sentry.op': 'function.aws',
         'cloud.account.id': '012345678912',
+        'cloud.platform': 'aws_lambda',
+        'cloud.provider': 'aws',
         'faas.execution': expect.any(String),
         'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:LayerTracingEsm',
+        'faas.name': 'LayerTracingEsm',
         'faas.coldstart': true,
         'sentry.kind': 'server',
       },
-      op: 'function.aws.lambda',
+      op: 'function.aws',
       origin: 'auto.otel.aws_lambda',
       span_id: expect.stringMatching(/[a-f0-9]{16}/),
       status: 'ok',
@@ -229,14 +235,17 @@ test.describe('Lambda layer', () => {
         'sentry.sample_rate': 1,
         'sentry.source': 'custom',
         'sentry.origin': 'auto.otel.aws_lambda',
-        'sentry.op': 'function.aws.lambda',
+        'sentry.op': 'function.aws',
         'cloud.account.id': '012345678912',
+        'cloud.platform': 'aws_lambda',
+        'cloud.provider': 'aws',
         'faas.execution': expect.any(String),
         'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:LayerStreaming',
+        'faas.name': 'LayerStreaming',
         'faas.coldstart': true,
         'sentry.kind': 'server',
       },
-      op: 'function.aws.lambda',
+      op: 'function.aws',
       origin: 'auto.otel.aws_lambda',
       span_id: expect.stringMatching(/[a-f0-9]{16}/),
       status: 'ok',
@@ -273,14 +282,15 @@ test.describe('Lambda layer', () => {
 
     expect(transactionEvent.contexts?.trace).toEqual(
       expect.objectContaining({
-        op: 'function.aws.lambda',
+        op: 'function.aws',
         origin: 'auto.otel.aws_lambda',
         status: 'ok',
         data: expect.objectContaining({
-          'sentry.op': 'function.aws.lambda',
+          'sentry.op': 'function.aws',
           'sentry.origin': 'auto.otel.aws_lambda',
           'sentry.kind': 'server',
           'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:LayerCallback',
+          'faas.name': 'LayerCallback',
         }),
       }),
     );
diff --git a/dev-packages/e2e-tests/test-applications/aws-serverless/tests/npm.test.ts b/dev-packages/e2e-tests/test-applications/aws-serverless/tests/npm.test.ts
@@ -24,14 +24,17 @@ test.describe('NPM package', () => {
         'sentry.sample_rate': 1,
         'sentry.source': 'custom',
         'sentry.origin': 'auto.otel.aws_lambda',
-        'sentry.op': 'function.aws.lambda',
+        'sentry.op': 'function.aws',
         'cloud.account.id': '012345678912',
+        'cloud.platform': 'aws_lambda',
+        'cloud.provider': 'aws',
         'faas.execution': expect.any(String),
         'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:NpmTracingCjs',
+        'faas.name': 'NpmTracingCjs',
         'faas.coldstart': true,
         'sentry.kind': 'server',
       },
-      op: 'function.aws.lambda',
+      op: 'function.aws',
       origin: 'auto.otel.aws_lambda',
       span_id: expect.stringMatching(/[a-f0-9]{16}/),
       status: 'ok',
@@ -92,14 +95,17 @@ test.describe('NPM package', () => {
         'sentry.sample_rate': 1,
         'sentry.source': 'custom',
         'sentry.origin': 'auto.otel.aws_lambda',
-        'sentry.op': 'function.aws.lambda',
+        'sentry.op': 'function.aws',
         'cloud.account.id': '012345678912',
+        'cloud.platform': 'aws_lambda',
+        'cloud.provider': 'aws',
         'faas.execution': expect.any(String),
         'faas.id': 'arn:aws:lambda:us-east-1:012345678912:function:NpmTracingEsm',
+        'faas.name': 'NpmTracingEsm',
         'faas.coldstart': true,
         'sentry.kind': 'server',
       },
-      op: 'function.aws.lambda',
+      op: 'function.aws',
       origin: 'auto.otel.aws_lambda',
       span_id: expect.stringMatching(/[a-f0-9]{16}/),
       status: 'ok',
diff --git a/packages/aws-serverless/src/instrumentHandler.ts b/packages/aws-serverless/src/instrumentHandler.ts
@@ -32,7 +32,7 @@ const lambdaMaxInitInMilliseconds = 10_000;
 type LambdaEvent = Parameters<typeof getAwsTraceData>[0];
 
 /**
- * Wraps a Lambda handler with full auto-instrumentation: a `function.aws.lambda`
+ * Wraps a Lambda handler with full auto-instrumentation: a `function.aws`
  * transaction that continues incoming traces, plus the scope, error-capture, timeout
  * warning, and flushing behavior of {@link wrapHandler}.
  *
diff --git a/packages/aws-serverless/src/requestSpanOptions.ts b/packages/aws-serverless/src/requestSpanOptions.ts
@@ -16,7 +16,16 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CLOUD_ACCOUNT_ID, FAAS_COLDSTART, SENTRY_KIND, URL_FULL } from '@sentry/conventions/attributes';
+import {
+  CLOUD_ACCOUNT_ID,
+  CLOUD_PLATFORM,
+  CLOUD_PROVIDER,
+  FAAS_COLDSTART,
+  FAAS_NAME,
+  SENTRY_KIND,
+  URL_FULL,
+} from '@sentry/conventions/attributes';
+import { FAAS_FUNCTION_AWS_SPAN_OP } from '@sentry/conventions/op';
 import type { SpanAttributes, StartSpanOptions } from '@sentry/core';
 import { SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN } from '@sentry/core';
 import type { Context } from 'aws-lambda';
@@ -30,20 +39,23 @@ interface ApiGatewayLikeEvent {
 }
 
 /**
- * Builds the options for the `function.aws.lambda` transaction started for each invocation.
+ * Builds the options for the `function.aws` transaction started for each invocation.
  */
 export function getRequestSpanOptions(event: unknown, context: Context, requestIsColdStart: boolean): StartSpanOptions {
   // The span is started within the surrounding `continueTrace`, so it continues the incoming trace.
   return {
     name: context.functionName,
-    op: 'function.aws.lambda',
+    op: FAAS_FUNCTION_AWS_SPAN_OP,
     forceTransaction: true,
     attributes: {
       [SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: 'auto.otel.aws_lambda',
       [SENTRY_KIND]: 'server',
       [ATTR_FAAS_EXECUTION]: context.awsRequestId,
       [ATTR_FAAS_ID]: context.invokedFunctionArn,
       [CLOUD_ACCOUNT_ID]: extractAccountId(context.invokedFunctionArn),
+      [CLOUD_PROVIDER]: 'aws',
+      [CLOUD_PLATFORM]: 'aws_lambda',
+      [FAAS_NAME]: context.functionName,
       [FAAS_COLDSTART]: requestIsColdStart,
       ...extractOtherEventFields(event),
     },

Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ const lambdaMaxInitInMilliseconds = 10_000;`
`32`	`32`	`type LambdaEvent = Parameters<typeof getAwsTraceData>[0];`
`33`	`33`
`34`	`34`	`/**`
`35`		- * Wraps a Lambda handler with full auto-instrumentation: a `function.aws.lambda`
	`35`	+ * Wraps a Lambda handler with full auto-instrumentation: a `function.aws`
`36`	`36`	`* transaction that continues incoming traces, plus the scope, error-capture, timeout`
`37`	`37`	`* warning, and flushing behavior of {@link wrapHandler}.`
`38`	`38`	`*`