开发前言
作为一名 Serverless 架构的重度使用者，我一直对调试感到恐慌：经常在测试接口的时候，会通过网页/PostMan 触发函数，然后没得到预期的结果，我就只能傻乎乎的一直点控制台的日志，等待他能早点出来结果，看看为啥和我预期结果不同。
虽然说 10S，20S 的日志输出还能接受，但是在调试过程中，真的就是噩梦，一直在想有什么方法可以实现实时日志，我触发函数，就马上能看到，无论是控制台/API 网关还是 COS 触发器，只要被触发，我就能实时看到日志，这将会对我写代码，调试产生重大，超级重大帮助，所以我开发了这个组件。
为了更加方便，清晰，直观，我这里做了个使用方法的教程：
使用方法教程：
说明
该模块用于实现云函数 SCF Python Runtime 的实时日志功能，通过该组件，您可以实时查看到函数输出的日志（包括 print 和 logging 等），本组件目前在测试阶段，欢迎测试提意见，目前不建议上业务。
准备
- 安装
scflog：
pip install scflog
安装时，可能需要 root 权限，否则可能无法使用。安装完成，可以执行 scflog -v 查看是否安装成功：
scflog 0.1.1
- 部署实时日志组件，新建项目，并且建立
serverless.yaml，内容：
组件部署
PythonLogs:
component: '@gosls/tencent-pythonlogs'
inputs:
region: ap-guangzhou
这里的参数是您要将这个组件部署的区域。该组件可以复用，也就是说这个组件部署完成之后可以一直被使用。
通过 sls --debug 部署：
DEBUG ─ Setting tags for function PythonRealTimeLogs_Cleanup
DEBUG ─ Creating trigger for function PythonRealTimeLogs_Cleanup
DEBUG ─ Deployed function PythonRealTimeLogs_Cleanup successful
PythonLogs:
websocket: ws://service-laabz6zm-1256773370.gz.apigw.tencentcs.com/test/python_real_time_logs
26s › PythonLogs › done
此时我们需要配置组件：
scflog set -w ws://service-laabz6zm-1256773370.gz.apigw.tencentcs.com/test/python_real_time_logs
配置成功输出：
DFOUNDERLIU-MB0:~ dfounderliu$ scflog set -w ws://service-laabz6zm-1256773370.gz.apigw.tencentcs.com/test/python_real_time_logs
设置成功
websocket: ws://service-laabz6zm-1256773370.gz.apigw.tencentcs.com/test/python_real_time_logs
region: ap-guangzhou
namespace: default
通过 sls remove --debug 移除
DEBUG ─ Removing any previously deployed API. api-rzm1uzik
DEBUG ─ Removing any previously deployed API. api-07wq4u9a
DEBUG ─ Removing any previously deployed service. service-laabz6zm
6s › PythonLogs › done
项目中使用
在项目中使用该组件的方法很简单。
- 创建一个文件夹，并进入
mkdir scflogs && cd scflogs
- 初始化项目
scflog init
- 创建
index.py文件以及serverless.yaml文件：
vim index.py
内容是：
from logs import *
import time
import logging
def main_handler(event, context):
print("event is: ", event)
time.sleep(1)
logging.debug("this is debug_msg")
time.sleep(1)
logging.info("this is info_msg")
time.sleep(1)
logging.warning("this is warning_msg")
time.sleep(1)
logging.error("this is error_msg")
time.sleep(1)
logging.critical("this is critical_msg")
time.sleep(1)
print("context is: ", event)
return "hello world"
vim serverless.yaml
内容是：
Hello_World:
component: "@serverless/tencent-scf"
inputs:
name: Hello_World
codeUri: ./
handler: index.main_handler
runtime: Python3.6
region: ap-guangzhou
description: My Serverless Function
memorySize: 64
timeout: 20
exclude:
- .gitignore
- .git/**
- node_modules/**
- .serverless
- .env
events:
- apigw:
name: serverless
parameters:
protocols:
- http
serviceName: serverless
description: the serverless service
environment: release
endpoints:
- path: /test
method: ANY
通过 sls --debug 部署：
DEBUG ─ Deployed function Hello_World successful
Hello_World:
Name: Hello_World
Runtime: Python3.6
Handler: index.main_handler
MemorySize: 64
Timeout: 20
Region: ap-guangzhou
Namespace: default
Description: My Serverless Function
APIGateway:
- serverless - http://service-89bjzrye-1256773370.gz.apigw.tencentcs.com/release
30s › Hello_World › done
此时，我们配置了APIGW的触发器，地址是上面输出的地址 + endpoints中的path例如：
http://service-89bjzrye-1256773370.gz.apigw.tencentcs.com/release/test
此时，我们可以打开实时日志：
scflog logs -n Hello_World -r ap-guangzhou
此时会提醒我们实时日志开启成功：
DFOUNDERLIU-MB0:~ dfounderliu$ scflog logs -n Hello_World -r ap-guangzhou
实时日志开启 ...
我们可以用浏览器通过刚才函数部署完成返回给我们的地址触发函数：
实时日志开启 ...
[2020-03-04 16:36:08] : ......}
[2020-03-04 16:36:09] : DEBUG debug_msg
[2020-03-04 16:36:10] : INFO info_msg
[2020-03-04 16:36:11] : WARNING warning_msg
[2020-03-04 16:36:14] : ERROR error_msg
[2020-03-04 16:36:14] : CRITICAL critical_msg
[2020-03-04 16:36:16] : context is: .......}
.......
至此，实现实时日志功能。
总结
至此，完成了 Python 语言的实时日志功能，根据测试来看，性能还算不错，也还算稳定。通过 3 个函数 + APIGW + COS + CAM 完成了一个实时日志功能，理论上也可以复用到 Nodejs 等 Runtime。
传送门：
- GitHub: github.com/serverless
- 官网：serverless.com
欢迎访问：Serverless 中文网，您可以在 最佳实践 里体验更多关于 Serverless 应用的开发！