// Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment.
Execute mcloud authentication and context commands: login, logout, whoami, use, version, and signup. Use when setting up the CLI, switching accounts, verifying auth state, setting the active org/project/environment context, or checking the CLI version.
Execute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment status, or reading build output for debugging build failures.
Execute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle, redeploying after variable changes, or starting new builds from source.
Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving organization details including members and subscription.
Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving project details including linked environments.
Execute mcloud variables commands to list and get environment variables for a Cloud environment. Use when inspecting, reading, or exporting environment variables. Never pass --reveal unless the user explicitly requests secret values.
| name | mcloud-logs |
| description | Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment. |
| allowed-tools | Bash(mcloud logs*), Bash(jq*) |
Execute mcloud logs to fetch runtime logs for a Cloud environment's backend or storefront.
--follow and --json are incompatible. For programmatic log analysis, use bounded time windows with --from/--to and --json.--follow streams until interrupted with Ctrl+C — do not use in scripts or pipelines.mcloud logs \
--organization <org-id> \
--project <project-id-or-handle> \
--environment <environment-handle> \
[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 |
# 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
--from without --to to fetch from a time until now.--to without --from only if --to is within the last 15 minutes; otherwise also pass --from.--from and --to accept ISO 8601 timestamps.