文档中心

日志服务

请输入

LogCollector 插件

字符串替换插件

您可以在使用 LogCollector 采集日志时，使用 replace 插件对指定字段进行字符串替换，支持正则匹配或内容匹配方式。

说明

replace 插件还可以用于数据脱敏场景，将指定字段中的敏感字符替换为其他字符串，例如将手机号码中间四位替换为 ****。该场景下建议关闭上传解析失败日志和上传原始日志，以保护您的敏感信息。

参数说明

名称	类型	是否必选	说明
field	String	是	待替换的字段名称。字段名称不可重复，不可为空，且不支持英文句号（.）。
type	String	是	日志内容的替换方式。支持设置为： string：字符串替换。 regex：正则表达式替换。
pattern	String	是	日志内容的匹配模式。当原始字段中有一处或多处匹配 pattern 时，它们将全部被 replacement 对应的值替换。当 type 为 string 时，pattern 应指定为表示日志内容的字符串。当 type 为 regex 时，pattern 应指定为匹配日志内容的正则表达式。支持正则表达式捕获组。
replacement	String	是	用于替换指定日志内容的字符串。
when	Object	否	插件的执行条件，仅当执行条件判断为 true 时，才执行此插件。详细说明请参考插件执行条件。
ignore_missing	Boolean	否	是否忽略不存在的字段。 true（默认值）：当字段不存在，直接忽略。 false：当字段不存在时，直接报错。

配置示例

最近更新时间：2026.08.26 16:23:34

这个页面对您有帮助吗？

有用

无用