App Attributes

22 attributes in this category. 17 stable · 5 deprecated

Stable Attributes

`app.build`

string PII: Maybe Visibility: Public OTel: False

Internal build identifier, as it appears on the platform.

Example 1

Aliases app.app_build

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.build attribute

Raw JSON

{
  "key": "app.build",
  "brief": "Internal build identifier, as it appears on the platform.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "1",
  "alias": [
    "app.app_build"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.build attribute"
    }
  ]
}

`app.identifier`

string PII: Maybe Visibility: Public OTel: False

Version-independent application identifier, often a dotted bundle ID.

Example com.example.myapp

Aliases app.app_identifier

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.identifier attribute

Raw JSON

{
  "key": "app.identifier",
  "brief": "Version-independent application identifier, often a dotted bundle ID.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "com.example.myapp",
  "alias": [
    "app.app_identifier"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.identifier attribute"
    }
  ]
}

`app.in_foreground`

boolean PII: Maybe Visibility: Public OTel: False

Whether the application is currently in the foreground.

Example true

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.in_foreground attribute

Raw JSON

{
  "key": "app.in_foreground",
  "brief": "Whether the application is currently in the foreground.",
  "type": "boolean",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": true,
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.in_foreground attribute"
    }
  ]
}

`app.name`

string PII: Maybe Visibility: Public OTel: False

Human readable application name, as it appears on the platform.

Example My App

Aliases app.app_name

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.name attribute

Raw JSON

{
  "key": "app.name",
  "brief": "Human readable application name, as it appears on the platform.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "My App",
  "alias": [
    "app.app_name"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.name attribute"
    }
  ]
}

`app.start_time`

string PII: Maybe Visibility: Public OTel: False

Formatted UTC timestamp when the user started the application.

Example 2025-01-01T00:00:00.000Z

Aliases app.app_start_time

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.start_time attribute

Raw JSON

{
  "key": "app.start_time",
  "brief": "Formatted UTC timestamp when the user started the application.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "2025-01-01T00:00:00.000Z",
  "alias": [
    "app.app_start_time"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.start_time attribute"
    }
  ]
}

`app.version`

string PII: Maybe Visibility: Public OTel: False

Human readable application version, as it appears on the platform.

Example 1.0.0

Aliases app.app_version

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #296 Added app.version attribute

Raw JSON

{
  "key": "app.version",
  "brief": "Human readable application version, as it appears on the platform.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "1.0.0",
  "alias": [
    "app.app_version"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added app.version attribute"
    }
  ]
}

`app.vitals.frames.delay.value`

integer PII: Maybe Visibility: Public OTel: False

The sum of all delayed frame durations in seconds during the lifetime of the span. For more information see [frames delay](https://develop.sentry.dev/sdk/performance/frames-delay/).

Example 5

Aliases frames.delay

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.frames.delay.value to replace frames.delay

Raw JSON

{
  "key": "app.vitals.frames.delay.value",
  "brief": "The sum of all delayed frame durations in seconds during the lifetime of the span. For more information see [frames delay](https://develop.sentry.dev/sdk/performance/frames-delay/).",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 5,
  "alias": [
    "frames.delay"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.frames.delay.value to replace frames.delay"
    }
  ]
}

`app.vitals.frames.frozen.count`

integer PII: Maybe Visibility: Public OTel: False

The number of frozen frames rendered during the lifetime of the span.

Example 3

Aliases frames.frozen

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.frames.frozen.count to replace frames.frozen

Raw JSON

{
  "key": "app.vitals.frames.frozen.count",
  "brief": "The number of frozen frames rendered during the lifetime of the span.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 3,
  "alias": [
    "frames.frozen"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.frames.frozen.count to replace frames.frozen"
    }
  ]
}

`app.vitals.frames.slow.count`

integer PII: Maybe Visibility: Public OTel: False

The number of slow frames rendered during the lifetime of the span.

Example 1

Aliases frames.slow

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.frames.slow.count to replace frames.slow

Raw JSON

