TA-user-agents
Overview
Details
TA-user-agents
Overview
This TA provides and external Python lookup that parses User Agents strings, such as those found in Web or Proxy logs.
Installation
To install:
1. Untar the tarball file in your $SPLUNK_HOME/etc/apps
directory.
2. Restart Splunk.
Usage
The lookup expects a field in the events (http_user_agent). Once that field exists (via extractions, alias or rename). Once that field exists, you can use it in a lookup command, as such:
index=web_proxy | lookup user_agents http_user_agent
The lookup will output the following fields:
* ua_os_family: The name of the client OS.
* ua_os_major: The major version of the client OS.
* ua_os_minor: The minor version of the client OS.
* ua_os_patch: The patch version of the client OS.
* ua_os_patch_minor: The minor patch version of the client OS.
* ua_family: The name of the UA ("Firefox", "IE")
* ua_major: The major version of the UA.
* ua_minor: The minor version of the UA.
* ua_patch: The patch version of the UA
* ua_device: The type of device used in the event.
Customization
To add your own user agents, you can use the YAML file in TA-user-agents/bin/ua_parser/ named regexes.yaml.
Support
Support is on a best-effort basis. Need help? Use the Splunk community resources! I can be found on many of them:
Credits
This TA uses a Python module from:
https://github.com/ua-parser/uap-python
Icons made by Freepik from Flaticon is licensed by CC 3.0 BY
Change log
v 1.7.5
- Removed script in /bin for Splunk Cloud
v 1.7.4
- Updated python packages
- Python 3 Compatible
v 1.6
- Updated to the latest version of the ua-parser
- Changed URL for the ua-parser to the new project page
- Added app icons
v 1.5
Initial release
Release Notes
Version 1.7.6
- Should fix the jQuery issues
- Should be Python3
Version 1.7.5
Removed binary script for Splunk Cloud compatibility.
Version 1.7.4
Python3 Compatible for Splunk 8