App
App
状态:
类型： app
描述： 终端用户直接使用的应用——例如移动、Web 或桌面应用。
标识属性
| 键 | Stability | 需求级别 | Value Type | 描述 | Example Values |
|---|---|---|---|---|---|
app.build_id |  | 推荐 | 字符串 | 特定应用程序构建或编译的唯一标识符。 | 6cff0a7e-cefc-4668-96f5-1273d8b334d0; 9f2b833506aa6973a92fde9733e6271f; my-app-1.0.0-code-123 |
其他属性
⚠️ 此实体定义包含没有角色的属性。稳定的实体不得包含没有定义角色的属性。
| 键 | Stability | 需求级别 | Value Type | 描述 | Example Values |
|---|---|---|---|---|---|
app.installation.id | | 推荐 | 字符串 | 代表特定设备上应用程序安装的唯一标识符 [1] | 2ab2916d-a51f-4ac8-80ee-45ac31a28092 |
[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，该 UUID 会在应用程序的会话中持续存在。
- App set ID.
Settings.getString(Settings.Secure.ANDROID_ID).
有关 Android 标识符最佳实践的更多信息，请参阅 Android 用户数据 ID 指南。