本文档主要介绍User-Agent解析函数的语法规则，包括参数解释、函数示例等。

函数列表

函数 说明
ua_parse_device 解析User-Agent中的设备信息。
ua_parse_os 解析User-Agent中的操作系统信息。
ua_parse_agent 解析User-Agent中的浏览器信息。
ua_parse_all 解析User-Agent中所有信息。
说明 User-Agent解析函数会剔除解析结果为None的字段，例如解析的设备数据为{'brand': None, 'family': 'Other', 'model': None}，则剔除brand字段和model字段，最终的解析结果为{'family': 'Other'}。

ua_parse_device

解析User-Agent中的设备信息。

  • 函数格式 
    ua_parse_device(value)
  • 参数说明
    参数 字段属性 是否必填 说明
    value String 是 填入待解析的User-Agent字符串，例如：ua_parse_device(v("http_user_agent"))。
  • 返回结果

    返回JSON类型的数据集。

  • 函数示例
    • 原始日志 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • 加工规则 
      e_set("new_column",ua_parse_device(v("http_user_agent")))
    • 加工结果 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
new_column:{'family': 'Other'}

ua_parse_os

解析User-Agent中的操作系统信息。

  • 函数格式 
    ua_parse_os(value)
  • 参数说明
    参数 字段属性 是否必填 说明
    value String 是 填入待解析的User-Agent字符串，例如：ua_parse_os(v("http_user_agent"))。
  • 返回结果

    返回JSON类型的数据集。

  • 函数示例
    • 原始日志 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • 加工规则 
      e_set("new_column",ua_parse_os(v("http_user_agent")))
    • 加工结果 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
new_column:{'family': 'Mac OS X',
                    'major': '10',
                    'minor': '9',
                    'patch': '4'}

ua_parse_agent

解析User-Agent中的浏览器信息。

  • 函数格式 
    ua_parse_agent(value)
  • 参数说明
    参数 字段属性 是否必填 说明
    value String 是 填入待解析的User-Agent字符串，例如：ua_parse_agent(v("http_user_agent"))。
  • 返回结果

    返回JSON类型的数据集。

  • 函数示例
    • 原始日志 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • 加工规则 
      e_set("new_column",ua_parse_agent(v("http_user_agent")))
    • 加工结果 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
new_column:{'family': 'Chrome', 'major': '192', 'minor': '168', 'patch': '0'}

ua_parse_all

提取User-Agent中的所有信息。

  • 函数格式 
    ua_parse_all(value)
  • 参数说明
    参数 字段属性 是否必填 说明
    value String 是 填入待解析的User-Agent字符串，例如：ua_parse_all(v("http_user_agent"))。
  • 返回结果

    返回JSON类型的数据集。

  • 函数示例
    • 原始日志 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
    • 加工规则 
      e_set("new_column",ua_parse_all(v("http_user_agent")))
    • 加工结果 
      http_user_agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.168.0.0 Safari/537.36
new_column:{   
    'device': {'family': 'Other',},
    'os': {   'family': 'Mac OS X',
              'major': '10',
              'minor': '9',
              'patch': '4'},
    'user_agent': {   'family': 'Chrome',
                      'major': '192',
                      'minor': '168',
                      'patch': '0'}}