tencent cloud

云函数

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
相关概念
工作原理
产品优势
应用场景
相关产品
购买指南
计费概述
计费方式
计费项与计费方式
函数算力支持
免费额度
产品定价
计费示例
欠费与停服说明
快速入门
使用控制台创建一个事件函数
操作指南
配额管理
函数管理
Web 函数管理
日志管理
并发管理
触发器管理
函数 URL
自定义域名
版本管理
别名管理
权限管理
运行实例管理
插件管理
监控与告警管理
网络配置
层管理
执行配置
扩展存储管理
DNS 缓存配置
资源托管模式管理
近离线资源托管模式
工作流
触发器
触发器概述
触发器事件消息结构汇总
API 网关触发器
COS 触发器
CLS 触发器
定时触发器
CKafka 触发器
Apache Kafka 触发器
MQTT 触发器
触发器配置描述
MPS 触发器
CLB 触发器说明
云 API 触发器
开发指南
基本概念
测试云函数
环境变量
依赖安装
使用容器镜像
使用 Docker 安装依赖
错误类型与重试策略
死信队列
云函数接入数据库
自动化部署
云函数状态码
常见错误码解决方法
开发者工具
Serverless Web IDE
函数间调用 SDK
第三方工具
代码开发
Python
Node.js
Golang
PHP
Java
Custom Runtime
使用镜像部署函数
Web 框架部署
通过命令行完成框架部署
快速部署 Egg 框架
快速部署 Express 框架
快速部署 Flask 框架
快速部署 Koa 框架
快速部署 Laravel 框架
快速部署 Nestjs 框架
快速部署 Nextjs 框架
快速部署 Nuxtjs 框架
快速部署 Django 框架
实践教程
最佳实践概述
云产品联合解决方案
业务开发相关实践
实时音视频 TRTC
对象存储 COS
消息队列 CKafka
日志服务CLS
负载均衡 CLB
视频处理 MPS
内容分发网络 CDN
云数据仓库 PostgreSQL
云点播 VOD
短信 SMS
Elasticsearch Service
定时任务
视频处理
客户案例
腾讯在线教育
在线教育行业案例
游戏聊天系统
腾讯互娱国际(IEGG)
API 文档
History
Introduction
API Category
Making API Requests
Other APIs
Namespace APIs
Layer Management APIs
Async Event Management APIs
Trigger APIs
Function APIs
函数和层的状态说明
Data Types
Error Codes
SDK文档
常见问题
通用问题
Web 函数相关问题
计费相关问题
网络相关问题
日志相关问题
SCF 工具相关问题
事件处理相关问题
API 网关触发器相关问题
相关协议
Service Level Agreement
联系我们
词汇表

日志投递配置

PDF
聚焦模式
字号
最后更新时间: 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. 完成索引配置后单击确定保存。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