feat(attributes): Add deprecated app.app_* attributes with backfill to canonical app.* names

Instead of renaming app.build to app.app_build, keep app.build as canonical
and add app.app_build as a deprecated attribute with backfill status that
aliases to app.build. Same pattern for app_identifier, app_name,
app_start_time, and app_version.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: buenaflor

javascript/sentry-conventions/src/attributes.ts

@@ -733,6 +733,121 @@ export const AI_WARNINGS = 'ai.warnings';
  */
 export type AI_WARNINGS_TYPE = Array<string>;
 
+// Path: model/attributes/app/app__app_build.json
+
+/**
+ * Internal build identifier, as it appears on the platform. `app.app_build`
+ *
+ * Attribute Value Type: `string` {@link APP_APP_BUILD_TYPE}
+ *
+ * Contains PII: maybe
+ *
+ * Attribute defined in OTEL: No
+ *
+ * Aliases: {@link APP_BUILD} `app.build`
+ *
+ * @deprecated Use {@link APP_BUILD} (app.build) instead - Deprecated in favor of app.build
+ * @example "1"
+ */
+export const APP_APP_BUILD = 'app.app_build';
+
+/**
+ * Type for {@link APP_APP_BUILD} app.app_build
+ */
+export type APP_APP_BUILD_TYPE = string;
+
+// Path: model/attributes/app/app__app_identifier.json
+
+/**
+ * Version-independent application identifier, often a dotted bundle ID. `app.app_identifier`
+ *
+ * Attribute Value Type: `string` {@link APP_APP_IDENTIFIER_TYPE}
+ *
+ * Contains PII: maybe
+ *
+ * Attribute defined in OTEL: No
+ *
+ * Aliases: {@link APP_IDENTIFIER} `app.identifier`
+ *
+ * @deprecated Use {@link APP_IDENTIFIER} (app.identifier) instead - Deprecated in favor of app.identifier
+ * @example "com.example.myapp"
+ */
+export const APP_APP_IDENTIFIER = 'app.app_identifier';
+
+/**
+ * Type for {@link APP_APP_IDENTIFIER} app.app_identifier
+ */
+export type APP_APP_IDENTIFIER_TYPE = string;
+
+// Path: model/attributes/app/app__app_name.json
+
+/**
+ * Human readable application name, as it appears on the platform. `app.app_name`
+ *
+ * Attribute Value Type: `string` {@link APP_APP_NAME_TYPE}
+ *
+ * Contains PII: maybe
+ *
+ * Attribute defined in OTEL: No
+ *
+ * Aliases: {@link APP_NAME} `app.name`
+ *
+ * @deprecated Use {@link APP_NAME} (app.name) instead - Deprecated in favor of app.name
+ * @example "My App"
+ */
+export const APP_APP_NAME = 'app.app_name';
+
+/**
+ * Type for {@link APP_APP_NAME} app.app_name
+ */
+export type APP_APP_NAME_TYPE = string;
+
+// Path: model/attributes/app/app__app_start_time.json
+
+/**
+ * Formatted UTC timestamp when the user started the application. `app.app_start_time`
+ *
+ * Attribute Value Type: `string` {@link APP_APP_START_TIME_TYPE}
+ *
+ * Contains PII: maybe
+ *
+ * Attribute defined in OTEL: No
+ *
+ * Aliases: {@link APP_START_TIME} `app.start_time`
+ *
+ * @deprecated Use {@link APP_START_TIME} (app.start_time) instead - Deprecated in favor of app.start_time
+ * @example "2025-01-01T00:00:00.000Z"
+ */
+export const APP_APP_START_TIME = 'app.app_start_time';
+
+/**
+ * Type for {@link APP_APP_START_TIME} app.app_start_time
+ */
+export type APP_APP_START_TIME_TYPE = string;
+
+// Path: model/attributes/app/app__app_version.json
+
+/**
+ * Human readable application version, as it appears on the platform. `app.app_version`
+ *
+ * Attribute Value Type: `string` {@link APP_APP_VERSION_TYPE}
+ *
+ * Contains PII: maybe
+ *
+ * Attribute defined in OTEL: No
+ *
+ * Aliases: {@link APP_VERSION} `app.version`
+ *
+ * @deprecated Use {@link APP_VERSION} (app.version) instead - Deprecated in favor of app.version
+ * @example "1.0.0"
+ */
+export const APP_APP_VERSION = 'app.app_version';
+
+/**
+ * Type for {@link APP_APP_VERSION} app.app_version
+ */
+export type APP_APP_VERSION_TYPE = string;
+
 // Path: model/attributes/app/app__build.json
 
 /**
@@ -744,6 +859,8 @@ export type AI_WARNINGS_TYPE = Array<string>;
  *
  * Attribute defined in OTEL: No
  *
+ * Aliases: {@link APP_APP_BUILD} `app.app_build`
+ *
  * @example "1"
  */
 export const APP_BUILD = 'app.build';
