User agent
用户代理属性
描述用户代理属性。
Attributes
| 键 | Stability | Value Type | 描述 | Example Values |
|---|---|---|---|---|
user_agent.name |  | 字符串 | 从原始字符串中提取的用户代理名称。通常指浏览器名称。[1] | Safari; YourApp |
user_agent.original |  | 字符串 | 客户端发送的HTTP User-Agent头的值。 | CERN-LineMode/2.15 libwww/2.17b3; Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1; YourApp/1.0.0 grpc-java-okhttp/1.27.2 |
user_agent.version | | 字符串 | 从原始字符串中提取的用户代理版本。通常指浏览器版本[2] | 14.1.2; 1.0.0 |
[1] user_agent.name: 从原始字符串中提取浏览器名称的示例。对于非浏览器产品使用用户代理的情况，例如具有多个名称/版本在user_agent.original中的微服务，应选择最显著的名称。在这种情况下，它应与user_agent.version保持一致。
[2] user_agent.version: 从原始字符串中提取浏览器版本的示例。对于非浏览器产品使用用户代理的情况，例如具有多个名称/版本在user_agent.original中的微服务，应选择最显著的版本。在这种情况下，它应与user_agent.name保持一致。
用户代理操作系统属性
描述操作系统用户代理属性。
Attributes
| 键 | Stability | Value Type | 描述 | Example Values |
|---|---|---|---|---|
user_agent.os.name | | 字符串 | 人类可读的操作系统名称。[3] | iOS; Android; Ubuntu |
user_agent.os.version | | 字符串 | 操作系统版本字符串，定义于版本属性。 [4] | 14.2.1; 18.04.1 |
user_agent.synthetic.type | | 字符串 | 指定合成流量的类别，例如测试或机器人。[5] | bot; test |
[3] user_agent.os.name: 要将用户代理字符串映射到操作系统名称，可以使用ua-parser等库。
[4] user_agent.os.version: 要将用户代理字符串映射到操作系统版本，可以使用ua-parser等库。
[5] user_agent.synthetic.type: 此属性可能源自user_agent.original属性的内容。填充该属性的组件负责确定其认为的合成流量（机器人或测试流量）。此属性可用于自我识别目的，或用于识别为合成请求而生成的遥测数据。此属性有助于区分真实的客户端流量和机器人或测试生成的合成流量。
user_agent.synthetic.type具有以下已知值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。
| 值 | 描述 | Stability |
|---|---|---|
bot | 机器人来源。 | |
test | 合成测试来源。 | |