mcloud-logs 是 Medusa Cloud CLI 中的日志命令,用于获取 Cloud 环境后端(backend)或店面(storefront)的运行时日志。
主要能力:默认返回过去 15 分钟内最近 500 行日志;支持按时间范围(--from/--to,ISO 8601)、关键字(--search)、部署或构建 ID(--deployment)、来源(--source,可重复)、元数据(--metadata key=value,可重复,同键合并值)过滤;支持 --json 结构化输出,便于程序化分析与代理处理;支持 --follow 实时流式查看。可选 --type 指定 backend 或 storefront,默认 backend。可通过 -o/--organization、-p/--project、-e/--environment 指定上下文,未指定时使用当前活动上下文;--limit 在非 follow 模式生效,取值 1–5000。
典型用法:mcloud logs --json 获取默认日志;mcloud logs --search error --limit 1000 --json 搜索错误;mcloud logs --metadata status=500 --json 按元数据筛选;mcloud logs --type storefront --json 查看店面日志;mcloud logs --follow 实时流式查看。
限制:--follow 与 --json 不兼容,实时流式需人工中断(Ctrl+C),不建议用于脚本或流水线;程序化分析应使用有界时间窗口配合 --json。时间窗口方面,--from 可单独使用表示从该时刻至今;--to 单独使用时仅当其处于最近 15 分钟内,否则需同时传 --from。
适用场景:读取后端或店面日志、按时间范围过滤、搜索关键字、排查部署相关问题、以及将日志结构化后交给代理分析。具体收费、平台与更多细节暂未提供。