This enrichment uses the ua-parser library to parse the user agent and provide information about the user’s device.
Collecting and separating out all the valuable device information to be found in the user agent is a great way to get insight into the types of devices and operating systems and versions your users are using. This helps with deciding which to support as well as in decisions around functionality releases.
With the device family field which is part of the context you can also benefit from the lookup done with our database to sort the multitude of different devices into higher level device types like desktop, mobile, tablet, other, etc.
Configuration
Input
This enrichment uses the field useragent.
Output
This enrichment adds a new context to the enriched event with this schema.
| Field | Description |
|---|---|
useragent_family | Useragent family (browser) name |
useragent_major | Useragent major version |
useragent_minor | Useragent minor version |
useragent_patch | Useragent patch version |
useragent_version | Full version of the useragent |
os_family | Operation system name |
os_major | Operation system major version |
os_minor | Operation system minor version |
os_patch | Operation system patch version |
os_patch_minor | Operation system patch minor version |
os_version | Operation system full version |
device_family | Device type |
As an example, the useragent string
Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2564.116 Safari/537.36
would be parsed with the following result:
| PARAMETER | VALUE |
|---|---|
| useragent_family | Chrome |
| useragent_major | 48 |
| useragent_minor | – |
| useragent_patch | 2564 |
| os_family | Windows 7 |
| os_major | – |
| os_minor | – |
| os_patch_minor | – |
| os_version | Windows 7 |
| device_family | Other |
*empty values denoted by “-“