{
  "key": "app.vitals.frames.slow.count",
  "brief": "The number of slow frames rendered during the lifetime of the span.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 1,
  "alias": [
    "frames.slow"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.frames.slow.count to replace frames.slow"
    }
  ]
}

`app.vitals.frames.total.count`

integer PII: Maybe Visibility: Public OTel: False

The number of total frames rendered during the lifetime of the span.

Example 60

Aliases frames.total

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.frames.total.count to replace frames.total

Raw JSON

{
  "key": "app.vitals.frames.total.count",
  "brief": "The number of total frames rendered during the lifetime of the span.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 60,
  "alias": [
    "frames.total"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.frames.total.count to replace frames.total"
    }
  ]
}

`app.vitals.start.cold.value`

double PII: Maybe Visibility: Public OTel: False

The duration of a cold app start in milliseconds

Example 1234.56

Aliases app_start_cold

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.start.cold.value attribute

Raw JSON

{
  "key": "app.vitals.start.cold.value",
  "brief": "The duration of a cold app start in milliseconds",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 1234.56,
  "alias": [
    "app_start_cold"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.start.cold.value attribute"
    }
  ]
}

`app.vitals.start.reason`

string PII: Maybe Visibility: Public OTel: False

The reason that triggered the app start.

Example push

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.fluttersentry.dotnet.maui

Changelog

v0.7.0 #353 Added app.vitals.start.reason attribute

Raw JSON

{
  "key": "app.vitals.start.reason",
  "brief": "The reason that triggered the app start.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "push",
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter",
    "sentry.dotnet.maui"
  ],
  "changelog": [
    {
      "version": "0.7.0",
      "prs": [
        353
      ],
      "description": "Added app.vitals.start.reason attribute"
    }
  ]
}

`app.vitals.start.screen`

string PII: Maybe Visibility: Public OTel: False

The screen that is rendered when the app start is complete. This is the screen the user first sees and can interact with after launch. The absence of this attribute on the app start span indicates a background app start where no UI was rendered.

Example MainActivity

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.fluttersentry.dotnet.maui

Changelog

v0.7.0 #353 Added app.vitals.start.screen attribute

Raw JSON

{
  "key": "app.vitals.start.screen",
  "brief": "The screen that is rendered when the app start is complete. This is the screen the user first sees and can interact with after launch. The absence of this attribute on the app start span indicates a background app start where no UI was rendered.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "MainActivity",
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter",
    "sentry.dotnet.maui"
  ],
  "changelog": [
    {
      "version": "0.7.0",
      "prs": [
        353
      ],
      "description": "Added app.vitals.start.screen attribute"
    }
  ]
}

`app.vitals.start.type`

string PII: Maybe Visibility: Public OTel: False

The type of app start, for example `cold` or `warm`

Example cold

Aliases app_start_type

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.start.type attribute

Raw JSON

{
  "key": "app.vitals.start.type",
  "brief": "The type of app start, for example `cold` or `warm`",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "cold",
  "alias": [
    "app_start_type"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.start.type attribute"
    }
  ]
}

`app.vitals.start.warm.value`

double PII: Maybe Visibility: Public OTel: False

The duration of a warm app start in milliseconds

Example 1234.56

Aliases app_start_warm

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.start.warm.value attribute

Raw JSON

{
  "key": "app.vitals.start.warm.value",
  "brief": "The duration of a warm app start in milliseconds",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 1234.56,
  "alias": [
    "app_start_warm"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.start.warm.value attribute"
    }
  ]
}

`app.vitals.ttfd.value`

double PII: Maybe Visibility: Public OTel: False

The duration of time to full display in milliseconds

Example 1234.56

Aliases time_to_full_display

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.ttfd.value attribute

Raw JSON

{
  "key": "app.vitals.ttfd.value",
  "brief": "The duration of time to full display in milliseconds",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 1234.56,
  "alias": [
    "time_to_full_display"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.ttfd.value attribute"
    }
  ]
}

`app.vitals.ttid.value`

double PII: Maybe Visibility: Public OTel: False

The duration of time to initial display in milliseconds

Example 1234.56

Aliases time_to_initial_display

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Changelog

v0.5.0 #313 Added app.vitals.ttid.value attribute

