tencent cloud

文档反馈

日志投递配置

最后更新时间:2024-03-21 18:35:11
    说明:
    若您的函数于2021年1月29日前创建且尚未进行迁移,如需使用更多日志分析功能,则请参见 日志投递配置(旧),将函数调用日志投递到日志服务 CLS 使用。
    云函数 SCF 于2021年1月29日起全量接入腾讯云 日志服务 CLS,在此之后创建的函数调用日志将投递至 CLS,并支持日志实时输出,在此日期前创建的函数正在按地域逐渐进行迁移,详情可参见 云函数日志服务变更说明
    本文介绍云函数 SCF 所提供的 默认投递自定义投递 两种日志服务投递方式及其配置方法。

    权限说明

    为保证日志正常查看,子账号下至少拥有日志服务 CLS 只读权限 QcloudCLSReadOnlyAccess。主账号为子账号授权方法请参见 授权管理

    限制说明

    函数调用日志投递至日志服务的限制如下:
    每个请求5秒内打印的日志量上限为1MB。
    每个请求5秒内打印的日志条数上限为5000条。
    每条日志长度上限为8KB,超出将截取前8KB。

    操作步骤

    默认投递

    新建函数时,如不指定日志投递主题,将会使用默认投递日志能力。默认投递日志时,SCF 将会为您开通日志服务并将函数调用日志投递至 SCF 专用日志集下的日志主题中,SCF 专用日志集和日志主题分别以 SCF_logsetSCF_logtopic 为前缀命名,如不存在将自动创建。函数调用日志默认保留7天,您可在 日志服务控制台 查看及管理。
    说明:
    日志服务为独立计费产品,SCF 专用日志主题会占用日志服务免费额度,详情可参见 日志服务计费详情
    为保证 SCF 控制台日志正常展示,SCF 专用日志主题不支持修改索引配置。如需自定义日志索引配置,请参考下文自定义投递配置函数日志主题。

    配置日志服务

    1. 登录 Serverless 控制台,选择左侧导航栏中的 函数服务
    2. 在主界面上方选择期望创建函数的地域和命名空间,并单击新建,进入函数创建流程。
    3. 在“日志配置”中,选择“默认投递”。如下图所示:
    
    
    4. 单击完成即可创建函数,并完成函数日志默认投递。您可在函数管理 > 函数配置中查看日志配置。如下图所示:
    
    

    查看和管理日志服务

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

    自定义投递

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

    创建日志集和日志主题

    登录 日志服务控制台创建日志主题。本文以在广州创建 SCF-test 日志主题为例。如下图所示:
    
    
    注意:
    日志集地域请选择函数服务所在地域,暂不支持跨地域日志推送。

    配置日志服务

    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. 完成索引配置后单击确定保存。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持