日志服务
日志服务
日志服务
文档指南
请输入
用户指南
TLS Agent
资源管理
数据采集
LogCollector 采集
LogCollector 简介
安装与升级（Linux）
安装与升级（Windows）
采集容器日志
LogCollector 插件
管理 LogCollector
云产品日志采集
TOS 日志采集
CDN 日志采集
DBW 日志采集
VPN 日志采集
VKE 日志采集
CLB 日志采集
CloudTrail 日志采集
CFW 日志采集
NTA 日志采集
ALB 日志采集
APMPlus 日志采集
veFaaS 日志采集
VPC 日志采集
veImageX 日志采集
TrafficRoute DNS 日志采集
DDos 日志采集
WAF 日志采集
DCDN 日志采集
多云安全平台日志采集
APIG 日志采集
机器学习任务日志采集
采集火山方舟应用实验室日志
CR 日志采集
FileNAS 日志采集
大模型应用防火墙日志采集
vePFS 日志采集
云安全中心日志采集
EFS 日志采集
检索分析
使用第三方工具检索分析日志
关联外部数据源检索分析日志
SQL 函数
可视化
日志应用
云产品观测日志应用
大模型观测日志应用
Coding Agent 日志应用
ModelProvider 日志应用
No-coding Agent 日志应用
Framework 日志应用
基础服务监控日志应用
数据处理
数据加工
消费与投递
告警
Trace 存储
API 参考
日志管理
机器组管理
采集配置管理
数据处理器
定时 SQL 分析
告警管理
消费组管理
Trace 存储
SDK 参考
Go SDK
Java SDK
Android SDK
Node.js SDK
CLI 参考
最佳实践
消费与投递
可视化
常见问题
数据采集常见问题
索引配置常见问题
- 文档首页
日志服务用户指南数据处理数据加工语法与函数全局操作函数事件检查函数
复制全文
下载 pdf事件检查函数
文档反馈
问问助手f_match 函数
判断指定日志字段值是否满足正则表达式，返回字段匹配的判断结果，即 true 或 false。
函数语法/格式
f_match(field,regex=正则表达式,full=False)
参数说明如下：
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
field | String | 是 | / | / | 字段名。当指定字段不存在时，判断为条件不匹配。 |
regex | String | 是 | / | / | 正则表达式。 |
full | Bool | 否 | False |
| 是否完全匹配，默认为 false，即部分匹配。 例如： 正则表达式的值与字符串完全一致，则是完全匹配。 例如abcd与\w+完全匹配。您可以在开头与结尾添加^与$将部分匹配的场景变成完全匹配。 |
函数示例
- 场景：判断日志中 content 字段是否与正则表达式匹配。
- 加工规则：
- f_set("f_match_part",f_match("content","12"))f_set("f_match_full",f_match("content","12",True))
- 日志样例：
- {"content": "1234"}
- 加工结果：
- {"content": "1234","f_match_part": true,"f_match_full": false}
f_search 函数
判断日志中是否有符合检索语句的内容，是则返回 true，否则返回 fFalse。
函数语法/格式
f_search(query=检索条件)
参数说明如下：
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
参数 | 参数类型 | 是否必选 | 默认值 | 取值范围 | 说明 |
query | String | 是 | / | / |
函数示例
- 场景：判断日志 count 字段中是否有大于 0 的值。
- 加工规则：
- f_set("f_search",f_search("count > 0"))
- 日志样例：
- {"count": 100}
- 加工结果：
- {"count": 100,"f_search": true}
常见语法规则的示例如下：
# 全文检索
f_search("byte dance") # 全文检索，判断全文中是否包含关键词 byte 或 dance。
f_search('"byte dance"') # 全文检索，判断全文中是否包含关键词 byte dance，该关键词中包含空格。
# 键值检索
f_search('method: get') # 键值检索，判断 method 字段值中是否包含关键词 get。
f_search('company: "volc engine"') # 键值检索，判断 company 字段的值中是否包含关键词 volc engine，该关键词中包含空格。
f_search('company: byte dance') # 键值检索，判断 company 字段的值中是否包含关键词 byte 或 dance。
# 完全匹配
f_search('company== "byte dance"')
# 通配符搜索。其中，星号（*）匹配零个或多个字符，半角问号（?）匹配一个字符。
f_search('company: do*y?n') # 模糊匹配，使用通配符星号（*）和半角问号（?）
f_search('company: byt*dance') # 模糊匹配，使用通配符星号（*）。
f_search('company: tik?ok') # 模糊匹配，使用通配符半角问号（?）。
# 字段名转义
f_search('"中文字段": abc') # 中文字符，需使用双引号（""）包裹。
f_search("\*a: value") # 字段名中包含特殊字符时，需使用反斜线（\）转义。
f_search("__tag__\:field: value") # 字段名中包含特殊字符时，需使用反斜线（\）转义。
# 正则匹配
f_search('company~="byt[\w]dance"') # 正则式匹配，用于判断 company 字段的值是否匹配包含byt+一个字母/数字/下划线+dance的字符串。
# 数字
f_search('amount: [10,200]') # 判断 amount 字段值是否在 [10,200] 之间。
f_search('distance >=10') # 判断 distance 字段值是否大于等于 10。
f_search('distance > 20') # 判断 distance 字段值是否大于 20。
# 使用关系运算符
f_search('byte OR dance') # 关系运算符需要使用大写。
f_search('byte AND ( NOT dancer OR tiktok)')
f_search('byte AND (dancer OR dance)')
f_search("byte || !dance") # OR NOT
f_search("byte || dance") # OR
f_search("byte && dance") # AND
最近更新时间：2026.09.21 18:48:15
这个页面对您有帮助吗？
有用
有用
无用
无用