mcpField
M
mcloud-logs

mcloud-logs

github.com/medusajs云与 DevOps2341.3k 次安装1 周前更新
代码仓库

关于 mcloud-logs

该技能介绍如何使用 `mcloud logs` 获取 Cloud 环境后端或 storefront 的运行时日志，支持持续流式查看、时间范围和多种筛选条件。

主要功能

  1. 01获取后端或 storefront 日志
  2. 02持续流式查看日志
  3. 03按时间、文本或部署筛选
  4. 04按来源和元数据筛选
  5. 05以 JSON 输出

适用场景

  1. 01排查近期运行时错误
  2. 02查看某次部署的日志
  3. 03分析指定时间范围内的日志
  4. 04查找符合元数据条件的记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-logs

安装后在 Claude Code 中输入/mcloud-logs确认已加载。

详细介绍

Cloud CLI：日志命令

执行 mcloud logs 可获取 Cloud 环境的后端或店面的运行时日志。

限制

  • --follow 与 --json 不兼容。若要以编程方式分析日志，请使用 --from/--to 指定有界时间范围，并使用 --json。
  • --follow 会持续传输日志，直到中断操作（Ctrl+C）——请勿在脚本或管道中使用。
  • 默认获取过去 15 分钟内的最后 500 行日志。

命令

mcloud logs \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle> \
  [options]

选项

选项描述默认值
-o/--organization <id>组织 ID当前上下文
-p/--project <id-or-handle>项目 ID 或句柄当前上下文
-e/--environment <handle>环境句柄当前上下文
-f/--follow持续传输日志（与 --json 不兼容）false
--limit <1-5000>最大日志行数（仅限非跟随模式）500
--from <ISO8601>时间范围的起始时间（例如 2026-04-22T10:00:00Z）15 分钟前
--to <ISO8601>时间范围的结束时间；若时间早于当前时间 15 分钟以上，也必须传入 --from现在
--search <string>按子字符串筛选（与控制面板搜索栏相同）—
--deployment <id>按部署或构建 ID 筛选—
--source <string>按来源筛选（可重复传入）—
--metadata <key=value>按元数据字段筛选（可重复传入；相同键会合并值）—
--type <backend|storefront>要查询的日志流backend
--json以 JSON 格式输出（与 --follow 不兼容）false

示例

# Basic log fetch (last 500 lines, last 15 min)
mcloud logs --json

# Search for errors
mcloud logs --search error --limit 1000 --json

# Filter for HTTP 500 errors via metadata
mcloud logs --metadata status=500 --limit 1000 --json

# Logs for a specific deployment (build or deployment ID)
mcloud logs --deployment bld_01ABC123 --json

# Structured output for agent analysis
mcloud logs --search error --json | jq '.[] | {timestamp, source, message}'

# Storefront logs
mcloud logs --type storefront --json

# Stream live logs (human-readable, not for scripts)
mcloud logs --follow

# Logs within a specific time range
mcloud logs --from 2026-04-22T10:00:00Z --to 2026-04-22T11:00:00Z --limit 1000 --json

# Logs from a time until now
mcloud logs --from 2026-04-22T10:00:00Z --json

# Multiple source filters
mcloud logs --source api --source worker --json

# Multiple metadata filters (HTTP 4xx and 5xx)
mcloud logs --metadata status=400 --metadata status=500 --limit 500 --json

时间范围说明

  • 默认时间范围为过去 15 分钟。
  • 传入 --from 而不传入 --to，可获取从指定时间到现在的日志。
  • 仅当 --to 位于过去 15 分钟内时，才能单独传入 --to；否则也必须传入 --from。
  • --from 和 --to 均接受 ISO 8601 时间戳。

评论

支持 Markdown