功能概览

【版权声明】
©2013-2026 腾讯云版权所有
本⽂档著作权归腾讯云单独所有,未经腾讯云事先书⾯许可,任何主体不得以任何形式复制、修改、抄袭、传播全部或部分本⽂档内容。
【商标声明】
及其他腾讯云服务相关的商标均为腾讯集团下的相关公司主体所有。另外,本⽂档涉及的第三⽅主体的商标,依法由权利⼈所有。
【服务声明】
本⽂档意在向客户介绍腾讯云全部或部分产品、服务的当时的整体概况,部分产品、服务的内容可能有所调整。您所购买的腾讯云产品、服务的种类、服务标准等应由您与腾讯云之间的商业合同约定,除⾮双⽅另有约定,否则,腾讯云对本⽂档内容不做任何明⽰或默⽰的承诺或保证。
最近更新时间:2023-05-08 16:45:43

最近更新时间:2025-11-25 09:11:39
最近更新时间:2026-07-02 21:35:50
地域 | 简称 |
北京 | ap-beijing |
广州 | ap-guangzhou |
上海 | ap-shanghai |
成都 | ap-chengdu |
南京 | ap-nanjing |
重庆 | ap-chongqing |
中国香港 | ap-hongkong |
硅谷 | na-siliconvalley |
弗吉尼亚 | na-ashburn |
新加坡 | ap-singapore |
曼谷 | ap-bangkok |
法兰克福 | eu-frankfurt |
东京 | ap-tokyo |
首尔 | ap-seoul |
雅加达 | ap-jakarta |
圣保罗 | sa-saopaulo |
地域 | 简称 | 内网域名 | 外网域名 |
北京 | ap-beijing | ap-beijing.cls.tencentyun.com | ap-beijing.cls.tencentcs.com |
广州 | ap-guangzhou | ap-guangzhou.cls.tencentyun.com | ap-guangzhou.cls.tencentcs.com |
上海 | ap-shanghai | ap-shanghai.cls.tencentyun.com | ap-shanghai.cls.tencentcs.com |
成都 | ap-chengdu | ap-chengdu.cls.tencentyun.com | ap-chengdu.cls.tencentcs.com |
南京 | ap-nanjing | ap-nanjing.cls.tencentyun.com | ap-nanjing.cls.tencentcs.com |
重庆 | ap-chongqing | ap-chongqing.cls.tencentyun.com | ap-chongqing.cls.tencentcs.com |
中国香港 | ap-hongkong | ap-hongkong.cls.tencentyun.com | ap-hongkong.cls.tencentcs.com |
硅谷 | na-siliconvalley | na-siliconvalley.cls.tencentyun.com | na-siliconvalley.cls.tencentcs.com |
弗吉尼亚 | na-ashburn | na-ashburn.cls.tencentyun.com | na-ashburn.cls.tencentcs.com |
新加坡 | ap-singapore | ap-singapore.cls.tencentyun.com | ap-singapore.cls.tencentcs.com |
曼谷 | ap-bangkok | ap-bangkok.cls.tencentyun.com | ap-bangkok.cls.tencentcs.com |
法兰克福 | eu-frankfurt | eu-frankfurt.cls.tencentyun.com | eu-frankfurt.cls.tencentcs.com |
东京 | ap-tokyo | ap-tokyo.cls.tencentyun.com | ap-tokyo.cls.tencentcs.com |
首尔 | ap-seoul | ap-seoul.cls.tencentyun.com | ap-seoul.cls.tencentcs.com |
雅加达 | ap-jakarta | ap-jakarta.cls.tencentyun.com | ap-jakarta.cls.tencentcs.com |
圣保罗 | sa-saopaulo | sa-saopaulo.cls.tencentyun.com | sa-saopaulo.cls.tencentcs.com |
地域 | 简称 | 内网域名 | 外网域名 |
北京 | ap-beijing | bj-producer.cls.tencentyun.com | bj-producer.cls.tencentcs.com |
广州 | ap-guangzhou | gz-producer.cls.tencentyun.com | gz-producer.cls.tencentcs.com |
上海 | ap-shanghai | sh-producer.cls.tencentyun.com | sh-producer.cls.tencentcs.com |
成都 | ap-chengdu | cd-producer.cls.tencentyun.com | cd-producer.cls.tencentcs.com |
南京 | ap-nanjing | nj-producer.cls.tencentyun.com | nj-producer.cls.tencentcs.com |
重庆 | ap-chongqing | cq-producer.cls.tencentyun.com | cq-producer.cls.tencentcs.com |
中国香港 | ap-hongkong | hk-producer.cls.tencentyun.com | hk-producer.cls.tencentcs.com |
硅谷 | na-siliconvalley | usw-producer.cls.tencentyun.com | usw-producer.cls.tencentcs.com |
弗吉尼亚 | na-ashburn | use-producer.cls.tencentyun.com | use-producer.cls.tencentcs.com |
新加坡 | ap-singapore | sg-producer.cls.tencentyun.com | sg-producer.cls.tencentcs.com |
曼谷 | ap-bangkok | th-producer.cls.tencentyun.com | th-producer.cls.tencentcs.com |
法兰克福 | eu-frankfurt | de-producer.cls.tencentyun.com | de-producer.cls.tencentcs.com |
东京 | ap-tokyo | jp-producer.cls.tencentyun.com | jp-producer.cls.tencentcs.com |
首尔 | ap-seoul | kr-producer.cls.tencentyun.com | kr-producer.cls.tencentcs.com |
雅加达 | ap-jakarta | jkt-producer.cls.tencentyun.com | jkt-producer.cls.tencentcs.com |
圣保罗 | sa-saopaulo | ao-producer.cls.tencentyun.com | sao-producer.cls.tencentcs.com |
地域 | 简称 | 内网域名 | 外网域名 |
北京 | ap-beijing | kafkaconsumer-ap-beijing.cls.tencentyun.com | kafkaconsumer-ap-beijing.cls.tencentcs.com |
广州 | ap-guangzhou | kafkaconsumer-ap-guangzhou.cls.tencentyun.com | kafkaconsumer-ap-guangzhou.cls.tencentcs.com |
上海 | ap-shanghai | kafkaconsumer-ap-shanghai.cls.tencentyun.com | kafkaconsumer-ap-shanghai.cls.tencentcs.com |
成都 | ap-chengdu | kafkaconsumer-ap-chengdu.cls.tencentyun.com | kafkaconsumer-ap-chengdu.cls.tencentcs.com |
南京 | ap-nanjing | kafkaconsumer-ap-nanjing.cls.tencentyun.com | kafkaconsumer-ap-nanjing.cls.tencentcs.com |
重庆 | ap-chongqing | kafkaconsumer-ap-chongqing.cls.tencentyun.com | kafkaconsumer-ap-chongqing.cls.tencentcs.com |
中国香港 | ap-hongkong | kafkaconsumer-ap-hongkong.cls.tencentyun.com | kafkaconsumer-ap-hongkong.cls.tencentcs.com |
硅谷 | na-siliconvalley | kafkaconsumer-na-siliconvalley.cls.tencentyun.com | kafkaconsumer-na-siliconvalley.cls.tencentcs.com |
弗吉尼亚 | na-ashburn | kafkaconsumer-na-ashburn.cls.tencentyun.com | kafkaconsumer-na-ashburn.cls.tencentcs.com |
新加坡 | ap-singapore | kafkaconsumer-ap-singapore.cls.tencentyun.com | kafkaconsumer-ap-singapore.cls.tencentcs.com |
曼谷 | ap-bangkok | kafkaconsumer-ap-bangkok.cls.tencentyun.com | kafkaconsumer-ap-bangkok.cls.tencentcs.com |
法兰克福 | eu-frankfurt | kafkaconsumer-eu-frankfurt.cls.tencentyun.com | kafkaconsumer-eu-frankfurt.cls.tencentcs.com |
东京 | ap-tokyo | kafkaconsumer-ap-tokyo.cls.tencentyun.com | kafkaconsumer-ap-tokyo.cls.tencentcs.com |
首尔 | ap-seoul | kafkaconsumer-ap-seoul.cls.tencentyun.com | kafkaconsumer-ap-seoul.cls.tencentcs.com |
雅加达 | ap-jakarta | kafkaconsumer-ap-jakarta.cls.tencentyun.com | kafkaconsumer-ap-jakarta.cls.tencentcs.com |
地域 | 简称 | 内网域名 | 外网域名 |
北京 | ap-beijing | ap-beijing.cls.tencentyun.com | ap-beijing.cls.tencentcs.com |
广州 | ap-guangzhou | ap-guangzhou.cls.tencentyun.com | ap-guangzhou.cls.tencentcs.com |
上海 | ap-shanghai | ap-shanghai.cls.tencentyun.com | ap-shanghai.cls.tencentcs.com |
成都 | ap-chengdu | ap-chengdu.cls.tencentyun.com | ap-chengdu.cls.tencentcs.com |
南京 | ap-nanjing | ap-nanjing.cls.tencentyun.com | ap-nanjing.cls.tencentcs.com |
重庆 | ap-chongqing | ap-chongqing.cls.tencentyun.com | ap-chongqing.cls.tencentcs.com |
中国香港 | ap-hongkong | ap-hongkong.cls.tencentyun.com | ap-hongkong.cls.tencentcs.com |
硅谷 | na-siliconvalley | na-siliconvalley.cls.tencentyun.com | na-siliconvalley.cls.tencentcs.com |
弗吉尼亚 | na-ashburn | na-ashburn.cls.tencentyun.com | na-ashburn.cls.tencentcs.com |
新加坡 | ap-singapore | ap-singapore.cls.tencentyun.com | ap-singapore.cls.tencentcs.com |
曼谷 | ap-bangkok | ap-bangkok.cls.tencentyun.com | ap-bangkok.cls.tencentcs.com |
法兰克福 | eu-frankfurt | eu-frankfurt.cls.tencentyun.com | eu-frankfurt.cls.tencentcs.com |
东京 | ap-tokyo | ap-tokyo.cls.tencentyun.com | ap-tokyo.cls.tencentcs.com |
首尔 | ap-seoul | ap-seoul.cls.tencentyun.com | ap-seoul.cls.tencentcs.com |
雅加达 | ap-jakarta | ap-jakarta.cls.tencentyun.com | ap-jakarta.cls.tencentcs.com |
圣保罗 | sa-saopaulo | sa-saopaulo.cls.tencentyun.com | sa-saopaulo.cls.tencentcs.com |
地域 | 简称 | 内网域名 | 外网域名 |
北京 | ap-beijing | cls.internal.tencentcloudapi.com | cls.ap-beijing.tencentcloudapi.com |
广州 | ap-guangzhou | cls.internal.tencentcloudapi.com | cls.ap-guangzhou.tencentcloudapi.com |
上海 | ap-shanghai | cls.internal.tencentcloudapi.com | cls.ap-shanghai.tencentcloudapi.com |
成都 | ap-chengdu | cls.internal.tencentcloudapi.com | cls.ap-chengdu.tencentcloudapi.com |
南京 | ap-nanjing | cls.internal.tencentcloudapi.com | cls.ap-nanjing.tencentcloudapi.com |
重庆 | ap-chongqing | cls.internal.tencentcloudapi.com | cls.ap-chongqing.tencentcloudapi.com |
中国香港 | ap-hongkong | cls.internal.tencentcloudapi.com | cls.ap-hongkong.tencentcloudapi.com |
硅谷 | na-siliconvalley | cls.internal.tencentcloudapi.com | cls.na-siliconvalley.tencentcloudapi.com |
弗吉尼亚 | na-ashburn | cls.internal.tencentcloudapi.com | cls.na-ashburn.tencentcloudapi.com |
新加坡 | ap-singapore | cls.internal.tencentcloudapi.com | cls.ap-singapore.tencentcloudapi.com |
曼谷 | ap-bangkok | cls.internal.tencentcloudapi.com | cls.ap-bangkok.tencentcloudapi.com |
法兰克福 | eu-frankfurt | cls.internal.tencentcloudapi.com | cls.eu-frankfurt.tencentcloudapi.com |
东京 | ap-tokyo | cls.internal.tencentcloudapi.com | cls.ap-tokyo.tencentcloudapi.com |
首尔 | ap-seoul | cls.internal.tencentcloudapi.com | cls.ap-seoul.tencentcloudapi.com |
雅加达 | ap-jakarta | cls.internal.tencentcloudapi.com | cls.ap-jakarta.tencentcloudapi.com |
圣保罗 | sa-saopaulo | cls.internal.tencentcloudapi.com | cls.sa-saopaulo.tencentcloudapi.com |
最近更新时间:2026-05-18 20:35:41
相关词汇 | 说明 |
日志集 | 每个账号每个地域下最多可以创建100个日志集 |
| 每个日志集下最多可以创建500个日志主题及指标主题 |
| 名称长度1至255个字符,允许的字符为 a-z、A-Z、0-9、_、- |
日志主题 | 主题名称长度为1至255个字符,允许的字符为 a-z、A-Z、0-9、_、- |
| 每个日志主题下最多50个分区,新增日志主题时最多能创建10个分区 |
| 每个主题最多可以绑定100个机器组 |
| 标准存储类型的日志主题,保存时间可为1 - 3600天,或永久保存 |
| 低频存储类型的日志主题,保存时间可为7 - 3600天,或永久保存 |
| 标准存储类型的日志主题,保存时间大于7天时,才能开启日志沉降功能 |
指标主题 | 主题名称长度为1至255个字符,允许的字符为 a-z、A-Z、0-9、_、- |
机器组 | 每个账号在不同地域下最多可以创建200个机器组 |
| 每个 IP 机器组最多可以绑定200个机器 IP |
| 每个标识机器组最多可以绑定50个 Label |
仪表盘 | 每个账号最多创建100个仪表盘订阅任务 |
最近更新时间:2025-09-25 20:19:43
限制 | 说明 |
Kafka 数据订阅任务 | 单个日志主题最多可以创建100个 Kafka 数据订阅任务。 |
限制 | 说明 |
Kafka Topic | 单个 Kafka 数据订阅任务最多可以消费100个 Kafka Topic。 |
单条日志大小 | 单条日志不可超过1MB。单条日志大小超过限制时,该日志会被丢弃。 |
单条 Kafka 消息 | 单条 Kafka 消息中最多只可包含一条日志,若超出整条消息将被作为解析失败日志处理。 |
起始位置 | 仅支持指定最早和最晚位置。不支持从指定时间的位置开始导入。 |
限制 | 说明 |
单个任务最大吞吐 | 单个任务最大吞吐不超过240MB/s。 |
最近更新时间:2026-06-05 18:36:55
项目 | 能力与限制 |
文件编码 | 支持 UTF8、GBK 格式编码。 注意: GBK 编码格式需要 LogListener 2.6.2及以上版本。 |
软链接 | 支持。 |
单条日志大小 | 单行日志大小限制为512KB,若日志超过512KB后,会截断只保留前512KB。 多行日志按行首正则表达式划分后(判断首行时会读取1MB数据进行判断),单条日志最大限制为512KB。若日志超过512KB后,会截断只保留前512KB。 |
正则表达式 | 正则表达式类型支持 Perl 兼容正则表达式。 |
首次日志采集行为 | LogListener 支持全量采集/增量采集策略: 全量采集:首次安装启动 LogListener 后,会采集所有符合条件的日志,包括已经没有写入的文件。 增量采集:首次安装启动 LogListener 后,存量文件会从最新位置开始采集。 注意: 增量/全量采集需要 LogListener 2.6.2及以上版本。 |
日志文件轮转 | 支持。(推荐轮转后的文件名,不要被采集通配路径覆盖到) 注意: 文件轮转后60秒内,若无新增日志写入轮转后的日志文件,轮转后的日志文件将不会再被采集,否则将持续采集轮转后的日志文件。 |
日志解析失败时采集行为 | 推荐开启解析失败上传功能,开启后将会把解析失败的日志按照单行全文格式上传至预设索引中。否则,解析失败日志将被丢弃。 |
文件打开行为 | LogListener 会在采集读取文件时打开,读完关闭。 |
过滤规则 | 单、多行全文采集最多可配置1条过滤规则。 |
| 分隔符、正则提取模式、JSON 格式最多可以配置5条过滤规则。 |
Key 字段长度 | 分隔符、正则提取模式 Key 字段长度最多为128Byte。 |
Key-Value 组个数 | 所有解析模式下,提取 Key-Value 组的个数最多为1000个,超过部分将会被丢弃。 |
LogListener 最大连接数 | LogListener 最大连接数限制:1024。 |
内存占用 | LogListener 的内存占用,正常情况最多50MB。 |
CPU占用 | LogListener 的 CPU 使用在5MB/s日志量下,业务进程合计不超过单核20%。 |
采集配置生效延时 | 更新采集配置之后会有1分钟的生效延时。 |
日志文件 | LogListener 运行的采集目标日志文件大小建议小于500MB。 |
项目 | 能力与限制 |
Checkpoint 保存位置 | 保存路径默认为 LogListener 安装目录下 data 目录下。若需修改,可参见 配置 LogListener,修改 LogListener 配置文件中的 checkpoint_cache_file,修改 Checkpoint 保存位置。 |
Checkpoint 保存策略 | LogListener 存有两份 checkpoint 元数据: 一份只记录已上传完成的位点信息,实时持久化到磁盘上。 一份同时记录了已完成位点信息与已采集但尚未完成的位点信息,周期性持久化到磁盘上。程序退出时也会优先进行持久化。 |
项目 | 能力与限制 |
默认 CPU 核数限制 | LogListener 仅支持单核运行。 |
默认 CPU 资源限制 | LogListener 默认未做 CPU 资源限制,若需限制,可参见 配置 LogListener,修改 LogListener 配置文件中的 cpu_usage_thres 最大 CPU 利用率。目前 LogListener 的实现架构,如未做 CPU 资源限制,其最高能够达到的单核 CPU 使用率为110%左右(业务线程最大100%, 管控线程10%左右)。 |
默认线程数限制 | LogListener 2.x.x版本仅支持单线程运行。LogListener 3.x.x版本支持多线程能力。 |
默认内存资源限制 | |
默认带宽资源限制 | |
资源超限处理策略 | 若 LogListener 占用相关 CPU 和内存资源超过最大限制的时间超过5分钟,则采集程序会强制自动重启。 |
日志压缩 | |
监控目录数 | 默认最大监控目录数5000,如超出可能会引起采集失败。 |
监控文件数 | 推荐最大监控文件数10000,如超出可能会引起采集失败。 |
监控事件数 | Polling 模式下,推荐最大事件数10000,如超出可能会引起采集失败。 |
项目 | 能力与限制 |
网络错误处理 | 非需要特殊处理的异常(如日志主题删除),其它错误都会进行重试(网络异常、超时、频控、欠费等)。 |
超时最大重试时间 | 若数据持续发送失败超过1小时,则丢弃该数据。 默认行为是间隔重试,且重试间隔时间会越来越长,直至超过超时最大尝试时间。 |
重试次数 | 可通过 loglistener.conf 配置文件设置,默认不配置。此时默认会一直重试,直至超过最大重试时间,之后丢弃。 如果配置了重试次数,则按照重试次数进行重试,超过最大次数则丢弃。 |
换行符缺失 | 采集时,若单条日志结尾缺少换行符,采集器将等待五分钟, 若五分钟内没有检测到换行符,将自动填充换行符,并继续往下采集。 |
项目 | 能力与限制 |
日志上传策略 | LogListener 会将同一文件的日志自动聚合上传,聚合条件为:10000条日志、日志集合总大小达到1M或者日志采集时间超过3秒,任一条件满足则触发上传行为。 |
文件采集的处理策略 | 单个目标文件(采集路径所能匹配到的一个文件)只支持上传日志到一个日志主题中,不支持多个 topic 的采集路径覆盖到同一个文件。如果想要将一个文件上传到多个日志主题中,可以通过软链接进行;对同一个目标文件创建多个软链接,不同的日志主题采集不同的软链接。 |
日志采集延迟 | 实时采集情况下,会在1分钟之内完成数据采集、传输、存储落盘,达到控制台可检索的效果。 如果日志生产量巨大,或者将采集程序使用的资源限制的较小,会有一定的采集延迟。 |
项目 | 能力与限制 |
采集配置数量限制 | 一个日志主题可关联的采集配置数量上限为100个 |
项目 | 能力与限制 |
机器组逻辑 | 目前机器组分为两类,其使用方法是相互独立的,且两种用法是不兼容的,如果混合使用,采集机器将拉取不到正确的采集配置,造成不采集的现象。 IP 机器组,机器 IP 需要在控制台上手动加入机器组,对应机器上 loglistener.conf 的 group_label 需为空。 标签机器组,控制台设置机器组标签,对应机器上 loglistener.conf 的 group_label 需要设置为相同的标签。 |
机器组与日志主题的关系 | 单个日志主题,可以绑定多个机器组。 单个机器组,可以绑定到多个日志主题上。 |
机器组与采集机器的关系 | 单个采集机器,可以加入到多个机器组中。 对于 IP 机器组,采集机器加入的机器组数量不受限制。 对于标签机器组,采集机器加入的机器组数量上限为20个。 |
标签机器组 label 限制 | 标签机器组的 label,目前限制为32个字符。 标签机器组,单个机器组最多可设置20个 label。 |
项目 | 能力与限制 |
采集黑名单 | 此功能是用来指定采集路径下,需要忽略采集的内容,目前采集黑名单分为两类: 文件路径模式:采集路径下,需要忽略采集的完整文件路径,支持通配模式。 目录路径模式:采集路径下,需要忽略采集的目录前缀,支持通配模式。 注意: FILE/PATH 模式可以同时使用。 采集黑名单是在采集路径下进行排除,因此无论是文件路径模式,还是目录路径模式,其指定路径要求为采集路径的子集。 |
最近更新时间:2026-05-27 21:18:09
限制项 | 说明 |
上传日志 | |
| |
| log 中单个 value 最大为1MB。 |
| |
| Log 中的 Key 不能是以下保留字段,且不能以 _ 开头 "__FILENAME__"、"__TIMESTAMP__"、"__LOGSETID__"、"__TOPICID__"。 |
| 单次上传请求的包体压缩前不能超过6MB。 |
频控 | 说明: 此处500QPS不代表500条日志。 一次请求中的 pb 包可以包含多条日志批量上传。 |
| |
流控 | |
| |
最近更新时间:2026-05-27 21:18:52
限制 | 说明 |
上传日志 | 单次上传请求的日志压缩前不能超过5MB,建议控制在3MB以内。 |
最近更新时间:2026-05-27 21:20:01
限制项 | 说明 |
文件预览限制 | 仅支持预览小于1G 的文件 |
限制项 | 说明 |
单个文件大小 | 单个文件大小不可超过5G。若超过限制,导入任务将忽略整个文件 |
单条日志大小 | 单行日志大小限制为512KB,若日志超过512KB 后,会截断只保留前512KB。 多行日志按行首正则表达式划分后,单条日志最大限制为1M。 |
正则表达式 | 正则表达式类型支持 Perl 兼容正则表达式。 |
日志解析失败时采集行为 | 推荐开启解析失败上传功能,开启后将会把解析失败的日志按照单行全文格式上传至预设索引中。否则,解析失败日志将被丢弃。 |
Key 字段长度 | 分隔符、正则提取模式 Key 字段长度最多为128Byte。 |
Key-Value 组个数 | 所有解析模式下,提取 Key-Value 组的个数最多为1000个,超过部分将会被丢弃。 |
最近更新时间:2024-12-16 14:59:00
限制项 | 说明 |
指标名称(metric name) | 支持英文字母、数字、下划线及冒号,即需符合正则表达式 [a-zA-Z_:][a-zA-Z0-9_:]* |
维度名称(label name) | 支持英文字母、数字、下划线,即需符合正则表达式 [a-zA-Z_][a-zA-Z0-9_]* |
维度值(label value) | 无特殊限制,支持各类 Unicode 字符 |
样本值(sample value) | float64类型数值 |
样本时间戳(sample timestamp) | 毫秒精度 |
指标上传频控 | |
指标上传流控 |
最近更新时间:2026-05-14 21:21:44
分类 | 限制项 | 说明 |
索引 | 字段数量 | |
| 字段名称 | 支持除 *\",外的所有英文字母、符号及数字,不能以_开头(__CONTENT__字段例外)。不允许同时包含 JSON 父子级字段,例如 a及a.b。 |
| 字段层级 | 为多层级 JSON 配置键值索引时,Key 的层级不能超过10层,例如 a.b.c.d.e.f.g.h.j.k。 |
| 分词符 | 仅支持英文符号、\n\t\r及转义符\。 |
| 字段长度 | 检索限制:每个字段仅前1MB的日志参与检索,超出部分无法执行检索。 统计限制:开启统计后,每个字段仅前32766个字节参与 SQL 运算,超出部分无法执行 SQL。 超出上述限制的日志字段,仍会完整存储,可查看或下载,只是超出部分无法检索或统计。 |
| 分词长度 | 分词后,单个词仅前10000个字符参与检索,超出部分无法执行检索,但仍会完整存储日志。 |
| 数值字段精度 及范围 | long 类型字段支持数据范围为-1E15 ~ 1E15,超出该范围的数据可能会丢失精度或不支持检索。 double 类型字段支持数据范围为-1.79E+308 ~ +1.79E+308,如果浮点数编码位数超过64位,会造成精度丢失。 超长数值字段索引配置建议: 如果不需要通过数值范围比较来检索该字段,可将该字段存储为 text 类型。 如果需要通过数值范围比较来检索该字段,可将该字段存储为 double 类型,可能会丢失部分精度。 |
| 生效机制 | 索引配置仅针对新采集的数据生效,索引规则编辑后仅对新写入的日志生效,已有数据不会更新。如需更新已有数据,需重建索引。 |
| 修改索引配置 | 创建、修改及删除索引配置时,单个用户最大同时拥有10个执行中的任务,超出后需等待之前的任务执行完毕,单个任务执行一般不超过1分钟。 |
| 重建索引 | 单个日志主题同时仅允许运行一个重建索引任务,单个日志主题最多同时拥有10个重建索引任务记录,需删除不再需要的任务记录后才能新建索引任务。 同一时间范围内的日志,仅允许重建一次索引,需删除之前的任务记录后才能再次重建。 所选时间范围对应日志写流量不能超出5TB。 重建索引时间范围以日志时间为准,日志上传时间与重建索引时间范围有超过1小时的偏差时(例如16:00上传了一条02:00的日志到 CLS,重建00:00~12:00的日志索引)不会被重建且后续无法进行检索。新上报一条日志到已经被重建的日志时间范围时,也不会被重建且后续无法进行检索。 |
查询 | 语句长度 | 检索分析语句最长支持12000字符。 |
| 查询并发 | 单个日志主题支持15并发,包括检索及分析。 |
| 模糊检索 | 不支持前缀模糊检索,例如通过 *rror检索 error。 |
| 短语检索 | 短语检索中的通配符仅能匹配到符合条件的128个词,返回包含这128个词的所有日志,指定的词越精确,查询结果越精确。 |
| 逻辑分组嵌套深度 | CQL 语法规则下使用括号对检索条件进行逻辑分组时,最多可嵌套10层,Lucene 语法规则无该限制。 例如 (level:ERROR AND pid:1234) AND service:test为2层嵌套,可正常执行检索;而下面的语句为11层嵌套,执行检索将会报错status:"499" AND ("0.000" AND (request_length:"528" AND ("https" AND (url:"/api" AND (version:"HTTP/1.1" AND ("2021" AND ("0" AND (upstream_addr:"169.254.128.14" AND (method:"GET" AND (remote_addr:"114.86.92.100"))))))))))。 |
| 内存占用量(分析) | 统计分析每次所占用的服务端内存不能超过3GB。 通常在使用 group by、distinct()、count(distinct()) 时可能触发该限制,是由于被统计的字段在通过 group by 或 distinct() 去重后值过多导致的。建议优化查询语句,使用值更少的字段对数据进行分组统计;或使用 approx_distinct() 替代 count(distinct())。 |
| 查询结果 | 查询结果为原始日志时,单次最大返回1000条原始日志。 |
| | |
| | |
| 超时时间 | 单次查询超时时间为55秒,包括检索及分析。 |
| 查询延迟 | 从日志上报到可被检索分析的延迟小于1分钟。 |
下载 | 日志条数 | 单次下载日志条数最多为5000万条。 |
| 任务数量 | 单个日志主题最多2个任务处于“文件生成中”状态,其它未完成的任务处于“等待中”状态,排队等待执行。 单个日志主题最多同时存在1000个任务,包含处于“文件已生成”状态的已完成的任务。 |
| 文件保存时长 | 生成的日志文件仅保留3天。 |
关联外部数据 | 数量限制 | 单个日志主题最多可关联20个外部数据。 |
| 查询超时 | 查询外部数据库时,超时时间为50秒。 |
| MySQL 版本 | 兼容 MySQL 5.7、8.0及更高版本。MySQL 5.6未经过完整兼容性测试,需实际试验证SQL 语句执行是否正常。 |
| CSV 文件大小 | 不能超过50MB,不支持压缩。 |
限制项 | 说明 |
查询并发 | 单个指标主题支持15并发。 |
查询数据量 | 单次查询涉及 time series 不超过20万,查询结果中单个 time series 最大1.1万个时间点。 |
超时时间 | 单次查询超时时间为55秒,包括检索及分析。 |
最近更新时间:2026-05-18 20:20:33
分类 | 限制项 | 说明 |
告警策略 | 监控对象 | 单个告警策略最多可选择20个日志主题,不支持跨地域。 |
| 执行语句 | |
| 执行语句数量 | 各个执行语句使用相同日志主题时,单个告警策略最多可添加3个执行语句。 各个执行语句单独选择日志主题时,单个告警策略最多可添加10个执行语句。 |
| 执行语句查询时间范围 | 最大时间范围为最近24小时。 |
| 执行周期 | 最小执行周期为1分钟,最大执行周期为1440分钟。 |
| 分组触发 | 最多可将执行语句结果分为1000个组,对这1000个组分别判断是否满足触发条件,超出范围的组将不执行判断。 说明: 分组触发为可选功能,未启用时不涉及该限制。 |
| 触发条件判断次数 | 当执行语句结果为多个值时(分组后),会根据结果数据依次判断是否满足触发条件,当满足触发条件或超过1000次后停止判断。 |
告警渠道 | 电话告警 | 同一号码30秒内最多接收1条电话告警,10分钟内最多接收3条电话告警,1天内最多接收50条电话告警。 同一号码22:00至次日08:00最多接收3条电话告警,如需去除该限制,请在 消息中心 中开启夜间接收状态开关。 以上限制不局限于日志服务产生的电话告警通知,腾讯云可观测平台及消息中心产生的电话通知会共享该限制。 使用电话接收告警时,建议您将以下电话号码添加至手机及运营商骚扰电话拦截白名单中,以免被拦截: 电话列表:消息中心-电话列表。 电话列表中号码较多,如需固定为较少的几个电话号码,请在 消息中心 中开启固定语音号码通知开关。 |
| 企业微信、钉钉、飞书 | 每个机器人发送的消息不能超过20条/分钟。 |
| 自定义接口回调 | 须支持公网访问,不支持内网地址。 接口返回状态码为200时表示回调成功。 |
告警历史 | 存储时长 | 30天 |
告警通知 | 告警通知变量 | {{.Message}}:最大10KB。 {{.QueryResult}}:每个执行语句最多1000条数据、最大10KB,最多10个执行语句,总计最大100KB。 {{.TriggerResult}}:每个语句最多1000 条数据、最大10KB,最多10个执行语句,总计最大100KB。 {{.QueryLog}}:每个执行语句最多10条数据、最大50KB,最多10个执行语句,总计最大150KB。 {{.AnalysisResult}}:每个多维分析最多10KB,最多5个多维分析,总计最大50KB。 相关原始日志:每个语句最多10条数据,以用户配置为准。 字段Top5及占比统计:每个语句最多5条数据。 自定义检索分析(SQL):每个语句最多1000条数据。 自定义检索分析(检索):每个语句最多10条数据。 |
最近更新时间:2026-05-18 20:32:25
分类 | 限制项 | 说明 |
数据加工 | 数据加工任务数 | 1个日志主题可以创建50个数据加工任务。 |
| 目标主题个数 | 1个数据加工任务最多可以有1000个目标主题。 |
| 调试数据条数 | 默认加载100条源日志主题中的日志,用于您的数据加工语句调试。 |
| 处理能力 | 源日志主题的每个分区可处理 10 - 20MB(非压缩)/秒的数据。 |
| 加工任务时延 | 99.9%的数据将在1秒内在数据加工模块内处理完成。 |
| 加工任务启停对数据的影响 | 加工任务暂停后12小时内重启,从暂停时的数据开始加工。超出12小时重启,从最新数据开始加工。 |
| 跨地域/跨账号 | 跨账号支持。跨地域暂不支持。 |
| 加工历史数据 | 暂不支持。 |
定时 SQL 分析 | 定时 SQL 任务数 | 1个日志主题可以和10个定时 SQL 任务相关(该日志主题可以是任务的源日志主题,或者目标日志主题,都计算在内)。 |
| 查询并发 | 单个日志主题支持15并发(并发包含 定时 SQL 、检索分析、仪表盘、告警)。 |
| 查询结果 | 查询结果为统计分析结果时,单次默认返回100条结果,使用 SQL LIMIT 语法,单次可最大返回100万条结果。 |
| | 查询结果返回数据包最大49MB,使用 API 时可启用 gzip 压缩。 |
| 查询超时时间 | 单次查询超时时间为55秒。 |
| SQL 时间窗口 | 1分钟 - 7天。 |
| 调度周期 | 1分钟 - 24小时。 |
| 自定义时间戳 | 最小自定义时间戳的间隔为15秒,例如15:00:00,15:00:15,15:00:30。 |
| 延迟执行 SQL | 默认60秒,最大为120秒。99.9%的日志索引需要5秒左右生成,极端情况60秒,因此配置延迟执行,确保该查询可以成功获取索引数据。 |
| 跨地域/跨账号 | 暂不支持。 |
最近更新时间:2024-12-17 17:56:37
分类 | 限制项 | 说明 |
投递 COS | 投递任务数 | 每个日志主题投递 COS 任务配置个数最多为10个。 |
| 可投递的数据范围 | 日志主题的生命周期内的数据(包含历史数据和实时数据)。 |
| 投递任务时延 | 投递 COS 的时延在60秒左右。 说明: 假如您配置投递时间间隔为5分钟,那么12:00 - 12:05的日志,满足了5分钟间隔的条件,这部分日志会作为一个批次,整体投递到 COS,时延为60秒,那么这个批次的日志将在12:06左右到达 COS。 |
| 投递触发 | 单个分区满足以下条件任意一个时,触发一次投递: 投递日志大小(累计日志数据),您可配置该参数,5-256MB(未压缩)。 投递时间间隔,5-15分钟,您可配置该参数,5-15分钟。 |
| 跨账号/跨地域 | 跨账号:支持 跨地域:暂不支持 |
投递 CKafka | 投递任务数 | 每个日志主题可配置一个 CKafka 投递任务。 |
| 可投递的数据范围 | 实时日志数据,暂不能投递历史数据。 |
| 投递任务时延 | 99.9%的日志投递 CKafka 的时延在5秒内。(目标 CKafka 状态正常,且吞吐能力足够处理来自 CLS 的消息,不存在磁盘写满或者限流的情况)。 说明: 某一条日志采集到 CLS 的时间戳(_TIMESTAMP_字段的值)为12:00:00,该条日志将在12:00:05秒之前到达 CKafka。 |
| 跨账号/跨地域 | 跨账号:支持 跨地域:暂不支持 |
Kafka 协议消费 | 版本 | 支持 Kafka 协议版本为:1.1.1及更早的版本。 |
| 消费组个数 | 每个日志主题可配置20个消费组。 |
| 认证方式 | 仅支持 SASL_PLAINTEXT。 |
| 可消费的数据范围 | 开启该功能后,默认将从最新数据开始消费。消息保留时间2小时,超过2小时还未消费的数据将不会被保存。 说明: 例如您12:00打开 Kafka 协议消费,那么您将从12:00的数据开始消费,到15:00,您可以消费13:00-15:00的数据,13:00之前的数据不能消费。 |
| 消费时延 | 99.9%的日志消费的时延在5秒内。 说明: 某一条日志采集到 CLS 的时间戳(_TIMESTAMP_字段的值)为12:00:00,该条日志将在12:00:05秒之前到达消费端。 |
| 跨账号/跨地域 | 跨账号:A 账号可以作为 B 账号的协作者,消费 B 账号的日志主题。需对协作者设置权限,详情请参见 权限配置。 跨地域:通过外网消费实现跨地域消费。 |
最近更新时间:2026-05-14 21:20:02
59.x.x.x - - [06/Aug/2019:12:12:19 +0800] "GET /nginx-logo.png HTTP/1.1" 200 368 "http://119.x.x.x/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36" "-"
java.net.SocketTimeoutException:Receive timed outat j.n.PlainDatagramSocketImpl.receive0(Native Method)[na:1.8.0_151]at j.n.AbstractPlainDatagramSocketImpl.receive(AbstractPlainDatagramSocketImpl.java:143)[^]at j.n.DatagramSocket.receive(DatagramSocket.java:812)[^]at o.s.n.SntpClient.requestTime(SntpClient.java:213)[classes/]at o.s.n.SntpClient$1.call(^:145)[^]at ^.call(^:134)[^]at o.s.f.SyncRetryExecutor.call(SyncRetryExecutor.java:124)[^]at o.s.f.RetryPolicy.call(RetryPolicy.java:105)[^]at o.s.f.SyncRetryExecutor.call(SyncRetryExecutor.java:59)[^]at o.s.n.SntpClient.requestTimeHA(SntpClient.java:134)[^]at ^.requestTimeHA(^:122)[^]at o.s.n.SntpClientTest.test2h(SntpClientTest.java:89)[test-classes/]at s.r.NativeMethodAccessorImpl.invoke0(Native Method)[na:1.8.0_151]
分类 | 字段 | 含义 | 示例 |
内置保留字段 | __TIMESTAMP__ | 日志时间戳(毫秒级别 Unix 时间戳),按时间范围检索日志时,将自动使用该时间对日志进行检索,在控制台显示为“日志时间” | 1640005601188 |
| __FILENAME__ | 日志采集的文件名 | /data/log/nginx/access.log |
| __SOURCE__ | 日志采集的源 IP | 10.0.1.2 |
| __HOSTNAME__ | 日志来源机器名称,需使用2.7.4及以上版本的 Loglistener 才会采集该字段 | localhost |
| __RAWLOG__ | {"ip":"10.20.20.10","request":"GET /online/sample HTTP/1.1","status":200,"time":"[2018-07-16 13:12:57]"} | |
| __INDEX_STATUS__ | 日志创建索引异常原因,值非空时代表当前日志创建索引出现异常,原始日志被存储在
__RAWLOG__中,__INDEX_STATUS__为异常原因 | IndexPartFail:part of fields do not match the index configuration |
日志正文 | __CONTENT__ | 日志提取模式为单行全文或多行全文(即原始日志不经切分,直接将整条日志上报)时,整条日志存储在该字段中 | 10.20.20.10;[2018-07-16 13:12:57];GET /online/sample HTTP/1.1;200 |
| 普通字段 | IP: 10.20.20.10
request: GET /online/sample HTTP/1.1
status: 200
time: [2018-07-16 13:12:57] | |
元数据 | 元数据字段 | 对日志的简单描述或归类,例如 TKE 日志中,某条日志所属的集群或容器,以 key:value 的形式存储,key 以__TAG__.开头 | __TAG__.clusterId:1skzv59c |
最近更新时间:2026-05-19 21:55:46

