说明
云函数 SCF 于2021年1月29日起全量接入腾讯云 日志服务 CLS,在此之后创建的函数调用日志将投递至 CLS,并支持日志实时输出,在此日期前创建的函数正在按地域逐渐进行迁移,详情可参见 云函数日志服务变更说明。
权限说明
限制说明
函数调用日志投递至日志服务的限制如下:
每个请求5秒内打印的日志量上限为1MB。
每个请求5秒内打印的日志条数上限为5000条。
每条日志长度上限为8KB,超出将截取前8KB。
操作步骤
默认投递
新建函数时,如不指定日志投递主题,将会使用默认投递日志能力。默认投递日志时,SCF 将会为您开通日志服务并将函数调用日志投递至 SCF 专用日志集下的日志主题中,SCF 专用日志集和日志主题分别以
SCF_logset
和 SCF_logtopic
为前缀命名,如不存在将自动创建。函数调用日志默认保留7天,您可在 日志服务控制台 查看及管理。注意:
日志服务为独立计费产品,SCF 专用日志主题会占用日志服务免费额度,详情可参见 日志服务计费详情。
为保证 SCF 控制台日志正常展示,SCF 专用日志主题不建议修改索引配置,关闭索引会导致该主题下所有日志查询检索功能不可用。如需自定义日志索引配置,请参考下文 自定义投递 配置函数日志主题。
配置日志服务
1. 登录 Serverless 控制台,选择左侧导航栏中的 函数服务。
2. 在主界面上方选择期望创建函数的地域和命名空间,并单击新建,进入函数创建流程。
3. 在日志配置中,选择默认投递。如下图所示:
4. 单击完成即可创建函数,并完成函数日志默认投递。您可在函数管理 > 函数配置中查看日志配置。如下图所示:
查看和管理日志服务
您可单击函数配置中“日志配置”的日志集 ID,前往 日志服务控制台 查看和管理日志。SCF 专用日志集在日志服务控制台已用
SCF
字样进行标记,如有日志持久化存储、投递或消费、对日志内容进行监控告警等需要,均可在日志服务控制台完成配置。自定义投递
创建日志集和日志主题
注意
日志集地域请选择函数服务所在地域,暂不支持跨地域日志推送。
配置日志服务
1. 登录 Serverless 控制台,选择左侧导航栏中的 函数服务。
2. 在主界面上方选择期望创建函数的地域,并单击新建,进入函数创建流程。
3. 在日志配置中,选择自定义投递,并选择已为该函数创建的日志主题,本文以
SCF-test
为例。如下图所示:
4. 单击保存即可。
索引配置
日志检索依赖日志主题的索引配置,在函数创建时,SCF 会自动为您完成索引配置。如遇索引异常无法正常查看日志,请参考如下步骤配置索引:
1. 登录 Serverless 控制台,选择左侧导航栏中的 函数服务。
2. 在函数服务列表中,选择日志索引异常的函数名,进入函数管理页面。
3. 在日志查询页签中,选择高级检索中的索引配置。如下图所示:
4. 在索引配置中,开启索引状态和键值索引。如下图所示:
该配置方法仅对日志主题中已有函数调用日志的场景有效,日志主题中无函数调用日志,请参照下表手动配置键值索引。字段名称 | 字段类型 | 字段含义 |
SCF_FunctionName | text | 函数名称。 |
SCF_Namespace | text | 函数所在命名空间。 |
SCF_StartTime | long | 调用开始时间。 |
SCF_LogTime | long | 日志产生时间。 |
SCF_RequestId | text | 请求 ID。 |
SCF_Duration | long | 函数运行时间。 |
SCF_Alias | text | 别名。 |
SCF_Qualifier | text | 版本。 |
SCF_MemUsage | double | 函数运行内存。 |
SCF_Level | text | Log4J 日志级别,默认为 INFO。 |
SCF_Message | text | 日志内容。 |
SCF_Type | text | 日志类型,Platform 指平台日志,Custom 指用户日志。 |
SCF_StatusCode | long | |
SCF_RetryNum | long | 重试次数。 |
为保证云函数控制台日志展示效果,请在键值索引配置中为字段打开“开启统计”能力。
5. 完成索引配置后单击确定保存。