注意:说明:
注意:云函数 SCF 于2021年01月29日起全量接入腾讯云 日志服务 CLS,在此之后创建的函数调用日志将默认投递至 CLS,且支持日志实时输出。若你的函数于2021年1月29日前创建,且需进行日志检索与日志投递,请参考这篇档使用该功能。
一、前提条件
在使用云函数实时日志服务功能之前,需开通 日志服务。
注意:说明:
注意:了解日志服务相关限制可参见 规格说明,超出限制可能会导致日志丢失。
二、创建日志主题
登录 日志服务控制台 并 创建日志主题。这篇以在广州创建 SCF-test 日志主题为例。
注意:日志集地域请选择函数服务所在地域,暂不支持跨地域日志推送。
三、配置日志服务
1. 登录 Serverless 控制台,选择左侧导航栏中的 函数服务。
2. 在页面上方选择函数所在地域及命名空间,并在列表中单击需实时采集日志的函数名。
3. 在函数配置页面,单击右上角的编辑。如下:
4. 在“日志投递”中,勾选“启用”并选择已为该函数创建的日志集和日志主题,这篇以 SCF-test 为例。如下:
5. 单击保存即可成功接入日志服务平台。
四、开启索引
日志检索依赖日志主题的索引配置,函数关联日志主题后,SCF 自动为日志主题配置索引。如仍遇索引异常导致日志拉取失败,请参考此步骤调整索引配置。
1. 登录日志服务控制台,选择左侧导航栏中的 日志主题。
2. 单击已创建的日志主题 ID,进入“基本信息”页面。
3. 选择日志主题所在行右侧的管理,进入日志主题“基本信息”页面。
4. 在日志主题“基本信息”页面,单击索引配置。如下:
5. 单击右上角的编辑,开启“键值索引”后按照下表添加“字段名称”、“字段类型”。
注意:说明:
注意:对于配置了日志服务的函数,为保证云函数控制台日志展示效果,请在键值索引配置中为字段打开“开启统计”能力。如下:
| 字段名称 | 字段类型 | 字段含义 |
| 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 | 重试次数。 |
如需使用更多功能,例如日志实时检索、日志投递和消费等,请参考 日志服务文档 并前往 日志服务控制台 开始使用。