日志集 | 日志主题 | 标签 |
e_commerce_logset | payService_access_log_topic | 部门:部门 A |
e_commerce_logset | payService_error_log_topic | 部门:部门 A |
e_commerce_logset | userService_access_log_topic | 部门:部门 A |
e_commerce_logset | userService_error_log_topic | 部门:部门 A |
e_commerce_logset | stockService_access_log_topic | 部门:部门 A |
e_commerce_logset | stockService_error_log_topic | 部门:部门 A |
e_commerce_logset | ...... | 部门:部门 A |
gameApplet_logset | gameApplet_nginx_log_topic | 部门:部门 B |
socialApplet_logset | socialApplet_nginx_log_topic | 部门:部门 B |
最近更新时间:2024-01-20 16:33:21
机器 | 部署服务 | 日志文件路径 |
192.168.1.1 | payService | /data/log/payService/access_log.log /data/log/payService/error_log.log |
192.168.1.2 | payService | /data/log/payService/access_log.log /data/log/payService/error_log.log |
192.168.1.3 | userService,stockService | /data/log/userService/access_log.log /data/log/userService/error_log.log /data/log/stockService/access_log.log /data/log/stockService/error_log.log |
192.168.1.4 | userService,stockService | /data/log/userService/access_log.log /data/log/userService/error_log.log /data/log/stockService/access_log.log /data/log/stockService/error_log.log |
192.168.1.5 | userService,stockService | /data/log/userService/access_log.log /data/log/userService/error_log.log /data/log/stockService/access_log.log /data/log/stockService/error_log.log |
192.168.1.6 | userService,stockService | /data/log/userService/access_log.log /data/log/userService/error_log.log /data/log/stockService/access_log.log /data/log/stockService/error_log.log |
机器 | 部署服务 | 标识 |
192.168.1.1 | payService | payService |
192.168.1.2 | payService | payService |
192.168.1.3 | userService,stockService | userService,stockService |
192.168.1.4 | userService,stockService | userService,stockService |
192.168.1.5 | userService,stockService | userService,stockService |
192.168.1.6 | userService,stockService | userService,stockService |
日志主题 | 关联机器组 | 采集路径 |
payService_access_log_topic | payService | /data/log/payService/access_log.log |
payService_error_log_topic | payService | /data/log/payService/error_log.log |
userService_access_log_topic | userService | /data/log/userService/access_log.log |
userService_error_log_topic | userService | /data/log/userService/error_log.log |
stockService_access_log_topic | stockService | /data/log/stockService/access_log.log |
stockService_error_log_topic | stockService | /data/log/stockService/error_log.log |
最近更新时间:2024-01-20 16:33:55
sample的如下完整日志:10.20.20.10;[2018-07-16 13:12:57];GET /online/sample HTTP/1.1;200
sample外还有很多其他内容,其与检索条件并不是直接相等,因此不能直接使用sample作为检索条件来检索该日志。为满足该检索需求,需要将日志全文切分为多个片段,每个片段称之为一个“词”,而这个过程称之为“分词”。@&()='",;:<>[]{}/ \n\t\r范围内的符号,就切分日志,将得到如下的词:

sample时,上述分词后的日志包含sample,即认为符合检索条件。
\/online\/login\用于转义/符号(该符号为检索语法保留符号,因此需要转义)。/符号是分词符,因此实际的检索条件为 online OR login,日志中只要包含 online 或 login,即符合检索条件。"/online/login"/符号无需再进行转义。login,不符合该检索条件。"/online/sample"online和sample,且顺序与检索条件一致,符合该检索条件。@&()='",;:<>[]{}/ \n\t\r即为分词符。用户登录失败,密码错误,需要使用"登录失败"进行检索,是不能通过符号对日志进行切分来满足检索需求的。此时可在 配置索引 中设置该日志“包含中文”,日志服务(Cloud Log Service,CLS)将自动将日志中的每一个汉字切分为独立的词。最近更新时间:2026-05-18 20:21:53
requests_total{method="POST", handler="/messages"} 217
# HELP nginx_http_requests_total The total number of HTTP requests# TYPE nginx_http_requests_total counternginx_http_requests_total 10234# HELP nginx_http_requests_duration_seconds The HTTP request duration in seconds# TYPE nginx_http_requests_duration_seconds histogramnginx_http_requests_duration_seconds_bucket{le="0.005"} 2405nginx_http_requests_duration_seconds_bucket{le="0.01"} 5643nginx_http_requests_duration_seconds_bucket{le="0.025"} 7890nginx_http_requests_duration_seconds_bucket{le="0.05"} 9234nginx_http_requests_duration_seconds_bucket{le="0.1"} 10021nginx_http_requests_duration_seconds_bucket{le="0.25"} 10234nginx_http_requests_duration_seconds_bucket{le="0.5"} 10234nginx_http_requests_duration_seconds_bucket{le="1"} 10234nginx_http_requests_duration_seconds_bucket{le="2.5"} 10234nginx_http_requests_duration_seconds_bucket{le="5"} 10234nginx_http_requests_duration_seconds_bucket{le="10"} 10234nginx_http_requests_duration_seconds_bucket{le="+Inf"} 10234nginx_http_requests_duration_seconds_sum 243.56nginx_http_requests_duration_seconds_count 10234# HELP nginx_http_connections Number of HTTP connections# TYPE nginx_http_connections gaugenginx_http_connections{state="active"} 23nginx_http_connections{state="reading"} 5nginx_http_connections{state="writing"} 7nginx_http_connections{state="waiting"} 11# HELP nginx_http_response_count_total The total number of HTTP responses sent# TYPE nginx_http_response_count_total counternginx_http_response_count_total{status="1xx"} 123nginx_http_response_count_total{status="2xx"} 9123nginx_http_response_count_total{status="3xx"} 456nginx_http_response_count_total{status="4xx"} 567nginx_http_response_count_total{status="5xx"} 65# HELP nginx_up Is the Nginx server up# TYPE nginx_up gaugenginx_up 1
最近更新时间:2026-05-11 18:01:32
类别 | 说明 |
频控 | 单个主题分区读请求限制:200QPS。超限返回状态码429,提示错误 SpeedQuotaExceed。 |
| 单个主题分区写请求限制:500QPS。超限返回状态码429,提示错误 SpeedQuotaExceed。 说明: 此处500QPS不代表500条日志。 一次请求中的 pb 包可以包含多条日志批量上传。 |
流控 | 单个主题分区读流量无限制,建议不超过5MB/s。 |
| 单个主题分区压缩后写流量限制:5MB/s。超限返回状态码429,提示错误 SpeedQuotaExceed。 |
5MB/s * 10 = 50MB/s。单个日志主题默认最大可拥有50个分区,对应的最大压缩后日志写流量为5MB/s * 50 = 250MB/s。 如您的业务场景下 50 个分区不满足需求,可 联系我们 进行开白,支持更大的分区数量。最近更新时间:2024-12-20 16:02:56
最近更新时间:2026-03-25 17:22:44
Entity / Party / Recipient Category | Purpose(s) of Entity’s Data Processing Activity | Processing Location |
- | - | - |
Entity / Party / Recipient Category | Purpose(s) of Entity’s Data Processing Activity | Processing Location |
- | - | - |