@@ -764,6 +881,8 @@ export type APP_BUILD_TYPE = string;
  *
  * Attribute defined in OTEL: No
  *
+ * Aliases: {@link APP_APP_IDENTIFIER} `app.app_identifier`
+ *
  * @example "com.example.myapp"
  */
 export const APP_IDENTIFIER = 'app.identifier';
@@ -804,6 +923,8 @@ export type APP_IN_FOREGROUND_TYPE = boolean;
  *
  * Attribute defined in OTEL: No
  *
+ * Aliases: {@link APP_APP_NAME} `app.app_name`
+ *
  * @example "My App"
  */
 export const APP_NAME = 'app.name';
@@ -824,6 +945,8 @@ export type APP_NAME_TYPE = string;
  *
  * Attribute defined in OTEL: No
  *
+ * Aliases: {@link APP_APP_START_TIME} `app.app_start_time`
+ *
  * @example "2025-01-01T00:00:00.000Z"
  */
 export const APP_START_TIME = 'app.start_time';
@@ -864,6 +987,8 @@ export type APP_START_TYPE_TYPE = string;
  *
  * Attribute defined in OTEL: No
  *
+ * Aliases: {@link APP_APP_VERSION} `app.app_version`
+ *
  * @example "1.0.0"
  */
 export const APP_VERSION = 'app.version';
@@ -10601,6 +10726,11 @@ export const ATTRIBUTE_TYPE: Record<string, AttributeType> = {
   [AI_TOTAL_COST]: 'double',
   [AI_TOTAL_TOKENS_USED]: 'integer',
   [AI_WARNINGS]: 'string[]',
+  [APP_APP_BUILD]: 'string',
+  [APP_APP_IDENTIFIER]: 'string',
+  [APP_APP_NAME]: 'string',
+  [APP_APP_START_TIME]: 'string',
+  [APP_APP_VERSION]: 'string',
   [APP_BUILD]: 'string',
   [APP_IDENTIFIER]: 'string',
   [APP_IN_FOREGROUND]: 'boolean',
@@ -11107,6 +11237,11 @@ export type AttributeName =
   | typeof AI_TOTAL_COST
   | typeof AI_TOTAL_TOKENS_USED
   | typeof AI_WARNINGS
+  | typeof APP_APP_BUILD
+  | typeof APP_APP_IDENTIFIER
+  | typeof APP_APP_NAME
+  | typeof APP_APP_START_TIME
+  | typeof APP_APP_VERSION
   | typeof APP_BUILD
   | typeof APP_IDENTIFIER
   | typeof APP_IN_FOREGROUND
@@ -12080,6 +12215,102 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
       { version: '0.1.0', prs: [55] },
     ],
   },
+  [APP_APP_BUILD]: {
+    brief: 'Internal build identifier, as it appears on the platform.',
+    type: 'string',
+    pii: {
+      isPii: 'maybe',
+    },
+    isInOtel: false,
+    example: '1',
+    deprecation: {
+      replacement: 'app.build',
+      reason: 'Deprecated in favor of app.build',
+    },
+    aliases: [APP_BUILD],
+    sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
+    changelog: [
+      { version: 'next', prs: [296], description: 'Added and deprecated app.app_build in favor of app.build' },
+    ],
+  },
+  [APP_APP_IDENTIFIER]: {
+    brief: 'Version-independent application identifier, often a dotted bundle ID.',
+    type: 'string',
+    pii: {
+      isPii: 'maybe',
+    },
+    isInOtel: false,
+    example: 'com.example.myapp',
+    deprecation: {
+      replacement: 'app.identifier',
+      reason: 'Deprecated in favor of app.identifier',
+    },
+    aliases: [APP_IDENTIFIER],
+    sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
+    changelog: [
+      {
+        version: 'next',
+        prs: [296],
+        description: 'Added and deprecated app.app_identifier in favor of app.identifier',
+      },
+    ],
+  },
+  [APP_APP_NAME]: {
+    brief: 'Human readable application name, as it appears on the platform.',
+    type: 'string',
+    pii: {
+      isPii: 'maybe',
+    },
+    isInOtel: false,
+    example: 'My App',
+    deprecation: {
+      replacement: 'app.name',
+      reason: 'Deprecated in favor of app.name',
+    },
+    aliases: [APP_NAME],
+    sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
+    changelog: [{ version: 'next', prs: [296], description: 'Added and deprecated app.app_name in favor of app.name' }],
+  },
+  [APP_APP_START_TIME]: {
+    brief: 'Formatted UTC timestamp when the user started the application.',
+    type: 'string',
+    pii: {
+      isPii: 'maybe',
+    },
+    isInOtel: false,
+    example: '2025-01-01T00:00:00.000Z',
+    deprecation: {
+      replacement: 'app.start_time',
+      reason: 'Deprecated in favor of app.start_time',
+    },
+    aliases: [APP_START_TIME],
+    sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
+    changelog: [
+      {
+        version: 'next',
+        prs: [296],
+        description: 'Added and deprecated app.app_start_time in favor of app.start_time',
+      },
+    ],
+  },
+  [APP_APP_VERSION]: {
+    brief: 'Human readable application version, as it appears on the platform.',
+    type: 'string',
+    pii: {
+      isPii: 'maybe',
+    },
+    isInOtel: false,
+    example: '1.0.0',
+    deprecation: {
+      replacement: 'app.version',
+      reason: 'Deprecated in favor of app.version',
+    },
+    aliases: [APP_VERSION],
+    sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
+    changelog: [
+      { version: 'next', prs: [296], description: 'Added and deprecated app.app_version in favor of app.version' },
+    ],
+  },
   [APP_BUILD]: {
     brief: 'Internal build identifier, as it appears on the platform.',
     type: 'string',
@@ -12088,6 +12319,7 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
     },
     isInOtel: false,
     example: '1',
