最佳实践

日志投递配置(旧)

最近更新时间:2021-05-06 17:02:17

说明

云函数 SCF 于2021年01月29日起全量接入腾讯云 日志服务 CLS,在此之后创建的函数调用日志将默认投递至 CLS,且支持日志实时输出。若您的函数于2021年01月29日前创建,且需进行日志检索与日志投递,请参考本文档使用该功能。

操作场景

在使用云函数 SCF 进行函数计算时,会产生大量的函数运行日志,如果您需要将日志进行持久化存储、投递或消费,对日志内容进行监控告警,您可将日志投递到腾讯云日志服务 CLS 平台。如下图所示:

前提条件

在使用云函数实时日志服务功能之前,需开通 日志服务

注意

了解日志服务相关限制可参见 规格说明,超出限制可能会导致日志丢失。

操作步骤

创建日志集和日志主题

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

注意:

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

配置日志服务

  1. 登录云函数控制台,选择左侧导航栏中的【函数服务】。
  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 重试次数。

如需使用更多功能,例如日志实时检索、日志投递和消费等,请参考 日志服务文档 并前往 日志服务控制台 开始使用。

实时检索示例

说明:

在使用实时检索功能前,请确保您的函数服务日志已接入日志服务平台,并且需检索的日志主题已开启索引。

  1. 登录日志服务控制台,选择左侧导航栏中的【检索分析】。
  2. 在“检索分析”页面选择需检索的日志主题和时间,并在输入框中填写检索语法,本文以 START 为例。
    检索语法支持关键词检索、模糊检索、范围检索等方式,详情请参考 日志服务语法与规则
  3. 单击【检索分析】即可查看实时日志信息。如下图所示:
目录