Logs 命令

logs 命令是查看函数日志的命令。

⚠️ 注意:在使用该功能之前,需要先开通 SLS 日志服务,并且函数本身已经配置了相关的日志项目

命令解析

当执行命令logs -h/logs --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml模式下必填Cli模式下必填参数含义
region-选填必填地区,取值范围:cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1
service-name-选填必填服务名
function-name-选填必填函数名
request-id-选填选填某次请求的Id
start-times选填选填查询的时间点起点,UTC时间或者时间戳,例如2021-06-07T02:54:59+08:001611827290000
end-timee选填选填查询的时间点终点,UTC时间或者时间戳,例如2021-06-07T02:54:59+08:001611827290000
tail-选填选填tail模式进行日志输出
type-选填选填查询的日志类型,成功或者失败,取值范围:success, fail
instance-id-选填选填根据 instance-id 过滤
qualifier-选填选填查询指定版本或者别名
match-选填选填匹配到的字符高亮

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s logs进行线上函数的日志查询;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定服务所在地区以及服务名称,函数名等,例如s cli fc logs --region cn-hangzhou --service-name fc-deploy-service --function-name http-trigger-py36

上述命令的执行结果示例:

FunctionCompute python3 runtime inited.

FC Invoke Start RequestId: 84d6ae81-02ff-4011-b3ca-45e65b210cc3
FC Invoke End RequestId: 84d6ae81-02ff-4011-b3ca-45e65b210cc3

FC Invoke Start RequestId: de4812be-9137-4a33-9869-370cb61ac427
FC Invoke End RequestId: de4812be-9137-4a33-9869-370cb61ac427

如果需要以tail模式进行日志的查询,可以增加--tail参数,例如s logs --tail

查询指定时间段的日志,可以通过增加--start-time--end-time参数实现,例如s logs -s 2021-11-04T15:40:00 -e 2021-11-04T15:45:00

权限与策略说明

  • 最大权限:AliyunFCReadOnlyAccessAliyunLogReadOnlyAccess

  • 最小权限:AliyunFCReadOnlyAccess 与相关接口权限:

    {
        "Version": "1",
        "Statement": [
            {
                "Action": "log:GetLogStoreLogs",
                "Effect": "Allow",
                "Resource": "acs:log:<region>:<account-id>:project/<project>/logstore/<logstore>"
            }
        ]
    }
    
在 GitHub 上编辑本页面 更新时间: Wed, Aug 10, 2022