+    aliases: [APP_APP_BUILD],
     sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
     changelog: [{ version: 'next', prs: [296], description: 'Added app.build attribute' }],
   },
@@ -12099,6 +12331,7 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
     },
     isInOtel: false,
     example: 'com.example.myapp',
+    aliases: [APP_APP_IDENTIFIER],
     sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
     changelog: [{ version: 'next', prs: [296], description: 'Added app.identifier attribute' }],
   },
@@ -12121,6 +12354,7 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
     },
     isInOtel: false,
     example: 'My App',
+    aliases: [APP_APP_NAME],
     sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
     changelog: [{ version: 'next', prs: [296], description: 'Added app.name attribute' }],
   },
@@ -12132,6 +12366,7 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
     },
     isInOtel: false,
     example: '2025-01-01T00:00:00.000Z',
+    aliases: [APP_APP_START_TIME],
     sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
     changelog: [{ version: 'next', prs: [296], description: 'Added app.start_time attribute' }],
   },
@@ -12153,6 +12388,7 @@ export const ATTRIBUTE_METADATA: Record<AttributeName, AttributeMetadata> = {
     },
     isInOtel: false,
     example: '1.0.0',
+    aliases: [APP_APP_VERSION],
     sdks: ['sentry.cocoa', 'sentry.java.android', 'sentry.javascript.react-native', 'sentry.dart.flutter'],
     changelog: [{ version: 'next', prs: [296], description: 'Added app.version attribute' }],
   },
@@ -17647,6 +17883,11 @@ export type Attributes = {
   [AI_TOTAL_COST]?: AI_TOTAL_COST_TYPE;
   [AI_TOTAL_TOKENS_USED]?: AI_TOTAL_TOKENS_USED_TYPE;
   [AI_WARNINGS]?: AI_WARNINGS_TYPE;
+  [APP_APP_BUILD]?: APP_APP_BUILD_TYPE;
+  [APP_APP_IDENTIFIER]?: APP_APP_IDENTIFIER_TYPE;
+  [APP_APP_NAME]?: APP_APP_NAME_TYPE;
+  [APP_APP_START_TIME]?: APP_APP_START_TIME_TYPE;
+  [APP_APP_VERSION]?: APP_APP_VERSION_TYPE;
   [APP_BUILD]?: APP_BUILD_TYPE;
   [APP_IDENTIFIER]?: APP_IDENTIFIER_TYPE;
   [APP_IN_FOREGROUND]?: APP_IN_FOREGROUND_TYPE;

model/attributes/app/app__app_build.json

@@ -0,0 +1,24 @@
+{
+  "key": "app.app_build",
+  "brief": "Internal build identifier, as it appears on the platform.",
+  "type": "string",
+  "pii": {
+    "key": "maybe"
+  },
+  "is_in_otel": false,
+  "sdks": ["sentry.cocoa", "sentry.java.android", "sentry.javascript.react-native", "sentry.dart.flutter"],
+  "example": "1",
+  "alias": ["app.build"],
+  "deprecation": {
+    "replacement": "app.build",
+    "reason": "Deprecated in favor of app.build",
+    "_status": "backfill"
+  },
+  "changelog": [
+    {
+      "version": "next",
+      "prs": [296],
+      "description": "Added and deprecated app.app_build in favor of app.build"
+    }
+  ]
+}

model/attributes/app/app__app_identifier.json

@@ -0,0 +1,24 @@
+{
+  "key": "app.app_identifier",
+  "brief": "Version-independent application identifier, often a dotted bundle ID.",
+  "type": "string",
+  "pii": {
+    "key": "maybe"
+  },
+  "is_in_otel": false,
+  "sdks": ["sentry.cocoa", "sentry.java.android", "sentry.javascript.react-native", "sentry.dart.flutter"],
+  "example": "com.example.myapp",
+  "alias": ["app.identifier"],
+  "deprecation": {
+    "replacement": "app.identifier",
+    "reason": "Deprecated in favor of app.identifier",
+    "_status": "backfill"
+  },
+  "changelog": [
+    {
+      "version": "next",
+      "prs": [296],
+      "description": "Added and deprecated app.app_identifier in favor of app.identifier"
+    }
+  ]
+}