开发者在云函数的开发调试、在线运维过程中,难免会遇到函数调用失败需要定位问题的情况,通常我们使用日志作为主要排障手段。
在云函数控制台中,我们可以看到包含函数调用状态的日志列表,直接筛选可过滤查看所有调用失败的日志。
如果我们能够从网关返回信息中拿到某个失败请求的 RequestId ,我们还可以根据 RequestId 检索指定请求的日志。
这是最基础的日志检索使用方法。
实际定位问题的过程中,有可能出现以下几种场景:
- 函数里的部分异常有进行捕获,但函数的调用状态依然是成功,此时怎么找到已捕获的异常?
- 函数错误调用非常多,我只想查看某些指定模块的日志信息怎么办?
- 收到告警提示我函数运行时间超过 x 秒,我如何迅速找到指定运行时长范围的调用日志?
- 我要查看的业务日志包含多个不同的关键词,想要一次性找到多个关键词所在的日志怎么办?
针对以上场景,我们可以利用「高级日志」功能解决上述全部问题。
高级日志如何使用
下面给大家分享一下已捕获的异常
,查找函数运行时间大于 x 的请求
,关键词组合检索
中如何使用高级日志。
1. 已捕获的异常
云函数比较多的使用场景是和 API 网关组合使用实现 REST API ,以下我们结合一个实际的业务场景说明如何使用高级日志。
以下模拟一个 HTTP PUT 请求实现教师录入学生信息的功能。
def teacher_put():
print('insert info')
try:
fh = open("/tmp/testfile", "w")
fh.write("students info xxxx")
except IOError:
print("Error: cannot find the file or open file failed")
else:
print("write info success")
fh.close()
return('teacher_put success')
def main_handler(event, context):
print(str(event))
if event["pathParameters"]["user_type"] == "teacher":
if event["pathParameters"]["action"] == "get":
return teacher_get()
if event["pathParameters"]["action"] == "put":
return teacher_put()
由于上面写文件时的 IO 异常已被捕获,所以当找不到文件时,函数调用结果依然为成功,API 请求返回 null 。如果使用普通调用日志功能,需要逐条查看日志,这将会非常麻烦。
我们在代码捕获异常时有打印 Error 信息,在高级日志里可以直接检索该关键词:
如果想查看包含该请求的完整日志,则点击该条日志的 RequestId 即可:
上面讲述了如何查找已被捕获的异常,直接检索捕获时打印的关键词即可, 日志输出方法没有特殊要求,使用运行时原生日志即可。
2. 查找函数运行时间大于 x 的请求
如果我们收到告警或通过监控图表查看到某个函数的运行时间异常,如何迅速找到这些日志呢?
高级日志里提供了运行时间检索的方法,比如我们想查找运行时间大于 150ms 的日志,我们可以在检索框输入 SCF_Duration>150
,即可找出该时间范围的日志。
时间范围和关键词检索可组合使用,在上述示例中会将所有日志都过滤出来。
如果我们只想查看有多少请求的运行时间是大于 150 ms ,我们可以组合关键词过滤 SCF_Duration>150 and "Report RequestId"
进行检索:
上述表达式的意思是,过滤运行时间大于 150 ms 且 包含 Report RequestId 关键词的日志。Report RequestId这一行是函数每次请求结束后系统打印的语句,所以可以用它来达到筛选唯一请求日志的作用。
如果想过滤出 150<运行时间≤300
的日志,则可以使用 SCF_Duration in (150 300]
。
3. 关键词组合检索
如果我们想同时检索多个关键词,比如 error
,userid
,region
我们可以使用 and
或者 or
连接这些关键词。
如想要过滤出同时包含这些关键词的日志,则可以使用 error and userid and region
。
如想要过滤出包含任一关键词的日志,则可以使用 error or userid or region
。
高级日志服务提供了丰富的检索语法,可参考日志检索语法教程
Serverless Framework 30 天试用计划
我们诚邀您来体验最便捷的 Serverless 开发和部署方式。在试用期内,相关联的产品及服务均提供免费资源和专业的技术支持,帮助您的业务快速、便捷地实现 Serverless!
详情可查阅:Serverless Framework 试用计划
One More Thing
3 秒你能做什么?喝一口水,看一封邮件,还是 —— 部署一个完整的 Serverless 应用?
复制链接至 PC 浏览器访问:https://serverless.cloud.tencent.com/deploy/express
3 秒极速部署,立即体验史上最快的 Serverless HTTP 实战开发!
传送门:
- GitHub: github.com/serverless
- 官网:serverless.com
欢迎访问:Serverless 中文网,您可以在 最佳实践 里体验更多关于 Serverless 应用的开发!
推荐阅读:《Serverless 架构:从原理、设计到项目实战》