App
应用程序属性
描述与客户端应用程序（例如 Web 应用或移动应用）相关的属性。
Attributes
| 键 | Stability | Value Type | 描述 | Example Values |
|---|---|---|---|---|
app.build_id |  | 字符串 | 应用程序特定构建或编译的唯一标识符。 | 6cff0a7e-cefc-4668-96f5-1273d8b334d0; 9f2b833506aa6973a92fde9733e6271f; my-app-1.0.0-code-123 |
app.installation.id | | 字符串 | 代表应用程序在特定设备上安装的唯一标识符 [1] | 2ab2916d-a51f-4ac8-80ee-45ac31a28092 |
app.jank.frame_count | | int | 出现卡顿的帧渲染次数。[2] | 9; 42 |
app.jank.period | | double | 报告此卡顿的时间周期，单位为秒。 | 1.0; 5.0; 10.24 |
app.jank.threshold | | double | 此卡顿的最小渲染阈值，单位为秒。 | 0.016; 0.7; 1.024 |
app.screen.coordinate.x | | int | 屏幕坐标的 x（水平）坐标，单位为屏幕像素。 | 0; 131 |
app.screen.coordinate.y | | int | 屏幕坐标的 y（垂直）分量，单位为屏幕像素。 | 12; 99 |
app.screen.id | | 字符串 | 一个唯一区分同一应用程序中其他屏幕的标识符。[3] | f9bc787d-ff05-48ad-90e1-fca1d46130b3; com.example.app.MainActivity; com.example.shop.ProductDetailFragment; MyApp.ProfileView; MyApp.ProfileViewController |
app.screen.name | | 字符串 | 应用程序屏幕的名称。[4] | MainActivity; ProductDetailFragment; ProfileView; ProfileViewController |
app.widget.id | | 字符串 | 一个唯一区分同一应用程序中其他小部件的标识符。[5] | f9bc787d-ff05-48ad-90e1-fca1d46130b3; submit_order_1829 |
app.widget.name | | 字符串 | 应用程序小部件的名称。[6] | submit; attack; Clear Cart |
[1] app.installation.id: 其值应在同一应用程序安装的启动之间持久化，包括应用程序升级。如果应用程序被卸载，或者供应商的所有应用程序都被卸载，其值应发生变化。此外，用户可能能够重置此值（例如，通过清除应用程序数据）。如果一个应用程序在同一设备上安装了多次（例如，在 Android 上的不同帐户中），每个 app.installation.id 应具有不同的值。如果同一应用程序中使用多个 OpenTelemetry SDK，它们应为 app.installation.id 使用相同的值。硬件 ID（例如，序列号、IMEI、MAC 地址）不得用作 app.installation.id。
对于 iOS，此值应等于 供应商标识符。
对于 Android，app.installation.id 实现的示例包括
- Firebase Installation ID.
- 一个全局唯一的 UUID，它会在应用程序会话之间持久化。
- App set ID.
Settings.getString(Settings.Secure.ANDROID_ID).
有关 Android 标识符最佳实践的更多信息，请参阅 Android 用户数据 ID 指南。
[2] app.jank.frame_count: 根据平台限制，提供的值可能是近似值。
[3] app.screen.id: 屏幕仅代表应用程序绘制的设备显示部分。它通常包含多个小部件或 UI 组件，范围比单个小部件大。多个屏幕可以同时存在于同一显示屏上（例如，平板电脑上的分屏视图）。
[4] app.screen.name: 屏幕仅代表应用程序绘制的设备显示部分。它通常包含多个小部件或 UI 组件，范围比单个小部件大。多个屏幕可以同时存在于同一显示屏上（例如，平板电脑上的分屏视图）。
[5] app.widget.id: 小部件是应用程序组件，通常是屏幕上的视觉 GUI 元素。
[6] app.widget.name: 小部件是应用程序组件，通常是屏幕上的视觉 GUI 元素。