文档中心

函数概览

最近更新时间：2024.04.19 11:08:49

首次发布时间：2023.02.16 18:06:17

本文档提供日志服务数据加工功能相关的函数列表。

全局操作函数

函数类型	函数名称	说明
流程控制函数	c_if	满足条件则进行对应操作，不满足条件则不进行对应操作，直接进行下一个条件判断。
	c_if_else	根据条件判断的结果进行对应操作。
	c_switch	满足条件则进行对应操作并返回结果，不满足条件则不进行对应操作，直接进行下一个条件判断。
	c_compose	用于组合多个操作，多个操作应均为全局操作函数。
事件检查函数	f_match	判断指定日志字段值是否满足正则表达式
事件检查函数	f_search	判断日志中是否有符合检索语句的内容。
事件处理函数	e_output	输出日志到指定的日志主题中。
	e_split	基于日志字段的值分裂成多条日志。
	e_drop	根据条件判断是否删除日志。
	e_keep	根据条件判断是否保留日志。
字段处理函数	v	获取日志中指定字段的值。当同时传入多个字段名时，返回日志中第一个存在的字段值。
	f_drop	删除指定的字段。
	f_keep	保留指定的字段，其余字段均删除。
	f_rename	重命名指定的字段。
	f_set	新增字段或修改现有字段的值。
字段检查函数	f_has	判断指定的字段是否存在。
字段检查函数	f_not_has	判断指定的字段是否不存在。
键值提取函数	ext_sep	基于单个分隔符提取字段值内容。
	ext_sepstr	基于分隔字符串提取字段值内容。
	ext_json	对指定字段中的 JSON 字符串进行展开操作。
	ext_json_jmes	使用 jmes 表达式提取字段值。
	ext_kv	基于两级分隔符提取字段的值。
	ext_regex	根据指定的正则表达式提取指定字段的值，并赋值给其他字段。
	ext_grok	根据正则表达式提取特定的值。
富化映射函数	f_dict_map	与指定字典进行映射，根据映射关系将输入的字段映射为一个新字段。

表达式函数

函数类型	函数名称	说明
日期值处理函数	dt_str	将时间表达式的值（时间戳、字符串等）转换为字符串。
	dt_to_timestamp	将时间类的字段值，根据指定的时区，转换为 UTC 时间戳。
	dt_from_timestamp	将时间类的时间戳字段，转换为指定时区的时间字符串。
	dt_now	获取加工计算时的本地时间。
字符串处理函数	str_join	用分隔符连接多个字符串。
	str_len	计算字符串长度。
	str_replace	字符串替换。
	str_format	字符串格式化。
类型转换函数	ct_int	整型数值进制转换，支持指定原始进制 2~36，默认原进制为十进制，返回结果为十进制。
	ct_float	把原类型转换为浮点数。
	ct_str	把原类型转换为字符串。
	ct_bool	把原类型转换为 bool 类型。
逻辑表达式函数	op_if	如果条件为 true，返回第一个表达式的值，false 则返回第二个表达式值。
	op_and	逻辑与运算。
	op_or	逻辑或运算。
	op_not	逻辑非运算。
	op_eq	逻辑等于运算，支持字符串、数值。
	op_ge	大于等于运算。
	op_gt	大于运算。
	op_le	小于等于运算。
	op_lt	小于运算。
算术表达式函数	op_add	累加运算。
	op_sub	减法运算。
	op_mul	乘法运算。
	op_div	除法运算。
	op_sum	加法运算。
	op_mod	求余运算。
	op_null	空值判断运算，为空返回 true，否则返回 false。
正则表达式函数	regex_replace	基于正则匹配并替换字符串。
字典函数	dict_make	构造字典。
字典函数	dict_update	用一个字典更新另一个字典的值。
编码解码函数	md5_encoding	对指定字段进行 MD5 编码，即计算字符串的 MD5 值。
	base64_encoding	对指定数据进行 Base64 编码，即计算字符串的 Base64 编码值。
	base64_decoding	对数据进行 Base64 解码。
	str_encoding 函数	按照指定的编码格式对字符串进行编码。
	str_decoding 函数	按照指定的编码格式对字符串进行解码。
IP 解析函数	geo_parsee	根据 IP 地址解析出对应的地理位置和行政区划等位置信息。
解析函数	ua_parse_device	解析 User-Agent 中的设备信息。
	ua_parse_os	解析 User-Agent 中的操作系统信息。
	ua_parse_agent	解析 User-Agent 字符串中的浏览器信息。
结构化处理函数	if_json 函数	判断字符串是否为标准 JSON 格式的字符串。
列表函数	lst_make	构建一个新的列表。
	lst_append	在列表结尾追加元素。
	lst_delete_at	删除列表中指定位置的元素。

全局操作函数

表达式函数