사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-logs시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Cloud CLI: Logs Command
Execute mcloud logs to fetch runtime logs for a Cloud environment's backend or storefront.
Constraints
--followand--jsonare incompatible. For programmatic log analysis, use bounded time windows with--from/--toand--json.--followstreams until interrupted withCtrl+C— do not use in scripts or pipelines.- Default retrieves the last 500 log lines from the past 15 minutes.
Command
mcloud logs \
--organization <org-id> \
--project <project-id-or-handle> \
--environment <environment-handle> \
[options]Options
| Option | Description | Default | |
|---|---|---|---|
-o/--organization <id> | Organization ID | Active context | |
-p/--project <id-or-handle> | Project ID or handle | Active context | |
-e/--environment <handle> | Environment handle | Active context | |
-f/--follow | Stream logs continuously (incompatible with --json) | false | |
--limit <1-5000> | Max log lines (non-follow mode only) | 500 | |
--from <ISO8601> | Start of time range (e.g. 2026-04-22T10:00:00Z) | 15 minutes ago | |
--to <ISO8601> | End of time range; if >15 min ago, must also pass --from | now | |
--search <string> | Filter by substring (same as dashboard search bar) | — | |
--deployment <id> | Filter by deployment or build ID | — | |
--source <string> | Filter by source (repeatable) | — | |
--metadata <key=value> | Filter by metadata field (repeatable; same key merges values) | — | |
| `--type <backend\ | storefront>` | Log stream to query | backend |
--json | Output as JSON (incompatible with --follow) | false |
Examples
# 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 --jsonTime Range Notes
- Default window is the past 15 minutes.
- Pass
--fromwithout--toto fetch from a time until now. - Pass
--towithout--fromonly if--tois within the last 15 minutes; otherwise also pass--from. - Both
--fromand--toaccept ISO 8601 timestamps.


