App Attributes

20 attributes in this category. 15 stable · 5 deprecated

Stable Attributes

app.build

string PII: Maybe 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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.type

string PII: Maybe 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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 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,
  "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"
    }
  ]
}