Raw JSON

{
  "key": "app.vitals.ttid.value",
  "brief": "The duration of time to initial display in milliseconds",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 1234.56,
  "alias": [
    "time_to_initial_display"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        313
      ],
      "description": "Added app.vitals.ttid.value attribute"
    }
  ]
}

Deprecated Attributes

These attributes are deprecated and should not be used in new code. See each attribute for migration guidance.

`app.app_build` Deprecated

string PII: Maybe Visibility: Public OTel: False

Internal build identifier, as it appears on the platform.

Example 1

Aliases app.build

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Use app.build instead.

Deprecated in favor of app.build

Status: backfill

Changelog

v0.5.0 #296 Added and deprecated app.app_build in favor of app.build

Raw JSON

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

`app.app_identifier` Deprecated

string PII: Maybe Visibility: Public OTel: False

Version-independent application identifier, often a dotted bundle ID.

Example com.example.myapp

Aliases app.identifier

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Use app.identifier instead.

Deprecated in favor of app.identifier

Status: backfill

Changelog

v0.5.0 #296 Added and deprecated app.app_identifier in favor of app.identifier

Raw JSON

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

`app.app_name` Deprecated

string PII: Maybe Visibility: Public OTel: False

Human readable application name, as it appears on the platform.

Example My App

Aliases app.name

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Use app.name instead.

Deprecated in favor of app.name

Status: backfill

Changelog

v0.5.0 #296 Added and deprecated app.app_name in favor of app.name

Raw JSON

{
  "key": "app.app_name",
  "brief": "Human readable application name, as it appears on the platform.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "My App",
  "deprecation": {
    "replacement": "app.name",
    "reason": "Deprecated in favor of app.name",
    "_status": "backfill"
  },
  "alias": [
    "app.name"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added and deprecated app.app_name in favor of app.name"
    }
  ]
}

`app.app_start_time` Deprecated

string PII: Maybe Visibility: Public OTel: False

Formatted UTC timestamp when the user started the application.

Example 2025-01-01T00:00:00.000Z

Aliases app.start_time

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Use app.start_time instead.

Deprecated in favor of app.start_time

Status: backfill

Changelog

v0.5.0 #296 Added and deprecated app.app_start_time in favor of app.start_time

Raw JSON

{
  "key": "app.app_start_time",
  "brief": "Formatted UTC timestamp when the user started the application.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "2025-01-01T00:00:00.000Z",
  "deprecation": {
    "replacement": "app.start_time",
    "reason": "Deprecated in favor of app.start_time",
    "_status": "backfill"
  },
  "alias": [
    "app.start_time"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added and deprecated app.app_start_time in favor of app.start_time"
    }
  ]
}

`app.app_version` Deprecated

string PII: Maybe Visibility: Public OTel: False

Human readable application version, as it appears on the platform.

Example 1.0.0

Aliases app.version

SDKs sentry.cocoasentry.java.androidsentry.javascript.react-nativesentry.dart.flutter

Use app.version instead.

Deprecated in favor of app.version

Status: backfill

Changelog

v0.5.0 #296 Added and deprecated app.app_version in favor of app.version

Raw JSON

{
  "key": "app.app_version",
  "brief": "Human readable application version, as it appears on the platform.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "1.0.0",
  "deprecation": {
    "replacement": "app.version",
    "reason": "Deprecated in favor of app.version",
    "_status": "backfill"
  },
  "alias": [
    "app.version"
  ],
  "sdks": [
    "sentry.cocoa",
    "sentry.java.android",
    "sentry.javascript.react-native",
    "sentry.dart.flutter"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        296
      ],
      "description": "Added and deprecated app.app_version in favor of app.version"
    }
  ]
}

App Attributes

Stable Attributes

Deprecated Attributes

app.app_build Deprecated

app.app_identifier Deprecated

app.app_name Deprecated

app.app_start_time Deprecated

app.app_version Deprecated

`app.app_build` Deprecated

`app.app_identifier` Deprecated

`app.app_name` Deprecated

`app.app_start_time` Deprecated

`app.app_version` Deprecated