（在说正事之前，我要推荐一个福利：你还在原价购买阿里云、腾讯云、华为云服务器吗？那太亏啦！来这里，新购、升级、续费都打折，能够为您省60%的钱呢！2核4G企业级云服务器低至69元/年，点击进去看看吧>>>)

说明

若您的函数于2021年01月29日前创建，且需进行日志投递，则请参见 日志投递教程（旧）。

云函数 SCF 于2021年01月29日起全量接入腾讯云 日志服务 CLS，在此之后创建的函数调用日志将投递至 CLS，并支持日志实时输出。
本文介绍云函数 SCF 所提供的 默认投递 和 自定义投递 两种日志服务投递方式及其配置方法。

限制说明

函数调用日志投递至日志服务的限制如下：

• 每个请求5秒内打印的日志量上限为1MB。
• 每个请求5秒内打印的日志条数上限为5000条。
• 每条日志长度上限为8KB，超出将截取前8KB。

其他限制请参见 日志服务规格说明，请关注日志服务配置是否能够满足业务需求，超限可能会导致日志写入失败。

操作步骤

默认投递

新建函数时，如不指定日志投递主题，将会使用默认投递日志能力。默认投递日志时，SCF 将会为您开通日志服务并将函数调用日志投递至 SCF 专用日志集下的日志主题中，SCF 专用日志集和日志主题分别以 SCF_logset 和 SCF_logtopic 为前缀命名，如不存在将自动创建。函数调用日志默认保留7天，您可在 日志服务控制台 查看及管理。

注意

日志服务为独立计费产品，SCF 专用日志主题会占用日志服务免费额度，详情可参见 日志服务计费详情。

配置日志服务

1. 登录云函数控制台，选择左侧导航栏中的【函数服务】。
2. 在主界面上方选择期望创建函数的地域，并单击【新建】，进入函数创建流程。
3. 选择使用【模板创建】或选择使用【自定义创建】新建函数。本文以【自定义创建】为例。
4. 在“高级配置”中，选择“日志配置”中的“默认投递”。如下图所示：
   
5. 单击【完成】即可完成函数日志默认投递。您可在【函数管理】>【函数配置】中查看日志配置。如下图所示：
   

查看和管理日志服务

您可单击函数配置中“日志配置”的日志集 ID，前往 日志服务控制台 查看和管理日志。SCF 专用日志集在日志服务控制台已用 SCF 字样进行标记，如有日志持久化存储、投递或消费、对日志内容进行监控告警等需要，均可在日志服务控制台完成配置。

自定义投递

新建函数时，如需指定函数调用日志投递主题，可选择使用日志自定义投递能力。在使用日志自定义投递能力之前，需保证账号已经开通 日志服务。

创建日志集和日志主题

登录 日志服务控制台 并 创建日志集和日志主题。本文以在广州创建 SCF-test 日志集和日志主题为例。如下图所示：

注意：

日志集地域请选择函数服务所在地域，暂不支持跨地域日志推送。

配置日志服务

1. 登录云函数控制台，选择左侧导航栏中的【函数服务】。
2. 在主界面上方选择期望创建函数的地域，并单击【新建】，进入函数创建流程。
3. 选择使用【模板创建】或选择使用【自定义创建】新建函数。本文以【自定义创建】为例。
4. 在“高级配置”中，选择“日志配置”中的“自定义投递”，并选择已为该函数创建的日志集和日志主题，本文以 SCF-test 为例。如下图所示：
   
5. 单击【完成】即可完成函数日志投递自定义配置。

索引配置

日志检索依赖日志主题的索引配置，在函数创建时，SCF 会自动为您完成索引配置。如遇索引异常无法正常查看日志，请参考如下步骤配置索引：

1. 登录云函数控制台，选择左侧导航栏中的【函数服务】。
2. 在“函数服务”列表页面，选择日志索引异常的函数名，进入“函数管理”页面。
3. 在“日志查询”页签中，选择“高级检索”中的“索引配置”。如下图所示：
   
4. 在“索引配置”页中，开启“索引状态”和“键值索引”并选择【自动配置】。如下图所示：
   
5. 完成索引配置后单击【确定】保存。

步骤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	重试次数。

为保证云函数控制台日志展示效果，请在键值索引配置中为字段打开“开启统计”能力。如下图所示：