日志管理
日志管理提供云开发环境内各类资源运行日志的统一查看入口,支持按资源类型、时间范围、日志类型筛选,并配合检索语法快速定位问题。
访问入口
- 登录 云开发平台,选择目标环境。
- 在左侧菜单选择 日志监控。
- 在页面顶部 Tab 选择 日志管理。
筛选条件
页面顶部提供以下筛选项:
| 筛选项 | 说明 |
|---|---|
| 资源类型 | 选择要查看的资源,如云函数、数据库、HTTP 网关等 |
| 时间范围 | 预设近 3 天、近 7 天,或自定义时间段 |
| 日志类型 | 实时日志 / 历史日志 |
| 检索条件 | 点击“添加检索条件”进行精细化过滤 |
日志列表
日志列表按时间倒序排列。以云函数日志为例,列表包含以下字段:
| 字段 | 说明 |
|---|---|
| 序号 | 日志序号 |
| 日志时间 | 日志产生的时间,支持排序 |
| 日志内容 | 日志详细信息,例如 START RequestId: xxx |
| 调用状态 | 当前调用状态 |
| 函数名 | 触发日志的云函数名称 |
| 请求 ID | 本次请求的唯一标识 |
| 云函数版本 | 函数版本号,例如 $LATEST |
列表右上角提供列配置与搜索能力,可按需调整展示字段。
检索日志
日志管理支持三种检索方式:
| 检索方式 | 语法 | 适用场景 |
|---|---|---|
| 全文检索 | 直接输入关键词 | 快速定位包含关键词的日志 |
| 键值检索 | key:value | 按结构化字段精确查找 |
| 模糊检索 | abc*、ab?c | 关键词不完整时匹配 |
语法要点:
- 使用等号
a=b表示全等匹配。 - 使用冒号
a:b表示包含匹配,支持模糊搜索。 - 检索默认大小写敏感,匹配
ERROR时需输入大写关键词。
完整的检索语法、分词规则与示例,请参见 日志检索。
日志设置
如需关闭日志记录,请按以下步骤操作:
- 进入云开发控制台,选择目标环境。
- 点击左侧菜单 日志管理 > 日志设置。
- 选择 删除日志 并确认。
注意
关闭日志记录后不再产生新的日志数据,已有的历史日志仍可查询。
更多灵活用法
控制台适合交互式查看,如果需要批量查询、脚本化处理或交给 AI 分析,可以使用 CloudBase CLI 的日志检索命令:
# 搜索最近 1 小时的全部日志
tcb logs search -e <env-id>
# 按函数名过滤,最近 6 小时
tcb logs search -q 'function_name:"myFunc"' -t 6h -e <env-id>
完整语法与字段说明请参见 CLI 日志检索。
延伸能力
| 能力 | 说明 | 文档 |
|---|---|---|
| 日志长期存储 | 将日志投递到腾讯云日志服务(CLS),也支持再投递回云开发 | 投递到 CLS 日志服务 |
| 日志字段 | 查看各类日志的字段含义、类型与检索写法 | 日志字段说明 |
| 资源运行指标 | 查看调用量、耗时分布、存储量等监控指标 | 运维监控 |
| 异常自动通知 | 基于监控指标配置告警策略 | 监控指标告警 |
| 日志内容告警 | 按状态码、错误信息等日志内容配置告警 | 日志告警指南 |
注意事项
- 日志内容按分词符切分后,单个分词后的内容不能超过 32 KB。
- 运维监控与告警依赖日志及指标数据,数据上报存在一定延迟,建议结合实际时间窗口分析。