操作场景
日志服务(CLS)支持对已存入日志主题的日志进行修改与删除操作,满足误传日志清理、日志字段标记等场景需求。例如:
部分含敏感数据的日志需要删除。
误上报到生产环境的测试日志需要清理。
对日志中的关键字段进行标记(如将某条错误日志标记为"已处理")。
注意事项
该功能暂时仅面向白名单内客户使用,如有需要,可 提交工单 与我们联系。
日志主题默认不支持日志修改与删除,只能在新建主题时开启该功能,已有主题不支持修改该开启状态。
日志修改及删除不可撤销,请谨慎操作。
修改及删除日志并不能降低日志流量、存储量及相关费用,详见 计费说明。
启用该功能后,该日志主题将无法投递/消费历史数据、使用数据加工处理历史数据,以及重建索引。
操作步骤
开启日志修改/删除
日志主题默认不支持日志修改/删除,您可以在 创建日志主题 时,在高级设置中勾选支持日志修改/删除,开启后即可对该主题内的日志执行修改、删除操作。只能在新建主题时开启该功能,已有主题不支持修改该开启状态。
删除日志
警告:
删除操作不可撤销,请谨慎操作。建议先通过 日志检索接口 使用相同的参数进行日志查询,确定查询到的日志是需要被删除的日志后,再调用删除日志接口进行删除。
QueryString 仅支持 CQL 日志检索语法,不支持 Lucene 及 SQL。
修改日志
支持两种修改模式:
PARTIAL:仅修改指定字段,ModifyContent 中没有出现的字段,不会被修改。
REPLACE:修改整条日志,使用 ModifyContent 覆盖原有日志(预置字段及元数据字段保留不变,不会被修改)。
警告:
修改操作不可撤销,请谨慎操作。建议先通过 日志检索接口 使用相同的参数进行日志查询,确定查询到的日志是需要被修改的日志后,再调用修改日志接口进行修改。
不支持修改预置字段(
__FILENAME__、__SOURCE__等,但不包括__CONTENT__)及元数据字段(__TAG__开头的字段)。QueryString 仅支持 CQL 日志检索语法,不支持 Lucene 及 SQL。
规格限制
限制项 | 说明 |
单次操作上限 | 单次接口调用最多修改/删除1万条日志,超出将报错且不会删除/修改任何日志。 |
接口 QPS | 日志修改/删除接口 QPS 限制为5。 |
并发限制 | 并发数共享日志查询并发限制,总并发不超过15。 |
检索语法 | 检索条件仅支持 CQL 检索语法,不支持 SQL、Lucene。 |
修改内容 | 单次最多同时指定1000个 key。 key 不得以 _开头(__CONTENT__例外)。整个修改内容最大5MB。 key 仅指日志的一级字段,不支持以 a.b 形式指定 a 的二级及以上子级字段。 |
计费说明
修改日志:不会降低原有日志/索引流量及存储量。针对修改产生的数据,按新上报日志对待,会产生原始日志量/写流量/索引流量/日志存储/索引存储,进而产生相关费用。
删除日志:不会降低日志/索引流量及存储量。